List Schedules
curl --request GET \
--url https://api.app.shinzo.ai/v1/agent/:id/schedules \
--header 'Authorization: Bearer <token>'Agent Schedules & Triggers
List Schedules
List all cron schedules for an agent
GET
/
v1
/
agent
/
:id
/
schedules
List Schedules
curl --request GET \
--url https://api.app.shinzo.ai/v1/agent/:id/schedules \
--header 'Authorization: Bearer <token>'Authentication
Requires JWT token or Platform API key viaAuthorization: Bearer <token> header.
Path Parameters
string
required
Agent UUID
Query Parameters
number
default:"1"
Page number (min: 1)
number
default:"20"
Results per page (min: 1, max: 100)
Example Request
curl -X GET "https://api.app.shinzo.ai/v1/agent/:id/schedules?page=1&limit=20" \
-H "Authorization: Bearer <token>"
Response
{
"schedules": [
{
"uuid": "schedule-abc-123",
"agent_uuid": "agent-xyz-789",
"name": "Daily Standup",
"cron_expression": "0 9 * * 1-5",
"message_template": "Generate a daily standup report for {{date}}.",
"timezone": "America/Los_Angeles",
"enabled": true,
"last_run_at": "2026-02-26T09:00:00-08:00",
"next_run_at": "2026-02-27T09:00:00-08:00",
"created_at": "2026-02-20T10:30:00Z",
"updated_at": "2026-02-20T10:30:00Z"
},
{
"uuid": "schedule-def-456",
"agent_uuid": "agent-xyz-789",
"name": "Weekly Metrics",
"cron_expression": "0 17 * * 5",
"message_template": "Create weekly metrics summary for {{date}}.",
"timezone": "UTC",
"enabled": false,
"last_run_at": "2026-02-21T17:00:00Z",
"next_run_at": null,
"created_at": "2026-02-15T08:00:00Z",
"updated_at": "2026-02-24T12:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 2,
"total_pages": 1
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
uuid | string | Schedule UUID |
agent_uuid | string | Agent UUID |
name | string | Schedule name |
cron_expression | string | Cron expression |
message_template | string | Message template with variables |
timezone | string | Timezone for schedule evaluation |
enabled | boolean | Whether schedule is active |
last_run_at | string|null | Last execution timestamp (ISO 8601) |
next_run_at | string|null | Next scheduled run (ISO 8601, null if disabled) |
created_at | string | Creation timestamp |
updated_at | string | Last update timestamp |
Error Responses
404 Not Found
- Agent not found or you don’t have access
429 Too Many Requests
- Rate limit exceeded

