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

# Get status

> Consulta el estado de un proceso de chat

Consulta el estado de un proceso de chat. Es útil para comprobar si un chat ha terminado de procesarse sin necesidad de mantener una conexión en streaming.

## Solicitud

```
GET /api/chat/{chatId}/status
```

### Encabezados

| Encabezado | Obligatorio | Descripción |
| - | - | - |
| `Authorization` | Sí | `Bearer macaly_...` |

### Parámetros de ruta

| Parámetro | Tipo | Descripción |
| - | - | - |
| `chatId` | string | El ID del chat devuelto por `POST /api/chat` |

### Solicitud de ejemplo

<CodeGroup>
  ```bash cURL theme={null}
  curl https://www.macaly.com/api/chat/abc123/status \
    -H "Authorization: Bearer macaly_abc123..."
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    `https://www.macaly.com/api/chat/${chatId}/status`,
    {
      headers: {
        'Authorization': 'Bearer macaly_abc123...',
      },
    }
  );

  const data = await response.json();
  console.log(data.status);
  ```

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

  response = requests.get(
      f'https://www.macaly.com/api/chat/{chat_id}/status',
      headers={
          'Authorization': 'Bearer macaly_abc123...',
      },
  )

  data = response.json()
  print(data['status'])
  ```
</CodeGroup>

## Respuesta

```json theme={null}
{
  "chatId": "abc123",
  "url": "https://www.macaly.com/chat/abc123",
  "status": "completed",
  "result": {
    "content": "Here's what I built for you..."
  }
}
```

### Campos de respuesta

| Campo | Tipo | Descripción |
| - | - | - |
| `chatId` | string | El ID del chat |
| `url` | string | URL para ver el chat en el navegador |
| `status` | string | Estado actual del proceso (ver a continuación) |
| `result.content` | string | Mensaje final del asistente (solo cuando es `completed`) |
| `error.message` | string | Descripción del error (solo cuando es `failed`) |

### Valores de estado

| Estado | Descripción |
| - | - |
| `running` | El proceso se está ejecutando |
| `completed` | Finalizado correctamente |
| `failed` | Se ha producido un error |
| `cancelled` | El proceso se canceló manualmente |
| `no_active_workflow` | No hay ningún proceso activo para este chat |

## Códigos de estado

| Código | Descripción |
| - | - |
| 200 | Correcto |
| 401 | Clave API no válida o ausente |
| 403 | El chat no pertenece a tu equipo |
| 404 | Chat no encontrado |

## Patrón de sondeo

```bash theme={null}
while true; do
  STATUS=$(curl -s https://www.macaly.com/api/chat/$CHAT_ID/status \
    -H "Authorization: Bearer macaly_...")

  echo "Status: $(echo $STATUS | jq -r .status)"

  if echo "$STATUS" | grep -q '"status":"completed"'; then
    echo "Done!"
    break
  fi

  sleep 2
done
```

## Siguientes pasos

Cuando el estado sea `completed`, puedes:

1. **Desplegar la app** con [`POST /api/chat/{chatId}/deploy`](/docs/es/api/deploy)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.