Get schedule details | Runtype Documentation

{
  "agentId": "agent_9f8b7c6d5e4a3b2c1d0e",
  "createdAt": "2024-06-10T09:15:00Z",
  "cron": "0 8 * * *",
  "enabled": true,
  "executionOptions": {
    "retryOnFailure": true,
    "maxRetries": 3
  },
  "flowId": "flow_123abc456def789ghi",
  "flowName": "Daily Data Sync",
  "id": "schedule_987zyx654wvu321tsr",
  "inputs": {
    "source": "database",
    "destination": "data_warehouse"
  },
  "lastRunAt": "2024-06-09T08:00:00Z",
  "name": "Morning Sync Schedule",
  "nextRunAt": "2024-06-11T08:00:00Z",
  "organizationId": "org_456def789abc123ghi",
  "productSurfaceId": "surface_321tsr654wvu987zyx",
  "recentRuns": [
    {
      "batchExecutionId": "batch_001122334455",
      "completedAt": "2024-06-09T08:05:00Z",
      "createdAt": "2024-06-09T07:59:00Z",
      "error": null,
      "id": "run_abc123def456",
      "startedAt": "2024-06-09T08:00:00Z",
      "status": "completed"
    }
  ],
  "recordIds": [
    "record_789ghi012jkl345mno"
  ],
  "recordType": "data_sync",
  "runAt": "2024-06-10T08:00:00Z",
  "timezone": "America/New_York",
  "triggerType": "cron",
  "updatedAt": "2024-06-10T09:20:00Z",
  "userId": "user_1234567890abcdef"
}

Get a schedule by ID including recent runs.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

surfaceIdstringRequired

scheduleIdstringRequired

Response

Schedule details

agentIdstring or null

createdAtstring

cronstring or null

enabledboolean

executionOptionsmap from strings to any

flowIdstring or null

flowNamestring or null

idstring

inputsmap from strings to any or null

lastRunAtstring or null

namestring or null

nextRunAtstring or null

organizationIdstring or null

productSurfaceIdstring or null

recentRunslist of objects

recordIdslist of strings or null

recordTypestring or null

runAtstring or null

timezonestring or null

triggerTypestring

updatedAtstring

userIdstring

messagesany

recordFilterany

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/products/id/surfaces/surfaceId/schedules/scheduleId \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"