Refresh token for conversation

Generates a new ephemeral token for the specified conversation, extending the session lifetime. The old token will become invalid immediately after this operation completes.

POST /conversations/{conversation_id}/token/refresh

Refresh token for conversation

cURL

curl --request POST \
  --url https://api.operator.xyz/conversations/{conversation_id}/token/refresh \
  --header 'Authorization: Bearer <token>' \
  --header 'Operator-Version: <operator-version>'

200

{
  "token": "<string>",
  "expires_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Operator-Version · enum<string> · required

The API version to use.

Available options: 2025-06-19

Path Parameters

conversation_id · string · required

Unique identifier for the conversation, e.g. conv_8qm9JBCiTe7.

Response

200

application/json

Successful response.

token · string · required

New ephemeral token for the conversation session.

expires_at · string<date-time> · required

UTC timestamp when the token expires.