Close a realtime session

DELETE

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

const url = 'https://api.inside.chat/api/v1/realtime/sessions/example';
const options = {
  method: 'DELETE',
  headers: {Origin: 'example', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://api.inside.chat/api/v1/realtime/sessions/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Origin: example'

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

Close this app session and release its capacity. No body.

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.

Responses

204

Session closed.

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.