List Scheduled Chat runs

This page documents the canonical HTTP contract for this endpoint.

Authenticate with the signed-in user session using a bearer token or the accessToken cookie. Developer API keys are blocked. Definitions, runs, and attention belong to the current user; current workspace membership is rechecked before accessing saved resources. Lists may include your own work across accessible workspaces.

Path parameters

schedule_idrequired
string
Exact Scheduled Chat definition ID returned by create or list.

Name	Type	Description
schedule_idrequired	string	Exact Scheduled Chat definition ID returned by create or list.

Query parameters

limit · optional
integer
Maximum records, 1–200; default 100.

Name	Type	Description
limit	integer	Maximum records, 1–200; default 100.

Errors

Status	Meaning
401	A valid signed-in user session is required.
403	Developer API keys are blocked or workspace access is unavailable.
404	The owner-scoped schedule, run, attention item, or referenced resource is unavailable.
409	The version, status transition, authority, or active occurrence conflicts with this request.
422	Invalid request fields, recurrence, or resource references.

Example

bash

curl -X GET "https://app.autotouch.ai/api/scheduled/sched_example/runs" \
  -H "Authorization: Bearer $USER_SESSION_TOKEN"

Response example

json

{
  "items": [
    {
      "id": "occ_example",
      "scheduleId": "sched_example",
      "revisionId": "srev_example",
      "trigger": "manual",
      "scheduledFor": "2026-10-15T14:30:00Z",
      "status": "queued",
      "threadId": null,
      "turnId": null,
      "operationRunId": "op_example",
      "createdAt": "2026-10-15T14:30:00Z",
      "updatedAt": "2026-10-15T14:30:00Z"
    }
  ]
}