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.
Path parameters
schedule_idrequiredstring
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
expectedVersionrequiredinteger
Current schedule version, at least 1. Required for optimistic concurrency.
| Name | Type | Description |
|---|---|---|
| expectedVersionrequired | integer | Current schedule version, at least 1. Required for optimistic concurrency. |
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. |
