Zum Hauptinhalt springen
POST
Agentengenehmigung anfordern
Zeichnet eine Anfrage für eine unabhängige menschliche Überprüfung auf. Führt keine Agentenaktion aus, gewährt keine Berechtigungen oder pausiert oder setzt einen Temporal-Workflow nicht automatisch fort. Die Autorisierungs- und Ausführungsgrenzen finden Sie unter unabhängige Agentenprüfungen.

Autorisierungen

X-API-Key
string
header
erforderlich

Body

application/json
agent_id
string
erforderlich

Ein aktiver, nicht kompromittierter Agent in dieser authentifizierten Arbeitsbereichsumgebung.

action
string
erforderlich

Die beabsichtigte Aktion; 1–200 UTF-8 Bytes. Das Erstellen einer Anfrage führt sie nicht aus.

resource
string
erforderlich

Spezifische Zielressource; 1–2000 UTF-8 Bytes.

scope
string
erforderlich

Beabsichtigte Berechtigung; 1–200 UTF-8 Bytes. Gewährt keinen Zugriff.

justification
string

Belege und Zweck; höchstens 4000 UTF-8-Bytes. Niemals Geheimnisse einschließen.

risk_level
enum<string>
Standard:medium
Verfügbare Optionen:
low,
medium,
high,
critical
required_approvals
integer
Standard:1

Unterschiedliche autorisierte menschliche Prüfer; Anfragender ausgeschlossen.

Erforderlicher Bereich: 1 <= x <= 10
ttl_minutes
integer
Standard:60
Erforderlicher Bereich: 1 <= x <= 10080

Antwort

Aufgezeichnetes Ergebnis

id
string<uuid>
erforderlich
agent_id
string
erforderlich
requested_by
string
erforderlich

Authentifizierter Anforderer: menschliche Benutzer-UUID oder api_key:; niemals ein vom Aufrufer bereitgestellter Prüfer.

status
enum<string>
erforderlich
Verfügbare Optionen:
pending,
approved,
rejected,
expired,
cancelled
expires_at
string<date-time>
erforderlich
required_approvals
integer
erforderlich
Erforderlicher Bereich: 1 <= x <= 10
current_approvals
integer
erforderlich
Erforderlicher Bereich: 0 <= x <= 10
decisions
object[]
erforderlich

Unveränderliche Einzelbewertungen. Die Warteschlangenantwort lässt dies leer; rufen Sie die Anfrage für ihre vollständige Überprüfungshistorie ab.

tenant_id
string<uuid>
action
string
resource
string
scope
string
justification
string
decision_reason
string
risk_level
enum<string>
Verfügbare Optionen:
low,
medium,
high,
critical
created_at
string<date-time>
updated_at
string<date-time>
decided_at
string<date-time>
decided_by
string

Letzter Prüfer oder Anforderer, der die Anfrage storniert; fehlt, während sie aussteht.