Skip to Content
SeyloDocs
API referenceDeployments

List recent deployments

GET
/api/v1/deployments.recent

Lists the latest deployments across every service the caller can view (or one project's), newest first, failed ones included. For the dashboard's Recent deploys.

Any signed-in caller. Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Query Parameters

limit?integer
Range1 <= value <= 50
Default5
projectId?string

Panel-issued id.

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

Response Body

Success.

application/json
  1. response
deployments*array<>
Example Request
curl -X GET 'https://example.com/api/v1/deployments.recent'
Example Response
{  "deployments": [    {      "id": "string",      "serviceId": "string",      "generation": 1,      "status": "queued",      "live": true,      "trigger": "manual",      "actor": "string",      "commit": {        "sha": "string",        "message": "string",        "branch": "string",        "author": "string"      },      "builder": "railpack",      "builtOn": {        "id": "string",        "name": "string"      },      "shippedTo": [        {          "id": "string",          "name": "string"        }      ],      "image": {        "reference": "string",        "digest": "string",        "sizeBytes": 0,        "shippedBytes": 0      },      "steps": [        {          "key": "clone",          "status": "pending",          "node": {            "id": "string",            "name": "string"          },          "detail": "string",          "durationMs": 0        }      ],      "durationMs": 0,      "canRollback": true,      "rollbackOf": "string",      "error": "string",      "createdAt": "2019-08-24T14:15:22Z",      "startedAt": "2019-08-24T14:15:22Z",      "finishedAt": "2019-08-24T14:15:22Z",      "serviceName": "string",      "projectId": "string"    }  ]}

Read a deployment's log GET

Returns the build and deploy log of a deployment, oldest first, after a sequence number. done is true once the deployment finished and every line has been returned. Build logs are read from the node that built. Needs `services.view` on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Roll back to a deployment POST

Deploys the image of an earlier successful deployment again, by digest, without building. Settings and environment are the current ones. Fails when the image is no longer kept. Needs `services.deploy` on the service (a grant on its project covers it). Available to MCP clients and the assistant.