Nimbu Developer Docs
ReferenceApps

List app logs

GET
/apps/{app_id}/logs

Lists application logs. The since cursor is inclusive and returns logs ascending when present; clients should dedupe boundary entries by id.

Authorization

AuthorizationBearer <token>

Personal access token tied to a user account. Requires the X-Nimbu-Site header to scope requests.

In: header

X-Nimbu-Site<token>

Identifier of the site context when authenticating with a personal access token.

In: header

Path Parameters

app_id*string

Application key

Query Parameters

since?|

Inclusive lower time bound as float epoch or ISO8601, matching logs with t greater than or equal to since.

before?|

Exclusive upper time bound as float epoch or ISO8601, matching logs with t less than before.

level?string

Minimum severity to include.

Value in"debug" | "info" | "warn" | "error" | "fatal" | "unknown"
q?string

Text search query. Supports level:error text syntax. Text search only scans the 24 hours before the before parameter (or now); pass since to search an explicit range.

job?string

Background job name; only logs with matching background job context are returned.

limit?integer

Maximum number of logs to return. Values are clamped to 1 through 200.

Default100
Range1 <= value <= 200

Header Parameters

X-Nimbu-Site*string

Site identifier

Response Body

application/json

application/json

curl -X GET "https://example.com/apps/string/logs" \  -H "X-Nimbu-Site: string"
[
  {
    "level": "string",
    "data": {},
    "created_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "time": 0,
    "context": {}
  }
]
Empty
{
  "message": "string",
  "code": 0,
  "errors": [
    {
      "resource": "string",
      "field": "string",
      "message": "string",
      "code": "string",
      "messages": [
        "string"
      ],
      "codes": [
        "string"
      ],
      "value": null
    }
  ]
}