> ## 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.

# Renew a native operator claim

> Only the owning operator key can extend an active claim for another two minutes. The terminal renews every 30 seconds…

Only the owning operator key can extend an active claim for another two minutes. The terminal renews every 30 seconds. 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}/heartbeat' \
  --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.