Skip to Content
SeyloDocs
API referenceCron jobs

Run a cron job now

POST
/api/v1/cron.runNow

Starts a cron job outside its schedule. Returns the run as soon as the node accepted it; its result arrives on the service's live topic. Fails with UNAVAILABLE while the node is offline.

Needs services.cron on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Request Body

application/json
  1. body
serviceId*string

Panel-issued id.

Match^[a-z0-9]{16}$
cronJobId*string

Panel-issued id.

Match^[a-z0-9]{16}$

Response Body

Success.

application/json
  1. response
id*string

Panel-issued id.

Match^[a-z0-9]{16}$
cronJobId*|null
serviceId*string

Panel-issued id.

Match^[a-z0-9]{16}$
nodeId*|null
result*string|string|string|string|string
manual*boolean
exitCode*integer|null
startedAt*string
Formatdate-time
finishedAt*|null
durationMs*|null
Example Request
curl -X POST 'https://example.com/api/v1/cron.runNow' \  -H 'Content-Type: application/json' \  -d '{  "serviceId": "string",  "cronJobId": "string"}'
Example Response
{  "id": "string",  "cronJobId": "string",  "serviceId": "string",  "nodeId": "string",  "result": "running",  "manual": true,  "exitCode": 0,  "startedAt": "2019-08-24T14:15:22Z",  "finishedAt": "2019-08-24T14:15:22Z",  "durationMs": 0}

Get a cron run with its output GET

Returns one cron run with the last lines of its output (redacted on the node). Needs `services.logs` on the service (a grant on its project covers it). Available to MCP clients and the assistant.

List cron runs GET

Lists runs of a service's cron jobs newest first, optionally for one job. Page with the nextCursor of the previous call. Needs `services.view` on the service (a grant on its project covers it). Available to MCP clients and the assistant.