Schedules
Schedules trigger an agent conversation automatically on a cron schedule.
List schedules
GET /api/schedules
Authorization: Bearer nxr_...Create schedule
POST /api/schedules
Authorization: Bearer nxr_...
Content-Type: application/json
{
"name": "Daily standup summary",
"cron": "0 9 * * 1-5",
"agent_id": "uuid",
"prompt": "Summarize yesterday's activity and list today's priorities",
"project_id": "uuid-optional",
"timezone": "Europe/Madrid"
}| Field | Type | Description |
|---|---|---|
name | string | Display name |
cron | string | Cron expression (UTC unless timezone set) |
agent_id | uuid | Agent to run |
prompt | string | Message sent to the agent |
project_id | uuid? | Optional project context |
timezone | string? | IANA timezone (default: UTC) |
Get schedule
GET /api/schedules/{schedule_id}
Authorization: Bearer nxr_...Update schedule
PATCH /api/schedules/{schedule_id}
Authorization: Bearer nxr_...
Content-Type: application/json
{ "cron": "0 8 * * 1-5", "prompt": "Updated prompt" }Delete schedule
DELETE /api/schedules/{schedule_id}
Authorization: Bearer nxr_...Activate / deactivate
POST /api/schedules/{schedule_id}/activate
POST /api/schedules/{schedule_id}/deactivate
Authorization: Bearer nxr_...Trigger now
Run a schedule immediately outside its normal cadence:
POST /api/schedules/{schedule_id}/trigger
Authorization: Bearer nxr_...Run history
List runs
GET /api/schedules/{schedule_id}/runs
Authorization: Bearer nxr_...Get run
GET /api/schedules/runs/{run_id}
Authorization: Bearer nxr_...Run schema:
{
"id": "uuid",
"schedule_id": "uuid",
"chat_id": "uuid",
"status": "success | failed | running",
"started_at": "2026-01-01T09:00:00Z",
"finished_at": "2026-01-01T09:00:42Z"
}