GET/principals/history
Page projection policy history
Operation principals.history.get
Description
Pages public signed policy snapshots, up to 32 predecessor states at a time, for a principal head cited by an object the caller can read. The opaque grant query value names that object and head, and every page rechecks current access to it. A 202 asks the client to retry the identical request after policy history is prepared.
Authentication
Requires a signed-in session: the client sends its session token as a bearer token in the Authorization header.
Parameters
| Name | In | Type | Details |
|---|---|---|---|
grant | query | string | required
|
afterVersion | query | integer | optional
|
Responses
200 OK
application/jsonPrincipalPolicySnapshotPageResponse
A page of public signed policy history, without encrypted payloads or member envelopes.
5 fields
- at most 32 items
historyPageobjectrequiredWhich predecessor versions this page covers and where the next page starts.
2 fields
afterVersionintegerrequired- at least 0
nextAfterVersionintegerrequirednullable- at least 0
Other fields are allowed.
Other fields are allowed.
202 Verification preparation is pending. Retry the identical authorized read.
application/jsonPrincipalHistoryPreparationResponse
A 202: the operation rolled back while the server prepares principal history. Retry the identical request.
3 fields
codestringrequired- always
principal_history_preparation_pending
- always
committedbooleanrequired- always
false
- always
progressTokenstringrequired- exactly 64 characters
- lowercase hexadecimal
Changes when preparation advances; clients stop after three identical tokens in a row.
Other responses
| Status | Meaning | Body |
|---|---|---|
| 400 | Bad Request |
|
| 401 | Unauthorized |
|
| 403 | Forbidden |
|
| 404 | Not Found |
|
| 409 | Conflict |
|
| 500 | Internal Server Error |
|
| 503 | Service Unavailable |
|