Access Tokens

Get token audit log

Lists recent requests made with an access token, newest first. Requires the tokenAuditLog setting to be enabled; it is off by default, and entries only exist from the point it was switched on.

get/v1/tokens/{token}/log

Request

  • Base URL: https://your-emailengine-host
  • URL: https://your-emailengine-host/v1/tokens/{token}/log
  • Auth: HTTP bearer

Path parameters

tokenstring required

The token id, as reported by POST /v1/tokens and the token listing

Example:1bc12baf7f0d5e51fe0a4e0eda06e1be5b8d6cc2c66b95dc0fbe4d2e9f5d5e1a

Query parameters

pageinteger

Page number (zero indexed, so use 0 for first page)

pageSizeinteger

How many entries per page

Example:20

Headers

x-ee-timeoutinteger

Request timeout in milliseconds. Raises the command timeout above the EENGINE_TIMEOUT default for a long-running request; a value below the default has no effect

Example:30000

Response

Returns the recorded requests for this token, newest first.

tokenstring

Token identifier (SHA-256 hash of the token)

totalinteger

How many entries are stored for this token

pageinteger

Current page (zero indexed)

pagesinteger

Total page count

Example response

{
  "token": "1bc12baf7f0d5e51fe0a4e0eda06e1be5b8d6cc2c66b95dc0fbe4d2e9f5d5e1a",
  "total": 120,
  "pages": 6,
  "entries": [
    {
      "time": "2021-02-17T13:43:18.860Z",
      "ip": "127.0.0.1",
      "method": "get",
      "path": "/v1/account/{account}/messages",
      "action": "read",
      "group": "message",
      "account": "user123",
      "status": "allowed",
      "reason": "group"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.