Skip to content
Authrim

List changes to the tenant's default and apps' Mapping Set choices.

GET
/api/admin/identity-mapping/history
Code sample: Shell / cURL 
curl --request GET \
  --url 'https://auth.example.com/api/admin/identity-mapping/history?tier=tenant_default&limit=50' \
  --header 'Authorization: Bearer <token>'

Lists committed changes to level choices, newest first, for the calling tenant only. Includes settings PATCH, bulk apply, client update and restore operations. Set content changes are not level history. Each entry describes the saved values before and after the change; unset is distinct from an explicit opt-out. Whether the entry can now be restored is evaluated against the current level and the current set, rather than saved in the history row. An entry restores its before value. Requires settings read access; client history (including an unfiltered list) also requires clients read access. A caller with only settings read access can request tier=tenant_default. Pages may end before limit after 20 distinct target choices; follow next_cursor. Rate limited with the moderate profile.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
tier
string
Allowed values: tenant_default client
client_id
string
>= 1 characters <= 256 characters

Restrict app-level history to this client of the calling tenant.

limit
integer
default: 50 >= 1 <= 100
cursor
string
<= 2048 characters

The opaque next_cursor returned by the previous page.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

One page of committed level changes.

Media type application/json
object
log_coverage
object
consistency
required
string
Allowed values: snapshot eventual local_hot_only
pending_deliveries
required

Null for self-service subjects that cannot inspect tenant delivery counts.

integer | null
complete
required

Pipeline and local staging-only views remain false even when no pending deliveries are known.

boolean
key
additional properties
entries
required
Array<object>
<= 100 items
object
id
required
string
tier
required
string
Allowed values: tenant_default client
client_id
required
string | null
before
required
One of:
object
state
required
string
Allowed values: unset none invalid
key
additional properties
after
required
One of:
object
state
required
string
Allowed values: unset none invalid
key
additional properties
actor_id
required
string
actor_type
required
string
via
required
string
Allowed values: settings client bulk_apply restore
bulk_id
required
string | null
created_at
required

Unix time in milliseconds.

integer
source_version
required

The version of the level after this change.

string
restorable
required
boolean
not_restorable_reason
string
Allowed values: set_deleted set_inactive is_current client_deleted invalid_history
key
additional properties
next_cursor
required
string | null
key
additional properties
Example 
{
  "log_coverage": {
    "consistency": "snapshot"
  },
  "entries": [
    {
      "tier": "tenant_default",
      "before": {
        "state": "unset"
      },
      "after": {
        "state": "unset"
      },
      "via": "settings",
      "not_restorable_reason": "set_deleted"
    }
  ]
}

Headers

Section titled “Headers ”
X-Authrim-Log-Consistency
string
Allowed values: snapshot eventual local_hot_only

Snapshot for the remote scheduled view; eventual when Pipeline visibility can lag ingestion; local_hot_only for local scheduled staging without a remote Catalog.

X-Authrim-Log-Pending-Deliveries
integer

Tenant deliveries not yet confirmed visible. Omitted for self-service subjects. Zero does not guarantee immediate Pipeline visibility.

X-Authrim-Log-Complete
boolean

True only for a complete bounded snapshot query. Pipeline responses remain false; incomplete reads return 503.

400

Section titled “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

Section titled “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

Section titled “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"
}

429

Section titled “429 ”

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"
}

503

Section titled “503 ”

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"
}