Skip to main content
GET
/
v3
/
agents
/
{agent_key}
/
schedules
curl https://api.orq.ai/v3/agents/customer_digest/schedules \
  -H "Authorization: Bearer $ORQ_API_KEY"

{
  "schedules": [
    {
      "_id": "01KPN29WWKSK0VDPJNTKZPVNRB",
      "workspace_id": "cd185327-a8a5-4e55-ac9e-51c8e8b7f0e5",
      "agent_key": "customer_digest",
      "type": "cron",
      "expression": "0 0 9 * * mon-fri",
      "is_active": true,
      "generation": 2,
      "payload": {
        "input": "Generate the morning briefing for {{region}}",
        "variables": { "region": "EMEA" }
      },
      "created_by_id": "apk_01KPM5XHYF7NXZ1S3XK2J8Q4B7",
      "created": "2026-04-15T12:00:00Z",
      "updated": "2026-04-20T09:30:00Z",
      "last_triggered_at": "2026-04-20T09:00:02Z",
      "trigger_count": 12
    },
    {
      "_id": "01KPMQ9S5ZQ3K8B2XJV0N7R1GZ",
      "workspace_id": "cd185327-a8a5-4e55-ac9e-51c8e8b7f0e5",
      "agent_key": "customer_digest",
      "type": "once",
      "expression": "@at 2026-05-01T09:00:00Z",
      "is_active": true,
      "generation": 1,
      "payload": {
        "input": "Follow-up on last month's outage report"
      },
      "created_by_id": "apk_01KPM5XHYF7NXZ1S3XK2J8Q4B7",
      "created": "2026-04-19T16:00:00Z",
      "updated": "2026-04-19T16:00:00Z",
      "trigger_count": 0
    }
  ]
}
Lists every schedule attached to the specified agent, most recent first. Returns an envelope with a schedules array — empty if the agent has none. See Agent Schedules for the full schedule document shape. 
curl https://api.orq.ai/v3/agents/customer_digest/schedules \
  -H "Authorization: Bearer $ORQ_API_KEY"

{
  "schedules": [
    {
      "_id": "01KPN29WWKSK0VDPJNTKZPVNRB",
      "workspace_id": "cd185327-a8a5-4e55-ac9e-51c8e8b7f0e5",
      "agent_key": "customer_digest",
      "type": "cron",
      "expression": "0 0 9 * * mon-fri",
      "is_active": true,
      "generation": 2,
      "payload": {
        "input": "Generate the morning briefing for {{region}}",
        "variables": { "region": "EMEA" }
      },
      "created_by_id": "apk_01KPM5XHYF7NXZ1S3XK2J8Q4B7",
      "created": "2026-04-15T12:00:00Z",
      "updated": "2026-04-20T09:30:00Z",
      "last_triggered_at": "2026-04-20T09:00:02Z",
      "trigger_count": 12
    },
    {
      "_id": "01KPMQ9S5ZQ3K8B2XJV0N7R1GZ",
      "workspace_id": "cd185327-a8a5-4e55-ac9e-51c8e8b7f0e5",
      "agent_key": "customer_digest",
      "type": "once",
      "expression": "@at 2026-05-01T09:00:00Z",
      "is_active": true,
      "generation": 1,
      "payload": {
        "input": "Follow-up on last month's outage report"
      },
      "created_by_id": "apk_01KPM5XHYF7NXZ1S3XK2J8Q4B7",
      "created": "2026-04-19T16:00:00Z",
      "updated": "2026-04-19T16:00:00Z",
      "trigger_count": 0
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
agent_key
string
required

The unique routing key of the agent the schedule belongs to.

Response

200 - application/json

Schedules listed (empty array if none).

​
schedules
object[] | null
required