Skip to main content
PATCH
/
v3
/
agents
/
{agent_key}
/
schedules
/
{schedule_id}
curl -X PATCH https://api.orq.ai/v3/agents/customer_digest/schedules/01KPN29WWKSK0VDPJNTKZPVNRB \
  -H "Authorization: Bearer $ORQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "is_active": false }'

{
  "_id": "01KPN29WWKSK0VDPJNTKZPVNRB",
  "agent_key": "customer_digest",
  "type": "cron",
  "expression": "0 0 9 * * mon-fri",
  "is_active": false,
  "generation": 2,
  "payload": {
    "input": "Generate the morning briefing for {{region}}",
    "variables": { "region": "EMEA" }
  },
  "updated": "2026-04-20T10:15:00Z",
  "trigger_count": 12
}
Partial update — omitted fields are left unchanged. Changing expression or type (or reactivating from inactive) re-publishes the NATS schedule and bumps generation. Payload-only and agent_tag-only changes leave the firing cadence in place. See Agent Schedules for the full lifecycle model. 
curl -X PATCH https://api.orq.ai/v3/agents/customer_digest/schedules/01KPN29WWKSK0VDPJNTKZPVNRB \
  -H "Authorization: Bearer $ORQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "is_active": false }'

{
  "_id": "01KPN29WWKSK0VDPJNTKZPVNRB",
  "agent_key": "customer_digest",
  "type": "cron",
  "expression": "0 0 9 * * mon-fri",
  "is_active": false,
  "generation": 2,
  "payload": {
    "input": "Generate the morning briefing for {{region}}",
    "variables": { "region": "EMEA" }
  },
  "updated": "2026-04-20T10:15:00Z",
  "trigger_count": 12
}

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.

​
schedule_id
string
required

The schedule's ULID, as returned from create.

Body

application/json
​
agent_tag
string

Change the pinned agent version.

​
expression
string

Update the schedule expression. Minimum firing cadence is 1 hour for cron and interval.

​
is_active
boolean

Activate or deactivate the schedule. Deactivating removes the NATS entry; activating re-publishes with current values.

​
payload
object

Update the invocation payload. Payload-only changes do not reset the firing cadence or bump generation.

​
type
enum<string>

Change the schedule type. Changing type or expression resets the NATS schedule and bumps generation.

Available options:
cron,
once,
interval

Response

Schedule updated.

​
_id
string
required

ULID identifying this schedule.

​
agent_key
string
required
​
created
string<date-time>
required
​
created_by_id
string
required

ID of the API key that created the schedule.

​
expression
string
required

Cron expression (6-field, seconds required), @every duration, @at RFC3339 timestamp, or a predefined descriptor like @hourly/@daily.

​
generation
integer<int64>
required

Monotonic counter bumped when the schedule's firing cadence changes. Used by the consumer to skip stale in-flight triggers.

​
is_active
boolean
required

Whether the schedule is currently firing. once schedules flip to false automatically after firing.

​
payload
object
required
​
trigger_count
integer<int64>
required

Total firings since creation or last expression/type change.

​
type
enum<string>
required

Schedule type.

Available options:
cron,
once,
interval
​
updated
string<date-time>
required
​
workspace_id
string
required
​
agent_tag
string

Pinned agent version. Omit to always run the agent's current active version.

​
last_triggered_at
string<date-time>

Timestamp of the most recent firing, if any.