Unlink one current user's device.

DELETE

/api/account/devices/{id}

Code sample: Shell / cURL

curl --request DELETE \
  --url https://auth.example.com/api/account/devices/example \
  --cookie authrim_session=<authrim_session>

Revokes or unlinks a device installation owned by the authenticated Account Page user.

Authorizations

• accountSessionCookie

Parameters

Path Parameters

id

required

string

Responses

200

Account Page device unlink response.

Media type application/json

object

ok

required

boolean

device_unlink_result

required

object

action

required

string

Allowed values: device_unlinked

target_id

required

string

signed_out_required

required

boolean

status

required

string

Allowed values: completed already_applied

Example

{
  "device_unlink_result": {
    "action": "device_unlinked",
    "status": "completed"
  }
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

404

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}