Get Logs

This endpoint gets new logs

GET /v1/logs

cURL

curl 'https://api.stateset.com/v1/logs?limit=50' \
  -H 'Authorization: Bearer <token>'

200

{
  "logs": [
    {
      "id": "log_8y4mQr5oP2",
      "type": "deployment",
      "description": "Build completed for deploy dep_1042",
      "timestamp": "2026-07-25T18:22:03Z"
    }
  ]
}

Query parameters

limit · integer

Maximum number of log entries to return.

Body

id · string

This is the ID of the logs to be get

This read takes a request body. The Fetch standard forbids a body on GET, so fetch() rejects this call rather than sending one — reach for a server-side client (curl, undici.request, Python requests) instead. Proxies and CDNs are also free to drop a body on a read, so prefer a direct connection.

Response

logs · object[]

Show logs

id · string

This is the ID of the logs

description · string

This is the description of the logs

timestamp · string

This is the timestamp of the logs

type · string

This is the type of the logs

Errors

Succeeds with 200. Failures return 400, 401, 403 or 429 with an error body, per the platform status-code contract.

cURL

curl 'https://api.stateset.com/v1/logs?limit=50' \
  -H 'Authorization: Bearer <token>'

200

{
  "logs": [
    {
      "id": "log_8y4mQr5oP2",
      "type": "deployment",
      "description": "Build completed for deploy dep_1042",
      "timestamp": "2026-07-25T18:22:03Z"
    }
  ]
}