Get Schedule
Scheduler prerequisites
Configure an AgentOS-level database with schedule methods. The example scheduler server uses SQLite. Database-backed schedule CRUD is available without starting the scheduler; execution requires scheduler=True, a running application lifespan and a scheduler_base_url matching the server's address.
Owners come from authenticated identity. Configured authorization uses schedules:read, schedules:write and schedules:delete. Creating, repointing, enabling or triggering a run schedule also requires permission to run its target. Non-run targets require admin permission when that authorization is enforced. An inaccessible record can return 404; insufficient permission returns 403.
Read enabled, next_run_at and disabled_reason to inspect the stored schedule. A future trigger time does not establish that an executor is currently running.
/schedules/{schedule_id}Authorization
HTTPBearer In: header
Path Parameters
Response Body
application/json
application/json
curl --request GET 'https://example.com/schedules/string'{ "id": "string", "user_id": "string", "name": "string", "description": "string", "method": "string", "endpoint": "string", "payload": {}, "cron_expr": "string", "timezone": "string", "timeout_seconds": 0, "max_retries": 0, "retry_delay_seconds": 0, "enabled": true, "next_run_at": 0, "managed_by": "string", "target_type": "string", "target_id": "string", "disabled_reason": "string", "created_at": 0, "updated_at": 0}{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string", "input": null, "ctx": {} } ]}