Skip to main content
POST
Offer Delegation
Creates a cross-tenant trust delegation offer. Trust delegations allow agents in one tenant to grant specific, scoped permissions to agents in another tenant — enabling secure multi-organization AI workflows without sharing credentials. Delegation offers are time-limited and scope-restricted. The target tenant must explicitly accept the offer before the delegation becomes active. All delegation lifecycle events are recorded in the transparency log.

Delegation Constraints

Cross-tenant delegations are a privileged operation. The offering agent must have the delegations:offer permission and the target tenant must be in the offering tenant’s trusted partners list.

Response

string
Unique delegation offer identifier.
string
Delegation status. Always offered on creation.
string
The agent that created the offer.
string
Tenant of the offering agent.
string
Target tenant that may accept the offer.
string[]
Delegated permission scopes.
integer
Maximum re-delegation depth.
string
ISO 8601 timestamp when the offer expires if not accepted.
string
ISO 8601 timestamp of creation.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
accepting_tenant_id
string
required
offered_by_agent_id
string
required
allowed_scopes
string[]
max_delegation_depth
integer
metadata
any
ttl_hours
integer

Response

Delegation offered

delegation_id
string<uuid>
from_agent_id
string<uuid>
to_agent_id
string<uuid>
scopes
string[]
ttl_seconds
integer
conditions
object
status
enum<string>
Available options:
offered,
active,
expired,
revoked
token
string

Delegation acceptance token (returned on offer)

created_at
string<date-time>
expires_at
string<date-time>