PRprimitive
Credentials

Read the credential audit trail

Credential events (created, rotated, edited, revoked, used with a step-up, policy changes), newest first, with a cursor. format=csv returns the same page as CSV. Needs the organization's credential features to be enabled; while they are not, this answers 404 feature_disabled.

Person only: a dashboard session. The person's role must hold credential_events:read. API keys, agent connection keys and agents are refused.

get/credential-events

Request

  • Base URL
    https://api.primitive.dev/v1
  • URL
    https://api.primitive.dev/v1/credential-events
  • Auth
    HTTP bearer

Query parameters

cursorstring

Opaque next_cursor from the preceding page. Omit for the first page.

limitinteger

Events per page, from 1 to 500.

actor_idstring

Only events this person caused.

credential_idstring

Only events about this credential.

event_typestring

Only events of this type, for example key.created.

sincestring date-time

Only events at or after this time (ISO 8601).

untilstring date-time

Only events before this time (ISO 8601).

format'json' | 'csv'

json (the default) or csv.

Response

Success

successtrue required

Changes

No operation changes recorded.