Skip to main content
POST
/
v1
/
prior-authorizations
/
{authorization_id}
/
manual-handoffs
/
{handoff_id}
/
access-grants
Create a handoff access grant
curl --request POST \
  --url https://api.sandbox.trycollate.ai/v1/prior-authorizations/{authorization_id}/manual-handoffs/{handoff_id}/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.

Interactive grants require ManualHandoff.state = active. Grant URLs are short-lived bearer capabilities and are not durable authorization truth. Opening the grant URL validates and audits the grant, then redirects to the active runtime provider session.

​
Returns

Returns a ManualHandoffAccessGrant.

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.

​
handoff_id
string
required

Manual handoff ID returned by POST /manual-handoffs.

Response

Successful Response

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