# Execute conversation action

> Execute an action on a conversation.

`PUT /v2/api/conversations/{contact_number}/action`

<Note>
**Required scope:** `CONVERSATIONS_WRITE`
</Note>

## Available actions

| Action | Effect |
|--------|--------|
| `READ` | Mark the conversation as read |
| `UNREAD` | Mark the conversation as unread |
| `ARCHIVE` | Archive the conversation and mark all items as read |
| `UNARCHIVE` | Unarchive the conversation |

Passing an unsupported action returns a `400` error with code `INVALID_ACTION`.

## Idempotency

All actions are **idempotent** — calling `READ` on an already-read conversation is a no-op and returns `200`.

This endpoint also supports the `Idempotency-Key` header. See [Idempotency](/docs/guides/error-handling#idempotency).

## Scoping to a line

Omit `allo_number` to apply the action across all Allo numbers. Provide it to scope the action to a specific line.
