Skip to main content

List Scheduled Chats

List your Scheduled Chat definitions and unread attention count.

GET/api/scheduled
HTTP referenceScope authenticated user session (developer API keys blocked)Updated October 15, 2026

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

  • status · optional

    array<string>

    Repeat the query parameter to filter draft, active, paused, completed, or archived definitions.

  • limit · optional

    integer

    Maximum records, 1–200; default 100.

Errors

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

Docs