adk
Schedule Agent Run Endpoint
Schedule an agent to run via Mage AI.
- Creates a SCHEDULE trigger (time-based) if it doesn't exist
- Supports cron expressions and presets (@hourly, @daily, @weekly, @monthly)
- Lazily creates triggers on first schedule (not during agent creation)
Request body:
{
"agent_id": "agent95",
"user_id": "user@example.com",
"session_id": "session_abc",
"new_message": {"content": "Hello", "role": "user"},
"run_mode": "single", # optional
"streaming": false, # optional
"agent_metadata": {}, # optional
"schedule_interval": "@hourly", # NEW: @hourly, @daily, @weekly, @monthly, or cron
"start_time": "2026-02-13T10:30:00"
}
Returns:
Schedule information including run_id and status
POST
Schedule Agent Run Endpoint
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Request schema for scheduling an agent run.
Response
Successful Response
Related topics
Run Agent Now EndpointRun Agent From Jwt EndpointRun Agent From Refresh Token EndpointList Schedule RunsSessions and runsSchedule Agent Run Endpoint