Revoke an external identity link
DELETE
/api/chat-endpoints/{endpointId}/principals/{principalId}/linkPersonal API keyAgent API keyConsole session
Revoke an external identity link.
Revokes the endpoint-scoped link for the external identity. An inaccessible endpoint or missing link is reported as not found.
Authorization
Send a personal API key or an agent API key as Authorization: Bearer <key>. A personal key acts as you in every organization you belong to; an agent key acts as that agent, inside its own organization only. How keys work.
Path parameters
endpointIdstring (uuid)RequiredThe endpoint's id.
principalIdstring (uuid)RequiredThe principal's id.
Responses
204No contentDone; there is no body.
401UnauthorizedNo key, or the key is unknown, revoked or expired.
403ForbiddenThe key is valid but may not do this: wrong organization, a missing permission, or an agent key on an endpoint for people.
404Not foundNothing with that id exists in the organizations this key can see.
Errors return {"error": "..."}, often with a code and details. See errors and limits.