Get Audit Logs

Changed on Nov 3, 2026

Retrieve audit logs for employee usage of the Knot Dashboard.

get/audit_logs

Request

Base URL
https://production.knotapi.com
URL
https://production.knotapi.com/audit_logs
Auth
HTTP basic

Query parameters

startstring date-time

Example:2025-01-01T00:00:00Z

Filter audit logs to those created on or after this timestamp. Must be in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).

endstring date-time

Example:2025-12-31T23:59:59Z

Filter audit logs to those created on or before this timestamp. Must be in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).

next_cursorstring

Example:eyJpZCI6MTIzNDU2LCJfcG9pbnRzVG9OZXh0SXRlbXMiOnRydWV9

Cursor token for pagination. Use the next_cursor value from the previous response to retrieve the next page of results.

Response

Successful request.

next_cursorstring nullable

Cursor token for the next page of audit logs. Null if there are no further results.

limitinteger

Number of items per page.

Example response

{
  "data": [
    {
      "id": "a0b66190-9e04-4bc6-82ae-5d98e1f70e59",
      "datetime": "2025-12-23T15:48:58Z",
      "event": {
        "action": "merchant.hide",
        "outcome": {
          "status": "success"
        }
      },
      "actor": {
        "name": "Ada Lovelace",
        "email": "ada@lovelace.com"
      },
      "target": {
        "type": "merchant",
        "name": "Amazon Prime",
        "environment": "production"
      },
      "context": {
        "ip": "208.204.24.80",
        "user_agent": "Mozilla/5.0 ..."
      }
    }
  ],
  "limit": 100
}

Changes

Nov 3, 2026f10ecfa12c00 Revision changes
- warning
  added the new CANCELLABLE_SUBSCRIPTION_NOT_FOUND enum value to the response property for the response status
- warning
  added the new CANCELLABLE_SUBSCRIPTION_NOT_FOUND enum value to the response property for the response status
- warning
  added the new CANCELLABLE_SUBSCRIPTION_NOT_FOUND enum value to the response property for the response status
- warning
  added the new ENVIRONMENT_MISMATCH enum value to the response property for the response status
- warning
  added the new ENVIRONMENT_MISMATCH enum value to the response property for the response status
- warning
  added the new ENVIRONMENT_MISMATCH enum value to the response property for the response status
- warning
  added the new INSUFFICIENT_ROLE enum value to the response property for the response status
- warning
  added the new INSUFFICIENT_ROLE enum value to the response property for the response status
- warning
  added the new INSUFFICIENT_ROLE enum value to the response property for the response status
- warning
  added the new INSUFFICIENT_SCOPE enum value to the response property for the response status
- warning
  added the new INSUFFICIENT_SCOPE enum value to the response property for the response status
- warning
  added the new INSUFFICIENT_SCOPE enum value to the response property for the response status
- warning
  added the new INVALID_ACCESS_TOKEN enum value to the response property for the response status
- warning
  added the new INVALID_ACCESS_TOKEN enum value to the response property for the response status
- warning
  added the new INVALID_ACCESS_TOKEN enum value to the response property for the response status
- warning
  added the new MULTIPLE_CANCELLABLE_SUBSCRIPTIONS_FOUND enum value to the response property for the response status
- warning
  added the new MULTIPLE_CANCELLABLE_SUBSCRIPTIONS_FOUND enum value to the response property for the response status
- warning
  added the new MULTIPLE_CANCELLABLE_SUBSCRIPTIONS_FOUND enum value to the response property for the response status
- warning
  added the new RATE_LIMIT_EXCEEDED enum value to the response property for the response status
- warning
  added the new RATE_LIMIT_EXCEEDED enum value to the response property for the response status
- warning
  added the new RATE_LIMIT_EXCEEDED enum value to the response property for the response status
- warning
  added the new REQUEST_LOG_ERROR enum value to the response property for the response status
- warning
  added the new REQUEST_LOG_ERROR enum value to the response property for the response status
- warning
  added the new REQUEST_LOG_ERROR enum value to the response property for the response status
- warning
  added the new REQUEST_LOG_NOT_FOUND enum value to the response property for the response status
- warning
  added the new REQUEST_LOG_NOT_FOUND enum value to the response property for the response status
- warning
  added the new REQUEST_LOG_NOT_FOUND enum value to the response property for the response status
- warning
  added the new REQUEST_LOG_QUERY_TIMEOUT enum value to the response property for the response status
- warning
  added the new REQUEST_LOG_QUERY_TIMEOUT enum value to the response property for the response status
- warning
  added the new REQUEST_LOG_QUERY_TIMEOUT enum value to the response property for the response status
- warning
  added the new WEBHOOK_ENDPOINT_ALREADY_EXISTS enum value to the response property for the response status
- warning
  added the new WEBHOOK_ENDPOINT_ALREADY_EXISTS enum value to the response property for the response status
- warning
  added the new WEBHOOK_ENDPOINT_ALREADY_EXISTS enum value to the response property for the response status
- warning
  added the new WEBHOOK_ENDPOINT_ERROR enum value to the response property for the response status
- warning
  added the new WEBHOOK_ENDPOINT_ERROR enum value to the response property for the response status
- warning
  added the new WEBHOOK_ENDPOINT_ERROR enum value to the response property for the response status
- warning
  added the new WEBHOOK_ENDPOINT_LIMIT_REACHED enum value to the response property for the response status
- warning
  added the new WEBHOOK_ENDPOINT_LIMIT_REACHED enum value to the response property for the response status
- warning
  added the new WEBHOOK_ENDPOINT_LIMIT_REACHED enum value to the response property for the response status
- warning
  added the new WEBHOOK_ENDPOINT_NOT_FOUND enum value to the response property for the response status
- warning
  added the new WEBHOOK_ENDPOINT_NOT_FOUND enum value to the response property for the response status
- warning
  added the new WEBHOOK_ENDPOINT_NOT_FOUND enum value to the response property for the response status

Operation history