# Agenten-Authentifizierung: config

Kanonische URL: https://sosoapi.ai/de/docs/api/identity-api-agent-auth-config

Vertrag: sha256:563d2d581da0ad29

Lies die Agenten-Anmeldekonfiguration einschließlich festem Loopback-Callback. Nutze zur Anmeldung eine unterstützte CLI oder einen Remote-OAuth-Client; dieser Endpunkt dokumentiert das Protokoll.

POST /identity-api/agent-auth/config

## Authentifizierung und Berechtigungen

- **Akzeptierte Zugangsdatenklassen:** anonymous

- **Delegierte Funktion:** oauth-bootstrap

- **Minimale Workspace-Rolle:** Dieser Vertrag schreibt keine Mindestrolle vor; Eigentums- und Berechtigungsprüfungen gelten weiterhin.

- **Zugriffsumfang:** Ressourcen, auf die dieser Nutzer zugreifen darf

- **Zustimmung für alle Workspaces erforderlich:** Nein

- **Ändert Zustand:** Nein

- **Nach Abschluss der Operation:** not_agent_callable

Ein Token nutzt nur Eigentümerrechte. Jede Anfrage prüft Workspace-Mitgliedschaft, Ressourceneigentum, gewählte Workspaces und Funktionen. core und full ändern sichtbare Tools; sie erteilen keinen Zugriff.

Dieser Endpunkt gehört zum Anmeldeprotokoll und ist nicht über api post verfügbar. Nutze den unterstützten Browser-Anmeldeablauf und halte Sitzungszugangsdaten aus Ausgaben und Logs heraus.

## Anfragefelder

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## Antwort und Abschluss

HTTP-Erfolgsstatus: 200

Eine erfolgreiche HTTP-Antwort kann Annahme statt Abschluss bedeuten. Speichere bei Hintergrundarbeit die ID und prüfe dieselbe Operation bis zum Abschluss. Geplante oder angenommene Beiträge gelten erst nach Plattformbestätigung als veröffentlicht; ein Client-Timeout klärt das Ergebnis nicht.

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "client_id": {
      "type": "string",
      "minLength": 1
    },
    "client_name": {
      "type": "string",
      "minLength": 1
    },
    "redirect_uri": {
      "type": "string",
      "const": "http://127.0.0.1:8789/oauth/callback"
    },
    "authorization_endpoint": {
      "type": "string",
      "format": "uri"
    },
    "token_endpoint": {
      "type": "string",
      "format": "uri"
    },
    "scopes": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "client_id",
    "client_name",
    "redirect_uri",
    "authorization_endpoint",
    "token_endpoint",
    "scopes"
  ]
}
```

## Fehler und sichere Wiederholungen

Prüfe HTTP-Status und Antwortinhalt. Ein 400-Validierungsfehler kann einen ZodError enthalten; Handler-Fehler verwenden die Felder error, message und code. Bewahre request_id oder x-request-id zur Diagnose ohne Zugangsdaten auf. Behebe 401/403-Zugriffsfehler vor einem erneuten Versuch und beachte Retry-After bei 429. Ist ein Schreibvorgang ungewiss oder liefert 5xx, lies zuerst das bestehende Ergebnis. Verwende einen Idempotenzschlüssel nur wieder, wo dies unterstützt wird; Wiederholungen unterscheiden sich je nach Operation und garantieren keine genau einmalige Zustellung.

## Beispiele

Diese Beispiele nutzen anhand der Schemas geprüfte fiktive Werte. Ersetze IDs durch autorisierte IDs, Medien durch bereite Assets und Daten durch bestätigte Veröffentlichungszeiten. Prüfe Kontoeignung vor Schreibvorgängen. Diese Seite sendet keine API-Anfragen.

request.json

```json
{}
```

cURL

```bash
curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/agent-auth/config" \
  -H "Content-Type: application/json" \
  --data-binary @request.json
```

JavaScript

```js
// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/agent-auth/config", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.
```

Synthetisches Antwortbeispiel

```json
{
  "client_id": "example",
  "client_name": "example",
  "redirect_uri": "http://127.0.0.1:8789/oauth/callback",
  "authorization_endpoint": "https://example.com/media.png",
  "token_endpoint": "https://example.com/media.png",
  "scopes": "example"
}
```

## Verwandte Tools und Anleitungen

[API-Referenz](https://sosoapi.ai/de/docs/api)