---
title: "Update Unified Presence"
method: PATCH
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/unified-presence"
tags: ["Presence"]
---

# Update Unified Presence

`PATCH /restapi/v1.0/account/{accountId}/extension/{extensionId}/unified-presence`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/extension/{extensionId}/unified-presence`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/restapi/v1.0/account/:accountId/extension/:extensionId/unified-presence/patch.ts> (a function with typed inputs; its response is checked against the schema)

Updates the unified presence for the current user specified in path.

## Path parameters

- `accountId` string, required
- `extensionId` string, required

## Request body

- UpdateUnifiedPresence
  - `glip` UpdateUnifiedPresenceGlip
    - `visibility` 'Visible' | 'Invisible': Visibility setting allowing other users to see Glip presence status
    - `availability` 'Available' | 'DND': Availability setting specifying whether to receive Glip notifications or not
  - `telephony` UpdateUnifiedPresenceTelephony
    - `availability` 'TakeAllCalls' | 'DoNotAcceptAnyCalls' | 'DoNotAcceptQueueCalls': Telephony DND status

## Response `200`

OK

- UnifiedPresence
  - `status` 'Available' | 'Offline' | 'DND' | 'Busy': Aggregated presence status of the user
  - `glip` UnifiedPresenceGlip: Returned if *Glip* feature is switched on
    - `status` 'Offline' | 'Online': Glip connection status calculated from all user's apps. Returned always for the requester's extension; returned for another users if their glip visibility is set to 'Visible'
    - `visibility` 'Visible' | 'Invisible': Visibility setting allowing other users to see the user's Glip presence status; returned only for requester's extension
    - `availability` 'Available' | 'DND': Shows whether user wants to receive Glip notifications or not.
  - `telephony` UnifiedPresenceTelephony: Returned if *BLF* feature is switched on
    - `status` 'NoCall' | 'Ringing' | 'CallConnected' | 'OnHold' | 'ParkedCall': Telephony status calculated from all user's phone numbers. Returned always for the requester's extension; returned for another users if their telephony visibility is set to 'Visible'
    - `visibility` 'Visible' | 'Invisible': Specifies if the user's phone presence status is visible to other users; returned only for requester's extension
    - `availability` 'TakeAllCalls' | 'DoNotAcceptAnyCalls' | 'DoNotAcceptQueueCalls': Telephony DND status. Returned if *DND* feature is switched on
  - `meeting` UnifiedPresenceMeeting: Returned if *Meetings* feature is switched on
    - `status` 'NoMeeting' | 'InMeeting': Meeting status calculated from all user`s meetings

## Other responses

- `400`: Some of parameters are missing or have invalid format
- `403`: User is not allowed to do this action
- `404`: Resource not found

---

[API](https://skmtc.dev/ringcentral/apis/ringcentral-api.md) - [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringcentral/apis/ringcentral-api/revisions/8d602198ec97?raw)