Skip to Content
SeyloDocs
API referenceBuilds

Get a service's build settings

GET
/api/v1/builds.getSettings

Returns how a service is built (builder, paths, inline Dockerfile, command overrides, build node) and the nodes it could build on, with whether each can build.

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

Authorization

cookieseylo_session<token>

Query Parameters

serviceId*string

Panel-issued id.

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

Response Body

Success.

application/json
  1. response
settings*
nodes*array<>
Example Request
curl -X GET 'https://example.com/api/v1/builds.getSettings?serviceId=string'
Example Response
{  "settings": {    "builder": "railpack",    "contextPath": "string",    "dockerfilePath": "string",    "inlineDockerfile": "string",    "targetStage": "string",    "buildNodeId": "string",    "startCommand": "string",    "installCommand": "string",    "buildCommand": "string"  },  "nodes": [    {      "id": "string",      "name": "string",      "canBuild": true,      "online": true,      "queued": 0    }  ]}

Stop a Box POST

Stops a Box now. Files in its home volume stay; opening it again starts it. Needs `boxes.use` on the service (a grant on its project covers it). Available to MCP clients and the assistant.

List the build queue GET

Lists builds that are queued or running on every node (or one node), oldest first, with their place in the queue. Only builds of services the caller can view are returned. Any signed-in caller. Available to MCP clients and the assistant.