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

# Get conversation state

> Inspect the active agent turn, queued prompts, and conversation recovery state.

## Authentication

Send your scoped bearer token in the `Authorization: Bearer <BEAD_TOKEN>` header, or send your API key in `X-API-Key`.

## Parameters

**id** `string` *required*

Machine identifier returned by creation.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
curl --request GET \
  --url "https://api.bead.run/sandboxes/$SANDBOX_ID/conversation" \
  --header "X-API-Key: $BEAD_API_KEY"
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
# sandbox is returned by Sandbox.create or Sandbox.connect.
print(sandbox.agent.status())
```

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
// sandbox is returned by Sandbox.create or Sandbox.connect.
console.log(await sandbox.agent.status());
```

## Response

### 200

Conversation queue and recovery state.

**activeTurnId** `string | null` *required*

UUID of the active prompt, or null while idle. May be `null`.

**queued** `integer` *required*

Number of accepted prompts waiting to run.

**threadId** `string | null` *required*

Native conversation thread identifier. May be `null`.

**credentialUsage** `object | null` *required*

Credential pool request counters, when configured. May be `null`.

**Properties**

**component** `string` *required*

Credential routing component name.

**version** `string` *required*

Credential routing component version.

**pid** `integer` *required*

Process identifier of the active credential router.

**credentials** `object[]` *required*

Requests counted per credential.

**Properties**

**credentialId** `string` *required*

Credential identifier.

**requests** `integer` *required*

Requests observed for this credential.

**recoveryRequired** `boolean` *required*

Whether you must recover the conversation before sending another prompt.

## Errors

| Status | Meaning |
| - | - |
| 401 | Authentication credential is missing or rejected. |
| 403 | The credential lacks the required scope. |
| 404 | The requested resource does not exist or is outside your organization. |
| 409 | The machine must be resumed, a conversation binding changed, or a request UUID was reused for different prompt content. |
| 410 | Execution memory was lost (`machine_lost`). |
| 429 | Request or resource admission limit exceeded (`admission_limit`). Follow limit.next\_action and Retry-After when present. |
| 502 | The runner returned an invalid response. |
| 503 | Machine wake or native agent recovery is required, or the runner is unavailable. |


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