List Scheduled Chat attention

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.

Query parameters

unreadOnly · optional
boolean
Return unread attention only; default false.
limit · optional
integer
Maximum records, 1–200; default 100.

Name	Type	Description
unreadOnly	boolean	Return unread attention only; default false.
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/attention" \
  -H "Authorization: Bearer $USER_SESSION_TOKEN"

Response example

json

{
  "items": [
    {
      "id": "attention_example",
      "scheduleId": "sched_example",
      "occurrenceId": "occ_example",
      "kind": "finding",
      "title": "Account review ready",
      "summary": "The account review completed.",
      "readAt": null,
      "createdAt": "2026-10-15T14:31:00Z"
    }
  ],
  "unreadCount": 1
}