Realtime

realtime_tokens_create

Mint a short-lived capability token (JWT) carrying the capabilities the identity has via namespace policy and grants (optionally filtered to the given channels), plus the gateway WebSocket URL to connect to

Tool

realtime_tokens_create

Behavior

HTTP: POST /realtime/tokens

Arguments

Name	Type	Required	Description
channels	array	—	Concrete channels to filter the resolved capabilities to; omit to receive all capabilities the identity has

Response

Field	Type	Always	Description
token	string	•	Signed EdDSA capability JWT (60s TTL)
gatewayUrl	string	•	WebSocket URL of the realtime gateway to connect to

Try it

Mint a short-lived capability token (JWT) carrying the capabilities the identity has via namespace policy and grants (optionally filtered to the given channels), plus the gateway WebSocket URL to connect to.

When to use

Example

Ask your agent something like this:

Mint a short-lived capability token (JWT) carrying the capabilities the identity has via namespace policy and grants (optionally filtered to the given channels), plus the gateway WebSocket URL to connect to.

The agent will invoke realtime_tokens_create with these arguments:

{}