Add an ACS User to a User Identity

Add a specified ACS user to a specified user identity

Adds a specified ACS user to a specified user identity.

/user_identities/add_acs_user

post

Adds a specified access system user to a specified user identity.

You must specify either user_identity_id or user_identity_key to identify the user identity.

If user_identity_key is provided, but the user identity doesn't exist, a new user identity will be created automatically using information from the ACS user.

Authorizations

api_keypat_with_workspaceconsole_session_with_workspace

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

user_identity_idstring · uuidOptional

ID of the user identity to which you want to add an access system user.

user_identity_keystringOptional

Key of the user identity to which you want to add an access system user.

acs_user_idstring · uuidRequired

ID of the access system user that you want to add to the user identity.

Responses

200

OK

application/json

400

Bad Request

401

Unauthorized

post

/user_identities/add_acs_user

HTTPcURLJavaScriptPython

POST /user_identities/add_acs_user HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 139

{
  "user_identity_id": "123e4567-e89b-12d3-a456-426614174000",
  "user_identity_key": "text",
  "acs_user_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "ok": true
}

Request

Specify the desired user identity and ACS user by including the corresponding user_identity_id and acs_user_id in the request body.

Request Body Parameters

Parameter	Type	Description
user_identity_id	String Required	ID of the desired user identity
acs_user_id	String Required	ID of the desired user

Sample Request

cURL (bash)

curl -X 'POST' \
  'https://connect.getseam.com/user_identities/add_acs_user' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer ${API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "user_identity_id": "48500a8e-5e7e-4bde-b7e5-0be97cae5d7a",
  "acs_user_id": "4d223973-0874-4831-8630-bfcb29e6bce0"
}'

Go

Response

Returns a Boolean ok status indicator.

Sample Response

JSON

{
  "ok": true
}