Release Session - Theo API Docs

POST

api

iframes

{id}

conversations

{sessionId}

release

Release Session

curl --request POST \
  --url https://api.example.com/api/v1/iframes/{id}/conversations/{sessionId}/release

{
  "session_id": "<string>",
  "takeover_status": "<string>"
}

Clears the takeover flags so the next turn runs the AI orchestrator again.

Authentication

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

string

required

The widget config UUID.

sessionId

string

required

The session UUID.

session_id

string

takeover_status

string

"ai" after release.

curl

curl -X POST https://www.hitheo.ai/api/v1/iframes/CONFIG_ID/conversations/SESSION_ID/release \
  -H "Authorization: Bearer $THEO_API_KEY"

⌘I

Release Session

curl --request POST \
  --url https://api.example.com/api/v1/iframes/{id}/conversations/{sessionId}/release

{
  "session_id": "<string>",
  "takeover_status": "<string>"
}