# Clear a user's status bubble

`POST /user.statusBubble.clear`

## Description

Clears the shared thought bubble, including a bubble written by the UI or another integration. Repeating clear is a successful no-op. This does not clear Will Return or external activities.

See [Status bubbles](/docs/guides/user-status-bubble).

**Access:** Organization and Personal. Organization credentials may target an active user in the workspace. Personal OAuth and PATs may target only their owner. The workspace comes from the token.

**Required scope:** `user:write.statusBubble`. PATs skip the scope check; personal OAuth requires the scope.

---

**OpenAPI Spec:** [chat-v1.json](https://developer.ro.am/chat-v1.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Request Body

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `userId` | string | Yes | Bare UUID, tagged U-… ID, or ASCII email of the target user. |

### Example Request

```json
{
  "userId": "ada@example.com"
}
```

## Responses

### 204 - Cleared, including if already empty or expired.

### 400 - Missing or invalid input. See the guide for stable error codes.

### 401 - Invalid authentication credentials.

### 403 - Missing scope or personal token targeting someone else.

### 404 - Unknown, archived, or cross-account user.

### 405 - Unsupported method.

### 500 - Internal error.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/api/user-status-bubble-clear*