Get access trace timeline.

GET

/api/admin/access-trace/timeline

Code sample: Shell / cURL

curl --request GET \
  --url 'https://auth.example.com/api/admin/access-trace/timeline?period=1h&granularity=minute' \
  --header 'Authorization: Bearer <token>'

Returns bucketed allow/deny counts for charting access decisions over time.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Query Parameters

period

string

default: 24h

Allowed values: 1h 6h 24h 7d 30d

Timeline period.

granularity

string

default: hour

Allowed values: minute hour

Requested granularity. For 24h, minute produces one-minute buckets; other periods use handler-selected bucket sizes.

Responses

200

Access trace timeline response.

Media type application/json

object

period

required

string

granularity

required

Bucket size in seconds.

integer

data

required

Array<object>

object

timestamp

required

integer format: int64

total

required

integer

allowed

required

integer

denied

required

integer

key

additional properties

key

additional properties

Example ^generated

{
  "period": "example",
  "granularity": 1,
  "data": [
    {
      "timestamp": 1,
      "total": 1,
      "allowed": 1,
      "denied": 1
    }
  ]
}

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}