Skip to main content
GET
List a provider's recent audit events
Returns up to limit (1-50, default 10) recorded changes to one provider, newest first, as ProviderAuditEvent items: event, category and time only. The actor and the change detail (option diffs) stay in the Console, as in the capability feed. This is a recent feed of the newest 50 events, paged with limit and cursor: when older events exist past them, the last page then answers meta.hasMore: false with meta.truncated: true. Provider configuration is deployment-wide, so audit:read is decided at the platform scope: a credential granted it only at an org unit is refused with 403. A missing key or any other limit is 400; an unknown key is 404. Provider record creations are recorded under the record (<domain>/<providerKey>), so neither this feed nor the capability feed lists them; they stay in the Console.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Path Parameters

providerKey
string
required

The provider key, as listProviders returns it (for example anthropic).

Minimum string length: 1

Query Parameters

limit
integer
default:10

Items per page, 1 to 50 (default 10); a larger value is a 400 too_big. A page may hold fewer items than limit while meta.hasMore is true; continue with meta.nextCursor.

Required range: 1 <= x <= 50
cursor
string

The previous page's meta.nextCursor; any other value is 400.

Minimum string length: 1

Response

Provider audit events

data
object[]
required
meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.