Skip to main content
GET
List Self-Schedules
Self-schedules are one-shot future runs an agent books for itself at runtime (when self-scheduling is enabled). This endpoint lists them — it does not create them. Optionally filter by status.

Query Parameters

string
Filter by status: scheduled, completed, or failed.

Response

array
Array of self-schedules.

Example Request

Example Response

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

agent_id
string
required

Query Parameters

status
string | null

Filter by status: scheduled, completed, or failed.

Response

Successful Response

id
string
required

Self-schedule id. Pass it to DELETE to cancel.

agent_id
string
required

Owning agent id.

run_at
string<date-time>
required

When the run fires (UTC).

status
string
required

scheduled, completed, or failed.

task_id
string | null

Execution thread the run continues, if any.

prompt
string | null

Instruction for the scheduled run.

created_at
string<date-time> | null

Creation timestamp.

updated_at
string<date-time> | null

Last update timestamp.