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

# Return a native conversation to AI

> Requires the owning active claim; appends the operator release event and resumes AI…

Requires the owning active claim; appends the operator release event and resumes AI. Requires WIDGET\_LIVE\_CHAT\_ENABLED=true, an admin bearer key and verified thread ownership. Responses use Cache-Control: no-store. Mutations share the customer/AI thread execution lease. Limited to 120 requests/minute per credential (shared with Redis when configured).

### Path parameters

**id** `string` *required*

Native conversation ID

### Request body

No request body.

### Response

`object`

**thread** `LiveChatSummary`

**LiveChatSummary**

**id** `string`

**subject** `string`

**updatedAt** `string (date-time)`

**customer** `string`

**messageCount** `integer`

**preview** `string`

**liveChat** `LiveChatState`

**LiveChatState**

**status** `string`

Allowed values: `'ai'`, `'active'`, `'resolved'`.

**operatorId** `string`

**operatorName** `string`

**leaseExpiresAt** `string (date-time)`

**canReply** `boolean`

**noteCount** `integer`

**lastCustomerMessageId** `string,null`

**lastCustomerMessageAt** `string,null`

**awaitingReply** `boolean`

**waitingSince** `string,null (date-time)`

### Status codes

| Code | Meaning |
| - | - |
| `200` | Persisted result |
| `401` | Missing or invalid admin key |
| `404` | Thread not found in the authenticated organization |
| `409` | Claim, content-ID, note-limit or thread lease conflict |
| `429` | Rate limit exceeded |
| `503` | Live chat disabled or persistence unavailable |

### Using this contract

Read the [source OpenAPI document](https://docs.stateset.com/spec/chat-widget.json) for declared schemas and alternatives.
This page also includes documented corrections from the [spec overlays](https://github.com/stateset/docs/tree/main/spec/overlays).
Example IDs and values are illustrative; replace them with records from your workspace.

```bash cURL theme={null}
curl --silent --show-error --fail-with-body --request POST \
  --url 'https://api.example.com/api/admin/live-chat/{id}/release' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

```json 200 theme={null}
{
  "thread": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "subject": "Replacement tent pole set",
    "updatedAt": "2026-08-31T14:22:05Z",
    "customer": "string",
    "messageCount": 1,
    "preview": "string",
    "liveChat": {
      "status": "ai",
      "operatorId": "string",
      "operatorName": "string",
      "leaseExpiresAt": "2026-08-31T14:22:05Z"
    },
    "canReply": true,
    "noteCount": 1,
    "lastCustomerMessageId": "string",
    "lastCustomerMessageAt": "string",
    "awaitingReply": true,
    "waitingSince": "2026-08-31T14:22:05Z"
  }
}
```


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