Create Schedule

Create a recurring cron schedule for an agent

POST /v1/agent/:id/schedules

Create Schedule

cURL

curl --request POST \
  --url https://api.app.shinzo.ai/v1/agent/:id/schedules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "cron_expression": "<string>",
  "message_template": "<string>",
  "timezone": "<string>",
  "enabled": true
}
'

Authentication

Requires JWT token or Platform API key via Authorization: Bearer <token> header.

Path Parameters

id · string · required

Agent UUID

Body Parameters

name · string · required

Schedule name (1-255 characters)

cron_expression · string · required

Valid cron expression (e.g., 0 9 * * 1-5 for weekdays at 9am)

message_template · string · required

Message to send when schedule fires. Supports {{date}}, {{time}}, {{schedule.name}} template variables

timezone · string · default: "UTC"

Timezone for schedule evaluation (e.g., America/Los_Angeles, Europe/London)

enabled · boolean · default: "true"

Whether the schedule is active

Example Request

curl -X POST https://api.app.shinzo.ai/v1/agent/:id/schedules \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily Standup",
    "cron_expression": "0 9 * * 1-5",
    "message_template": "Generate a daily standup report for {{date}}. Review yesterday'\''s work and today'\''s priorities.",
    "timezone": "America/Los_Angeles",
    "enabled": true
  }'

Response

{
  "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}}. Review yesterday's work and today's priorities.",
  "timezone": "America/Los_Angeles",
  "enabled": true,
  "last_run_at": null,
  "next_run_at": "2026-02-27T09:00:00-08:00",
  "created_at": "2026-02-26T10:30:00Z",
  "updated_at": "2026-02-26T10:30:00Z"
}

Common Cron Expressions

Expression	Description
0 9 * * 1-5	Every weekday at 9:00 AM
0 */4 * * *	Every 4 hours
0 0 * * 0	Every Sunday at midnight
30 14 1 * *	First day of every month at 2:30 PM
0 8 * * 1	Every Monday at 8:00 AM
0 0 1 1 *	January 1st at midnight (annual)

Template Variables

Variable	Description	Example
{{date}}	Current date (ISO 8601)	2026-02-26
{{time}}	Current time (ISO 8601)	14:30:00
{{schedule.name}}	Schedule name	Daily Standup

Error Responses

400 Bad Request

• Invalid cron expression
• Missing required fields
• Name exceeds 255 characters

404 Not Found

• Agent not found or you don’t have access

429 Too Many Requests

• Rate limit exceeded