Grant a User Identity Access to a Device

Grant a specified user identity access to a specified device

Grants a specified user identity access to a specified device.

You can only grant user identities access to managed devices.

/user_identities/grant_access_to_device

post

Grants a specified user identity access to a specified device.

Authorizations

api_keypat_with_workspaceconsole_session_with_workspace

Body

user_identity_idstring · uuidRequired

ID of the user identity that you want to grant access to a device.

device_idstring · uuidRequired

ID of the managed device to which you want to grant access to the user identity.

Responses

200

OK

application/json

400

Bad Request

401

Unauthorized

post

HTTPcURLJavaScriptPython

POST /user_identities/grant_access_to_device HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer API Key
Content-Type: application/json
Accept: */*
Content-Length: 110

{
  "user_identity_id": "123e4567-e89b-12d3-a456-426614174000",
  "device_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "ok": true
}

Request

Specify the desired user identity and device by including the corresponding user_identity_id and device_id in the request body.

Request Body Parameters

Parameter	Type	Description
user_identity_id	String Required	ID of the desired user identity
device_id	String Required	ID of the desired managed device

Sample Request

cURL (bash)

curl -X 'POST' \
  'https://connect.getseam.com/user_identities/grant_access_to_device' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer ${API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "user_identity_id": "f3a328b4-dd04-4370-9000-d52b7a01b0bf",
  "device_id": "054765c8-a2fc-4599-b486-14c19f462c45"
}'

Go

_, uErr := client.UserIdentities.GrantAccessToDevice(context.Background(), &api.UserIdentitiesGrantAccessToDeviceRequest{
    UserIdentityId: "f3a328b4-dd04-4370-9000-d52b7a01b0bf",
    DeviceId: "054765c8-a2fc-4599-b486-14c19f462c45",
})

if uErr != nil {
    return uErr
}

return nil

Response

Returns a Boolean ok status indicator.

Sample Response

JSON

{
  "ok": true
}