Skip to main content
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 via Authorization: Bearer <token> header.

​
Path Parameters

​
id
string
required
Agent UUID

​
Query Parameters

​
page
number
default:"1"
Page number (min: 1)
​
limit
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

FieldTypeDescription
uuidstringSchedule UUID
agent_uuidstringAgent UUID
namestringSchedule name
cron_expressionstringCron expression
message_templatestringMessage template with variables
timezonestringTimezone for schedule evaluation
enabledbooleanWhether schedule is active
last_run_atstring|nullLast execution timestamp (ISO 8601)
next_run_atstring|nullNext scheduled run (ISO 8601, null if disabled)
created_atstringCreation timestamp
updated_atstringLast update timestamp

​
Error Responses

​
404 Not Found

  • Agent not found or you don’t have access

​
429 Too Many Requests

  • Rate limit exceeded