Zum Hauptinhalt springen
POST
Delegation anbieten
Erstellt ein mandantenübergreifendes Vertrauensdelegationsangebot. Vertrauensdelegationen ermöglichen es Agenten in einem Mandanten, Agenten in einem anderen Mandanten spezifische, bereichsbezogene Berechtigungen zu erteilen – was sichere KI-Workflows über mehrere Organisationen hinweg ohne gemeinsame Anmeldeinformationen ermöglicht. Delegationsangebote sind zeitlich begrenzt und auf den Geltungsbereich beschränkt. Der Zielmandant muss das Angebot explizit annehmen, bevor die Delegation aktiv wird. Alle Lebenszyklusereignisse der Delegation werden im Transparenzprotokoll aufgezeichnet.

Delegationsbeschränkungen

Mandantenübergreifende Delegationen sind ein privilegierter Vorgang. Der anbietende Agent muss die Berechtigung delegations:offer haben und der Ziel-Tenant muss sich in der Liste der vertrauenswürdigen Partner des anbietenden Mandanten.

Antwort

string
Eindeutiger Delegationsangebot-Identifikator.
string
Delegationsstatus. Immer offered bei der Erstellung.
string
Der Agent, der das Angebot erstellt hat.
string
Mandant des anbietenden Agenten.
string
Zielmandant, der das Angebot annehmen kann.
string[]
Delegierte Berechtigungsbereiche.
integer
Maximale Re-Delegationstiefe.
string
ISO 8601 Zeitstempel, wann das Angebot abläuft, wenn es nicht angenommen wird.
string
ISO 8601 Zeitstempel der Erstellung.

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Body

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

Antwort

Delegation angeboten

delegation_id
string<uuid>
from_agent_id
string<uuid>
to_agent_id
string<uuid>
scopes
string[]
ttl_seconds
integer
conditions
object
status
enum<string>
Verfügbare Optionen:
offered,
active,
expired,
revoked
token
string

Delegationsannahme-Token (bei Angebot zurückgegeben)

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