Get Scheduled Chat - Autotouch AI

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.

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" \
  -H "Authorization: Bearer $USER_SESSION_TOKEN"

Response example

json

{
  "id": "sched_example",
  "organizationId": "org_example",
  "organizationName": "Example workspace",
  "name": "Weekly account review",
  "prompt": "Review the saved target accounts and report meaningful changes.",
  "status": "draft",
  "executionMode": "new_thread",
  "recurrence": {
    "rrule": "FREQ=WEEKLY;BYDAY=MO;BYHOUR=9;BYMINUTE=0",
    "timezone": "America/New_York"
  },
  "startsAt": "2026-10-19T13:00:00Z",
  "resourceRefs": [],
  "operationScopeMode": "runtime_selected",
  "approvalMode": null,
  "policyProfile": null,
  "executionBudget": {
    "actions": 20
  },
  "authorityRefreshRequired": false,
  "standingApprovalGrantId": null,
  "configDigest": "example-digest",
  "currentRevision": 1,
  "currentRevisionId": "srev_example",
  "version": 1,
  "nextFireAt": null,
  "lastFireAt": null,
  "activeOccurrenceId": null,
  "createdAt": "2026-10-15T14:00:00Z",
  "updatedAt": "2026-10-15T14:00:00Z"
}