Skip to main content

Cross-Tenant Delegation

Cross-tenant delegation allows an agent owned by one organization to perform actions within another organization’s Truthlocks tenant — with full audit trails and revocable authorization.

Use Cases

  • Managed service providers operating agents on behalf of clients
  • Supply chain partners sharing verification data across organizations
  • Platform integrators running agents that span multiple customer tenants
  • Consulting firms performing compliance checks across client environments
Delegation endpoints have an interactive API playground. Open the Guardrails & Delegation API reference and click Send to try it against the Sandbox.

How it works

Delegation Flow

Step 1: Offer Delegation

Response:

Step 2: Accept Delegation

Response:

Step 3: Execute Cross-Tenant Actions

Security Model

Constraints

Audit Trail

All cross-tenant actions generate dual audit entries — one in each tenant’s audit log:

Revocation

Either party can revoke a delegation at any time:
Revocation is immediate — all in-flight requests using the delegated token are rejected.

Best Practices

  1. Time-bound all delegations — Never create open-ended delegations
  2. Minimum viable scopes — Only delegate the scopes actually needed
  3. Trust score requirements — Set require_trust_score_above to at least 70
  4. IP restrictions — Always use ip_allowlist for production delegations
  5. Monitor delegation activity — Set up webhooks for delegation.* events
  6. Regular review — Audit active delegations quarterly

Next steps

Agent Authorization

Scope-based authorization and session management.

AI Orchestration

Multi-agent workflow execution with delegation support.