Update 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.

Read the current version before a mutation and send it as expectedVersion. A stale version returns 409; read and reconcile before retrying. The HTTP contract requires this value even where Command Center binds it automatically.

Supply at least one definition field. Material edits create a new immutable revision. Review returned authority and authorityRefreshRequired; do not assume an edited definition has authority for unattended execution.

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.

Body parameters

expectedVersionrequired
integer
Current schedule version, at least 1. Required for optimistic concurrency.
name · optional
string
Non-empty display name, at most 160 characters.
prompt · optional
string
Complete recurring instruction, at most 50,000 characters.
recurrence · optional
object
rrule and IANA timezone. Recurrence is validated by the host.
resourceRefs · optional
array
Up to 96 exact {type,id,metadata?} host-owned resources. Metadata supplies labels and does not authorize access.

Name	Type	Description
expectedVersionrequired	integer	Current schedule version, at least 1. Required for optimistic concurrency.
name	string	Non-empty display name, at most 160 characters.
prompt	string	Complete recurring instruction, at most 50,000 characters.
recurrence	object	rrule and IANA timezone. Recurrence is validated by the host.
resourceRefs	array	Up to 96 exact {type,id,metadata?} host-owned resources. Metadata supplies labels and does not authorize access.

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 PATCH "https://app.autotouch.ai/api/scheduled/sched_example" \
  -H "Authorization: Bearer $USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"expectedVersion":1,"prompt":"Review the saved accounts and report new hiring signals."}'

Request body

json

{
  "expectedVersion": 1,
  "prompt": "Review the saved accounts and report new hiring signals."
}

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"
}