Delete a device

This API endpoint uses the User-Interactive Authentication API, except when used by an application service.

Deletes the given device, and invalidates any access token associated with it.

WARNING: When this endpoint requires User-Interactive Authentication, it cannot be used when the access token was obtained via the OAuth 2.0 API.

WARNING: [Added in v1.18] OAuth 2.0 aware clients MUST NOT use this endpoint when the server supports the OAuth 2.0 API. Instead they MUST refer the user to the account management URL, if available, with the action=org.matrix.device_delete and device_id={deviceId} parameters.

delete/_matrix/client/v3/devices/{deviceId}

Request

Base URL
https://matrix.org
Auth
- API key in query parameter access_token
- or HTTP bearer
TypeScript
https://skmtc.dev/matrix/apis/matrix-client-server-api/docs/_matrix/client/v3/devices/:deviceId/delete.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

deviceIdstring required

The device to delete.

Request body

Example request

{
  "auth": {
    "example_credential": "verypoorsharedsecret",
    "session": "xxxxx",
    "type": "example.type.foo"
  }
}

Response

The device was successfully removed, or had been removed previously.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.