Set whether a live customer call may ring the authenticated agent

PUT 
/api/me/availability

Sets the acting agent's CALL availability (SES-1 F2). Deliberately not part of PUT /me or PUT /me/presence: an agent changes it between calls from a control in the app chrome, and "taking new chats" and "may be interrupted by a phone call" are different answers.

Only available agents are ring targets. Being mid-call is computed from live call sessions, not from this field. Nothing is broadcast — a ringing call reads availability at ring time, so there is no roster state to keep in sync.

Request

Responses

200

The updated user.

401

Not authenticated. code: account_disabled means the member's seat was deactivated in this workspace: the session is over even though the token was not revoked (clients sign out and clean up).

422

The request failed validation.