description |
---|
Unassign a specified credential from a specified ACS user |
Unassigns a specified credential from a specified ACS user.
{% swagger src="https://connect.getseam.com/openapi.json" path="/acs/credentials/unassign" method="post" %} https://connect.getseam.com/openapi.json {% endswagger %}
Specify the desired user and credential by including the corresponding acs_user_id
and acs_credential_id
in the request body.
Parameter | Type | Description |
---|---|---|
acs_user_id | String (UUID) Required | ID of the desired user |
acs_credential_id | String (UUID) Required | ID of the desired credential |
{% tabs %} {% tab title="Python" %}
seam.acs.credentials.unassign(
acs_user_id="33333333-3333-3333-3333-333333333333",
acs_credential_id="66666666-6666-6666-6666-666666666666"
)
{% endtab %}
{% tab title="cURL (bash)" %}
curl -X 'POST' \
'https://connect.getseam.com/acs/credentials/unassign' \
-H "Authorization: Bearer ${API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"acs_user_id": "33333333-3333-3333-3333-333333333333",
"acs_credential_id": "66666666-6666-6666-6666-666666666666"
}'
{% endtab %}
{% tab title="JavaScript" %}
await seam.acs.credentials.unassign({
acs_user_id: "33333333-3333-3333-3333-333333333333",
acs_credential_id: "66666666-6666-6666-6666-666666666666"
});
{% endtab %}
{% tab title="Ruby" %}
# Coming soon!
{% endtab %}
{% tab title="PHP" %}
$seam->acs->credentials->unassign(
acs_user_id: "33333333-3333-3333-3333-333333333333",
acs_credential_id: "66666666-6666-6666-6666-66666666"
);
{% endtab %}
{% tab title="C#" %}
seam.CredentialsAcs.Unassign(
acsUserId: "33333333-3333-3333-3333-333333333333",
acsCredentialId: "66666666-6666-6666-6666-66666666"
);
{% endtab %}
{% tab title="Java" %}
// Coming soon!
{% endtab %}
{% tab title="Go" %}
acs_credential, uErr := client.Acs.Credentials.Unassign(
context.Background(), &acs.CredentialsUnassignRequest{
AcsUserId: "33333333-3333-3333-3333-333333333333",
AcsCredentialId: "66666666-6666-6666-6666-66666666",
},
)
{% endtab %} {% endtabs %}
Returns an acs_credential
containing the following properties:
Property | Description |
---|---|
acs_credential_id | ID of the credential |
acs_user_id | ID of the user to whom the credential belongs |
display_name | Display name that corresponds to the credential type |
code | Access (PIN) code for the credential |
acs_system_id | ID of the access control system that contains the credential |
access_method | Access method for the credential. Supported values: code , card , mobile_key |
external_type | Brand-specific terminology for the credential type |
external_type_display_name | Display name that corresponds to the brand-specific terminology for the credential type |
workspace_id | ID of the workspace that contains the credential |
created_at | Date and time at which the credential was created |
is_multi_phone_sync_credential | Indicates whether the credential is a multi-phone sync credential |
starts_at | Date and time at which the credential validity starts, in ISO 8601 format |
ends_at | Date and time at which the credential validity ends, in ISO 8601 format |
XXX_metadata | ACS manufacturer-specific metadata for the credential, where XXX is the manufacturer |
{% hint style="info" %} This response contains manufacturer-specific metadata that may vary by manufacturer. {% endhint %}
{% tabs %} {% tab title="Python" %}
AcsCredential(
acs_credential_id='99999999-9999-9999-9999-999999999999',
acs_user_id='33333333-3333-3333-3333-333333333333',
display_name='Multi Phone Sync Credential',
code=null,
acs_system_id='11111111-1111-1111-1111-111111111111',
access_method='mobile_key',
workspace_id='00000000-0000-0000-0000-000000000000',
created_at='2024-04-12T03:56:22.396Z',
is_multi_phone_sync_credential=True,
# manufacturer-specific metadata
)
{% endtab %}
{% tab title="cURL (bash)" %}
{
"acs_credential": {
"acs_credential_id": "99999999-9999-9999-9999-999999999999",
"acs_user_id": "33333333-3333-3333-3333-333333333333",
"display_name": "Multi Phone Sync Credential",
"code": null,
"acs_system_id": "11111111-1111-1111-1111-111111111111",
"access_method": "mobile_key",
"workspace_id": "00000000-0000-0000-0000-000000000000",
"created_at": "2024-04-12T03:56:22.396Z",
"is_multi_phone_sync_credential": true,
# manufacturer-specific metadata
},
"ok": true
}
{% endtab %}
{% tab title="JavaScript" %}
{
acs_credential_id: '99999999-9999-9999-9999-999999999999',
acs_user_id: '33333333-3333-3333-3333-333333333333',
display_name: 'Multi Phone Sync Credential',
code: null,
acs_system_id: '11111111-1111-1111-1111-111111111111',
access_method: 'mobile_key',
workspace_id: '00000000-0000-0000-0000-000000000000',
created_at: '2024-04-12T03:56:22.396Z',
is_multi_phone_sync_credential: true,
// manufacturer-specific metadata
}
{% endtab %}
{% tab title="Ruby" %}
# Coming soon!
{% endtab %}
{% tab title="PHP" %}
{
"acs_credential_id": "99999999-9999-9999-9999-999999999999",
"acs_user_id": "33333333-3333-3333-3333-333333333333",
"display_name": "Multi Phone Sync Credential",
"code": null,
"acs_system_id": "11111111-1111-1111-1111-111111111111",
"access_method": "mobile_key",
"workspace_id": "00000000-0000-0000-0000-000000000000",
"created_at": "2024-04-12T03:56:22.396Z",
"is_multi_phone_sync_credential": true,
// manufacturer-specific metadata
}
{% endtab %}
{% tab title="C#" %}
{
"acs_credential_id": "99999999-9999-9999-9999-999999999999",
"acs_user_id": "33333333-3333-3333-3333-333333333333",
"display_name": "Multi Phone Sync Credential",
"code": null,
"acs_system_id": "11111111-1111-1111-1111-111111111111",
"access_method": "mobile_key",
"workspace_id": "00000000-0000-0000-0000-000000000000",
"created_at": "2024-04-12T03:56:22.396Z",
"is_multi_phone_sync_credential": true,
// manufacturer-specific metadata
}
{% endtab %}
{% tab title="Java" %}
// Coming soon!
{% endtab %}
{% tab title="Go" %}
{
"acs_credential": {
"acs_credential_id": "99999999-9999-9999-9999-999999999999",
"acs_user_id": "33333333-3333-3333-3333-333333333333",
"display_name": "Multi Phone Sync Credential",
"code": null,
"acs_system_id": "11111111-1111-1111-1111-111111111111",
"access_method": "mobile_key",
"workspace_id": "00000000-0000-0000-0000-000000000000",
"created_at": "2024-04-12T03:56:22.396Z",
"is_multi_phone_sync_credential": true,
# manufacturer-specific metadata
},
"ok": true
}
{% endtab %} {% endtabs %}