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

# Actualizar estado masivo

> Actualizar el estado de múltiples conversaciones a la vez.

## Endpoint

```
POST /api/conversations/update-status
```

Actualizá el estado de múltiples conversaciones a la vez, opcionalmente filtradas por canal o agente.

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token con tu API key de organización.
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Siempre `application/json`
</ParamField>

## Query Parameters

<ParamField query="channel" type="string">
  Filtrar por canal. Solo actualiza conversaciones de este canal.
</ParamField>

<ParamField query="agentId" type="string">
  Filtrar por agente. Solo actualiza conversaciones de este agente.
</ParamField>

## Request Body

<ParamField body="status" type="string" required>
  Nuevo estado para las conversaciones. Valores: `UNRESOLVED`, `RESOLVED`, `HUMAN_REQUESTED`
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  # Marcar todas las conversaciones como resueltas
  curl -X POST "https://app.horneross.com/api/conversations/update-status" \
    -H "Authorization: Bearer sk_live_xxx" \
    -H "Content-Type: application/json" \
    -d '{
      "status": "RESOLVED"
    }'

  # Marcar solo conversaciones de WhatsApp como resueltas
  curl -X POST "https://app.horneross.com/api/conversations/update-status?channel=whatsapp" \
    -H "Authorization: Bearer sk_live_xxx" \
    -H "Content-Type: application/json" \
    -d '{
      "status": "RESOLVED"
    }'
  ```

  ```javascript JavaScript theme={null}
  async function bulkUpdateStatus(status, options = {}) {
    const params = new URLSearchParams(options);
    const url = params.toString()
      ? `https://app.horneross.com/api/conversations/update-status?${params}`
      : 'https://app.horneross.com/api/conversations/update-status';

    const response = await fetch(url, {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer sk_live_xxx',
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ status }),
    });
    return response.json();
  }

  // Marcar todas como resueltas
  const result = await bulkUpdateStatus('RESOLVED');
  console.log(`Updated ${result.count} conversations`);

  // Solo de un agente específico
  await bulkUpdateStatus('RESOLVED', { agentId: 'ag_xyz789' });
  ```

  ```python Python theme={null}
  import requests

  def bulk_update_status(status, channel=None, agent_id=None):
      params = {}
      if channel:
          params['channel'] = channel
      if agent_id:
          params['agentId'] = agent_id

      response = requests.post(
          'https://app.horneross.com/api/conversations/update-status',
          headers={
              'Authorization': 'Bearer sk_live_xxx',
              'Content-Type': 'application/json'
          },
          params=params,
          json={'status': status}
      )
      return response.json()

  # Marcar todas como resueltas
  result = bulk_update_status('RESOLVED')
  print(f"Updated {result['count']} conversations")

  # Solo de WhatsApp
  result = bulk_update_status('RESOLVED', channel='whatsapp')
  ```
</RequestExample>

## Response

<ResponseField name="count" type="number" required>
  Número de conversaciones actualizadas
</ResponseField>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "count": 42
  }
  ```
</ResponseExample>

## Estados disponibles

| Estado            | Descripción                              |
| ----------------- | ---------------------------------------- |
| `UNRESOLVED`      | Conversación activa, esperando respuesta |
| `RESOLVED`        | Marcada como resuelta                    |
| `HUMAN_REQUESTED` | El usuario solicitó hablar con un humano |