Remove an association between a session and a Matrix user ID.
POST {{baseUrl}}/3pid/unbind
Remove an association between a session and a Matrix user ID.
Future calls to /lookup
for any of the session's 3pids will not
return the removed association.
The identity server should authenticate the request in one of two ways:
- The request is signed by the homeserver which controls the
user_id
. - The request includes the
sid
andclient_secret
parameters, as per/3pid/bind
, which proves ownership of the 3PID.
If this endpoint returns a JSON Matrix error, that error should be passed through to the client requesting an unbind through a homeserver, if the homeserver is acting on behalf of a client.
Request Body
{"sid"=>"1234", "client_secret"=>"monkeys_are_GREAT", "mxid"=>"@ears:example.org", "threepid"=>{"medium"=>"email", "address"=>"monkeys_have_ears@example.org"}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
{}