---
title: "PATCH /connections/{phoneNumber}/presence"
method: PATCH
path: "/connections/{phoneNumber}/presence"
tags: ["Connections"]
---

# PATCH /connections/{phoneNumber}/presence

`PATCH /connections/{phoneNumber}/presence`

## Path parameters

- `phoneNumber` string, required

## Request body

- object
  - `type` 'unavailable' | 'available' | 'composing' | 'recording' | 'paused', required — Presence type. `available` is automatically reset to `unavailable` after 60s. `composing` and `recording` are automatically held for ~25s by WhatsApp. `paused` can be used to reset `composing` and `recording` early.
  - `toJid` string — WhatsApp JID [Required for `composing`, `recording`, and `paused`]

## Response `200`

Presence update sent successfully

## Other responses

- `403` — Forbidden — the API key does not own this connection. Returned when a connection is bound to a different API key.
- `421` — Misdirected Request — in cluster mode, this instance does not own the connection. The owning instance id is in the x-baileys-owner header; a proxy re-routes the request there. Not returned for the explicit-takeover routes: POST /connections/{phoneNumber}, /import-session and /restart.

---

[API](https://skmtc.net/fazer-ai/apis/fazer-ai-baileys-api.md) · [All operations](https://skmtc.net/fazer-ai/apis/fazer-ai-baileys-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fazer-ai/fazer-ai-baileys-api/revisions/5299037901a9/schema)