KNknotapi

List Request Logs

Changed on

List API and webhook request logs.

get/request-logs

Request

  • Base URL
    https://api.dashboard.knotapi.com
  • URL
    https://api.dashboard.knotapi.com/request-logs
  • Auth
    HTTP bearer

Query parameters

environment'development' | 'production' required
Example:development

The environment to read logs from. Must match your access token's environment.

startstring date-time
Example:2026-10-14T00:00:00Z

Return logs created on or after this timestamp, in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ). Defaults to 24 hours before end. Must be no more than 7 days before end.

endstring date-time
Example:2026-10-15T00:00:00Z

Return logs created on or before this timestamp, in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ). Defaults to the current time.

type'request' | 'webhook'
Example:webhook

Return only API request logs (request) or only webhook delivery logs (webhook). Returns both if omitted.

session_idstring uuid
Example:915efe72-5136-4652-9a1f-d9d48003c102

Return only logs for this session.

task_idinteger
Example:7754123

Return only logs for this task.

external_user_idstring
Example:user-123

Return only logs for this user.

eventstring
Example:AUTHENTICATED

Return only webhook logs for this event.

status_codeinteger
Example:400

Return only logs with this HTTP status code. For webhook logs, this is the status code your endpoint returned.

limitinteger
Example:25

Maximum number of logs to return.

next_cursorstring
Example:eyJjcmVhdGVkX2F0IjoiMjAyNi0xMC0xNSAxNDozMTo1NSIsImlkIjo5ODIzMTcwMiwiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ

Cursor for the next page. Use the next_cursor value from the previous response and send the same filters, including start and end.

Response

Successful request.

next_cursorstring nullable required

Cursor for the next page, or null if there are no more logs.

limitinteger required

Maximum number of logs returned per page.

Example response

{
  "data": [
    {
      "id": 98231774,
      "type": "webhook",
      "datetime": "2026-10-15T14:32:08Z",
      "method": "POST",
      "url": "https://example.com/webhooks/knot?token=********",
      "event": "AUTHENTICATED",
      "status_code": 200,
      "latency_ms": 184,
      "session_id": "915efe72-5136-4652-9a1f-d9d48003c102",
      "task_id": 7754123,
      "external_user_id": "user-123"
    }
  ],
  "limit": 25
}

Changes