Issue a reconnect ticket

POST

/api/v1/realtime/sessions/{session_id}/tickets

curl --request POST \
  --url https://api.inside.chat/api/v1/realtime/sessions/example/tickets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Origin: example' \
  --data '{}'

• Hosted Gateway
• Local development

Required scopes: website_read, event_read
Data access: –
MCP tool: not available over MCP
Note: Write
Note: Origin required

Replace the unused ticket using the exact original credential/grant and Origin. A valid reconnect replaces the prior authenticated socket epoch.

Authorizations

• installation_token
• oauth_client_credentials
  website_read event_read

Parameters

Path Parameters

session_id

required

string

/^app_[a-f0-9]{64}_[a-f0-9]{32}$/

Header Parameters

Origin

required

string

<= 2048 characters

Exact canonical HTTPS origin bound to this session. Local loopback HTTP is allowed only in the local environment. Browser REST CORS is restricted to configured UI origins.

Request Body^required

Media typeapplication/json

object

Example ^generated

{}

Responses

200

Origin-bound single-use ticket. Authenticate the socket first frame within 5s. Idle reconnect window 2min, authority recheck 15s.

Media typeapplication/json

object

session_id

required

string

/^app_[a-f0-9]{64}_[a-f0-9]{32}$/

ticket

required

Single-use first-frame secret. Never put it in the URL or logs.

string

/^[A-Za-z0-9_-]{43}$/

expires_at

required

Unix seconds; at most 30s and never after the original credential deadline.

integer

>= 1

Example ^generated

{
  "session_id": "example",
  "ticket": "example",
  "expires_at": 1
}

400

Closed request body or parameters are invalid.

401

Original REST credential or current authority is invalid.

403

Origin rejected.

404

Session is absent or not owned by the same exact credential/grant and origin.

409

Installation session or pending socket capacity reached.

429

App/ingress quota exceeded; observe Retry-After.

503

Required service/authority/storage is unavailable.