/accesskeys/status
Retrieves the current status of the latest change made on a given access key. This can be useful if tracking the propagation of a key to the affected access control systems is needed, after it has been created or updated.
Authentication Type: Integration API Key
📩 Request Body Parameters
Field | Type | Description |
| string(uuid) | Identifier of the access key to get status for. |
Responses
✅ 200 OK Response Body Parameters
StatusResponse Model
Field | Type | Description |
| string(uuid) | Identifier of the access key. |
| string | Overall status. Can be one of the following values:
|
| array[AppliedSystem] | List of all systems where the access key has been applied, with related information. |
| array[PendingSystem] | List of all systems where the latest change on the access key is still pending. |
| array[FailedSystem] | List of all systems where the latest change could not be applied due to an error, with related information. |
AppliedSystem Model
Field | Type | Description |
| string | Access control system identifier. |
| string | Point in time when the change was applied. |
PendingSystem Model
Field | Type | Description |
| string | Access control system identifier. |
FailedSystem Model
Field | Type | Description |
| string | Access control system identifier. |
| string | Indicates the reason of the failure. See the error types section for a description of possible errors. |
❌ 400 Bad Request
Access Key Error Types
Most of the errors types listed below indicates that a mismatch between IntServ Access and the access control system has occured. This can happen for example if configuration changes has been done manually in the access control system that hasn't yet been synchronized, and an access key has been updated between this gap.
Error Type | Description |
| The access key is already in use. This can occur if there is a user in the access control system (that has been managed outside IntServ Access) that owns additional access keys which conflicts with the access key. |
| One or more access levels assigned to the access key does not exist in the system. |
| Usage of codes is not enabled in the access control system, and could therefore not accept the access key. |
| The code size does not match the size configured in the access control system. |
Last updated