> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatsyncs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mark Conversation Status

> Mark a subscriber's conversation as resolved, reopened, archived, unarchived, blocked, or unblocked via the ChatSyncs API. Use when a developer asks how to close out or reopen a conversation programmatically, e.g. from a CRM or support-ticket workflow.

Marks a subscriber's conversation with one of six statuses — mirrors the same actions available
manually from the [Shared Inbox](/learn/chatsyncs-shared-inbox/organize-conversations-with-labels-views-search-in-chatsyncs) conversation menu.

## The `action_status` encoding

Other endpoints that return a conversation's status (e.g. fetching a subscriber's chat) encode
it numerically as `action_status`:

| `action_status` | Meaning                                             |
| --------------- | --------------------------------------------------- |
| `0`             | Open — after `reopen`, `unarchived`, or `unblocked` |
| `1`             | Resolved                                            |
| `2`             | Archived                                            |
| `3`             | Blocked                                             |

<Tip>
  **Where to find `phone_number_id`:** open **Chatbot Manager**, select your bot, and the phone
  number is shown at the top. See
  [Finding Your IDs & API Token](/developer-api/finding-ids#phone-number-id-phone_number_id) for a
  screenshot.
</Tip>


## OpenAPI

````yaml POST /whatsapp/subscriber/chat/mark-conversation
openapi: 3.1.0
info:
  title: ChatSyncs Developer API
  version: 1.0.0
  description: >-
    REST API for sending WhatsApp messages and managing subscribers through
    ChatSyncs.
servers:
  - url: https://platform.chatsyncs.com/api/v1
security: []
paths:
  /whatsapp/subscriber/chat/mark-conversation:
    post:
      tags:
        - Subscriber API
      summary: Mark Conversation Status
      operationId: markConversationStatus
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                apiToken:
                  type: string
                  description: >-
                    Your ChatSyncs API key (not a WhatsApp/Meta access token).
                    [Where to find
                    it](/developer-api/finding-ids#api-token-apitoken).
                  example: API-KEY
                phone_number_id:
                  type: string
                  description: >-
                    The WhatsApp account's phone number ID. [Where to find
                    it](/developer-api/finding-ids#phone-number-id-phone_number_id).
                  example: PHONE-NUMBER-ID
                phone_number:
                  type: string
                  description: >-
                    The subscriber's phone number, with country code, digits
                    only.
                  example: PHONE-NUMBER
                action:
                  type: string
                  enum:
                    - resolved
                    - reopen
                    - archived
                    - unarchived
                    - blocked
                    - unblocked
                  description: The status to set on this subscriber conversation.
                  example: resolved
              required:
                - apiToken
                - phone_number_id
                - phone_number
                - action
      responses:
        '200':
          description: >-
            Standard ChatSyncs response. `status` is "1" on success and "0" on
            failure.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: '"1" = success, "0" = failure.'
                  message:
                    type: string
                    description: Human-readable result message.
              examples:
                success:
                  summary: Success
                  value:
                    status: '1'
                    message: Conversation marked as resolved successfully
                error:
                  summary: Error
                  value:
                    status: '0'
                    message: Invalid request.

````