description |
---|
Get all access control systems associated with a specified user identity |
Returns a list of all access control systems associated with a user identity.
{% swagger src="https://connect.getseam.com/openapi.json" path="/user_identities/list_acs_systems" method="post" %} https://connect.getseam.com/openapi.json {% endswagger %}
Specify the user identity for which you want to retrieve all associated access control systems by including the corresponding user_identity_id
in the request body.
Parameter | Type | Description |
---|---|---|
user_identity_id | String Required | ID of the user identity for which you want to retrieve all access control systems |
{% tabs %} {% tab title="cURL (bash)" %}
# Use GET or POST.
curl -X 'GET' \
'https://connect.getseam.com/user_identities/list_acs_systems' \
-H 'accept: application/json' \
-H 'Authorization: Bearer ${API_KEY}' \
-H 'Content-Type: application/json' \
-d '{
"user_identity_id": "5c945ab5-c75e-4bcb-8e5f-9410061c401f"
}'
{% endtab %}
{% tab title="Go" %}
acsSystems, uErr := client.UserIdentities.ListAcsSystems(context.Background(), &useridentities.UserIdentitiesListAcsSystemsRequest{
UserIdentityId: "48500a8e-5e7e-4bde-b7e5-0be97cae5d7a",
})
if uErr != nil {
return uErr
}
fmt.Println(acsSystems)
return nil
{% endtab %} {% endtabs %}
Returns an acs_systems
array, in which each returned access control system (acs_system
) contains the following properties:
Property | Description |
---|---|
acs_system_id | ID of the access control system |
external_type | Brand-specific terminology for the access control system type |
external_type_display_name | Display name that corresponds to the brand-specific terminology for the access control system type |
name | Name of the access control system |
created_at | Date and time at which the access control system was created |
workspace_id | ID of the workspace that contains the access control system |
connected_account_ids | Array of connected account IDs associated with the access control system |
This response also includes a Boolean ok
status indicator.
{% tabs %} {% tab title="JSON" %}
{
"acs_systems": [
{
"acs_system_id": "6737e186-8d54-48ce-a7da-a0be4d252172",
"name": "Assa Abloy Credential Service",
"workspace_id": "398d80b7-3f96-47c2-b85a-6f8ba21d07be",
"created_at": "2024-01-05T07:16:51.971Z",
"system_type": "assa_abloy_credential_service",
"system_type_display_name": "Assa Abloy Credential Service",
"external_type": "assa_abloy_credential_service",
"external_type_display_name": "Assa Abloy Credential Service",
"connected_account_ids": [
"dc08066f-d9b8-42f0-9c4b-c781cd900153"
]
}
],
"ok": true
}
{% endtab %} {% endtabs %}