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

# Take Over Session

> Hand a live widget conversation to a human operator and suppress AI replies.

Marks the session as human-driven so the widget stops generating AI replies. Idempotent — repeated calls just refresh the takeover timestamp. Hand control back with [Release](/api-reference/iframes/release).

## Authentication

Requires a Bearer token (API key) or a dashboard session.

## Path Parameters

<ParamField path="id" type="string" required>
  The widget config UUID.
</ParamField>

<ParamField path="sessionId" type="string" required>
  The session UUID.
</ParamField>

## Response

<ResponseField name="session_id" type="string" />

<ResponseField name="takeover_status" type="string">
  `"human"` after a successful takeover.
</ResponseField>

<ResponseField name="taken_over_by" type="string">
  The operator user ID.
</ResponseField>

<ResponseField name="taken_over_at" type="string">
  ISO timestamp of the takeover.
</ResponseField>

## Example

```bash curl theme={null}
curl -X POST https://www.hitheo.ai/api/v1/iframes/CONFIG_ID/conversations/SESSION_ID/takeover \
  -H "Authorization: Bearer $THEO_API_KEY"
```