Skip to Content
SeyloDocs
API referenceLogs

Search service logs

GET
/api/v1/logs.search

Searches a service's stored logs across deploys, newest first. The query is a case-insensitive substring, or an RE2 expression with regex set. Use nextCursor for older matches.

Needs logs.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}$
query?string
Lengthlength <= 500
regex?boolean
Defaultfalse
since?string
Formatdate-time
until?string
Formatdate-time
nodeId?string

Panel-issued id.

Match^[a-z0-9]{16}$
limit?integer
Range1 <= value <= 5000
Default500
cursor?string
Lengthlength <= 2000

Response Body

Success.

application/json
  1. response
entries*array<>
nextCursor*string|null
offlineNodeIds*array<>
Example Request
curl -X GET 'https://example.com/api/v1/logs.search?serviceId=string'
Example Response
{  "entries": [    {      "time": "2019-08-24T14:15:22Z",      "stream": "stdout",      "nodeId": "string",      "containerId": "string",      "generation": 0,      "line": "string"    }  ],  "nextCursor": "string",  "offlineNodeIds": [    "string"  ]}

Open a live log stream GET

Returns a one-minute ticket for the logs WebSocket of a service (or of one build): the last lines first, then new lines as they are written. Needs `logs.view` on the service (a grant on its project covers it). Not available to MCP clients or the assistant.

Get a service's maintenance page GET

Returns a service's maintenance mode, its own page if any, and which page visitors actually see. Needs `services.view` on the service (a grant on its project covers it). Available to MCP clients and the assistant.