Create Schedule

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
}
'

POST

agent

:id

schedules

Create Schedule

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

string

required

Agent UUID

Body Parameters

string

required

Schedule name (1-255 characters)

string

required

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

string

required

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

string

default:"UTC"

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

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

Agent Schedules & Triggers List Schedules

Overview

Authentication

AI Agents

Agent Messaging

Agent Schedules & Triggers

Agent Channels

Agent Filesystem

MCP Servers

Spotlight

Tokens

Provider Keys

Telemetry

Create Schedule

Authentication

Path Parameters

Body Parameters

Example Request

Response

Common Cron Expressions

Template Variables

Error Responses

400 Bad Request

404 Not Found

429 Too Many Requests

​Authentication

​Path Parameters

​Body Parameters

​Example Request

​Response

​Common Cron Expressions

​Template Variables

​Error Responses

​400 Bad Request

​404 Not Found

​429 Too Many Requests

Authentication

Path Parameters

Body Parameters

Example Request

Response

Common Cron Expressions

Template Variables

Error Responses

400 Bad Request

404 Not Found

429 Too Many Requests