Device management
Create or update a device
Updates the metadata on the given device, or creates a new device.
The ability to create new devices is only available to application services: regular clients may only update existing devices.
When a new device was created, the homeserver MUST return a 201 HTTP status code. It MUST return a 200 HTTP status code if a device was updated.
This endpoint is rate-limited for device creation. Servers MAY use login rate limits.
put/_matrix/client/v3/devices/{deviceId}
Request
- Base URLhttps://matrix.org
- Auth
- API key in query parameter access_token
- or HTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
deviceIdstring required
The device to update.
Request body
Example request
{
"display_name": "My other phone"
}Response
The device was successfully updated.
object required
Changes
No recorded changes to this operation across all 1 revision of this API.