List an agent's schedules and runs
GET
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.
apiKeyheader
AuthorizationBearer <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.
id*stringThe agent id.
The serving version's schedules, when each fires next and the recent runs
application/json- response
agentId*stringFormat
uuidversionId*|Format
uuidschedules*array<>recentRuns*array<>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 } ]}