Pull schedule definition (config-as-code)

{
  "contentHash": "string",
  "definition": {
    "name": "string",
    "target": {
      "agentId": "string",
      "agentName": "string",
      "flowId": "string",
      "flowName": "string"
    },
    "trigger": {
      "type": "recurring",
      "cron": "string",
      "runAt": "2024-01-15T09:30:00Z",
      "timezone": "string"
    },
    "enabled": true,
    "executionOptions": {
      "chunkSize": 1,
      "flowTimeoutMs": 1,
      "loggingPolicy": "default",
      "maxRetries": 1,
      "modelOverride": "string",
      "progressFlushSize": 1,
      "recordConcurrency": 1,
      "skipCacheWarm": true,
      "stepTimeoutMs": 1,
      "timeoutMs": 1
    },
    "inputs": {},
    "messages": [
      {}
    ],
    "recordFilter": {},
    "recordIds": [
      "string"
    ],
    "recordType": "string"
  },
  "lastModifiedSource": "string",
  "scheduleId": "string",
  "updatedAt": "string"
}

Return the canonical config-as-code definition and provenance for a standalone schedule by name and target — the absorb-drift direction of the ensure protocol. The target is echoed in the form the query used, and the definition always declares enabled.

Authentication

AuthorizationBearer

API key or Clerk session token

Query parameters

namestringRequired>=1 character

flowIdstringOptional

agentIdstringOptional

flowNamestringOptional

agentNamestringOptional

Response

Canonical definition + provenance

contentHashstring

definitionobject

lastModifiedSourcestring or null

scheduleIdstring

updatedAtstring or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error