List an agent's schedules and runs

GET
/v1/agents/{id}/schedules

Lists the schedules the agent's serving version declares in its manifest (a cron expression in UTC, at most once a minute, calling a published endpoint of kind schedule), when each fires next, and the recent runs with how each ended. A run that fell due and was not run is listed as skipped with its reason. Schedules are changed by publishing a new version.

Requires an API key with the workspace:read scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The agent id.

Response Body

The serving version's schedules, when each fires next and the recent runs

application/json
  1. response
agentId*string
Formatuuid
versionId*|
Formatuuid
schedules*array<>
recentRuns*array<>
Example Request
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/schedules" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",  "versionId": "0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67",  "schedules": [    {      "name": "daily-digest",      "cron": "0 9 * * *",      "endpoint": "digest",      "missed": "skip",      "nextRunAt": "2026-10-20T15:04:05.000Z",      "lastRun": {        "schedule": "daily-digest",        "fireAt": "2026-10-20T15:04:05.000Z",        "runKey": "sched:0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78:daily-digest:2026-10-20T15:04:05.000Z",        "status": "done",        "attempts": 1,        "reason": null,        "httpStatus": 200,        "startedAt": "2026-10-20T15:04:05.000Z",        "endedAt": "2026-10-20T15:04:05.000Z",        "manual": false      }    }  ],  "recentRuns": [    {      "schedule": "daily-digest",      "fireAt": "2026-10-20T15:04:05.000Z",      "runKey": "sched:0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78:daily-digest:2026-10-20T15:04:05.000Z",      "status": "done",      "attempts": 1,      "reason": null,      "httpStatus": 200,      "startedAt": "2026-10-20T15:04:05.000Z",      "endedAt": "2026-10-20T15:04:05.000Z",      "manual": false    }  ]}