Skip to main content
POST
/
v1
/
prior-authorizations
/
{authorization_id}
/
live-session
/
access-grants
Create a live-session grant
curl --request POST \
  --url https://api.sandbox.trycollate.ai/v1/prior-authorizations/{authorization_id}/live-session/access-grants \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: <idempotency-key>'
{
  "id": "<string>",
  "url": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.trycollate.ai/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to mint a short-lived read-only URL for embedding or opening the current payer-channel session. GET /live-session is side-effect-free; it does not mint bearer capabilities. The grant is scoped to the current prior authorization and live session. Opening the grant URL validates and audits the grant, then redirects to the runtime provider’s read-only live view. Interactive access is not available here; create a manual handoff before minting an interactive handoff grant.

​
Returns

Returns a LiveSessionAccessGrant.

Authorizations

​
Authorization
string
header
default:your-api-key
required

API key passed as Authorization: Bearer <API_KEY>.

Headers

​
Idempotency-Key
string
required

Unique key used to retry command requests safely. Reusing the same key with a different request body returns 409 idempotency_key_reused.

Path Parameters

​
authorization_id
string
required

Authorization ID returned by POST /v1/prior-authorizations.

Response

Successful Response

​
id
string
required
​
url
string
required
​
expiresAt
string<date-time>
required