---
title: "Execute conversation action"
method: PUT
path: "/v2/api/conversations/{contact_number}/action"
tags: ["Conversations"]
---

# Execute conversation action

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

Execute an action on a conversation.

## Path parameters

- `contact_number` string, required

## Request body

- object
  - `action` 'READ' | 'UNREAD' | 'ARCHIVE' | 'UNARCHIVE', required — The action to execute.
  - `allo_number` string — Scope the action to a specific Allo number (E.164). Without this, the action applies across all lines.

## Response `200`

Action executed successfully

## Other responses

- `401` — Invalid or missing API key
- `404` — Resource not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) · [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withallo/allo-api/revisions/9aab4db82933/schema)