Zum Hauptinhalt springen
POST
Dismiss a usage request
Liste Nutzungslimit-Anfragen von Mitgliedern, lies eine Anfrage und lehne eine Anfrage ab, die noch offen ist. Es gibt keinen Webhook. Frage die Liste regelmäßig ab. Um eine Anfrage zu genehmigen, erhöhst du den Plan oder das Extra-Usage-Budget dieses Mitglieds und übergibst usageRequestId an diesem Schreibzugriff. Siehe Billing-Nutzer. Die Aufrufe laufen über den BILLING_API Scope des Workspace-API-Schlüssels. Die Ablehnung läuft als der Service Account, dem der Schlüssel gehört.

Basis-URL

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.

Voraussetzungen

  • API-Schlüssel mit dem Scope BILLING_API
  • Der Besitzer ist ein Service Account, der nicht gelöscht ist und eine aktive Admin-Mitgliedschaft hat
  • USER_MANAGEMENT_API am selben Schlüssel, wenn du email oder name brauchst

Eine Anfrage ablehnen

POST /usage-requests/{requestId}/dismiss hat keinen Body. Die Antwort ist die Anfrage mit status dismissed und resolution dismissed. Eine Anfrage, die nicht mehr offen ist, gibt 409 mit code USAGE_REQUEST_NOT_PENDING zurück. Der aktuelle Status steht in details.status. Es ändert sich nichts. Eine Ablehnung und ein benannter Schreibzugriff auf Plan oder Budget für dieselbe Anfrage können nicht beide gelingen. Der Aufruf, der verliert, gibt 409 zurück und ändert nichts.
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Pfadparameter

requestId
string<uuid>
erforderlich

Antwort

The dismissed request.

id
string<uuid>
erforderlich
userId
string<uuid>
erforderlich
status
enum<string>
erforderlich
Verfügbare Optionen:
pending,
resolved,
dismissed
createdAt
string<date-time>
erforderlich
resolvedAt
string<date-time> | null
erforderlich
resolution
enum<string> | null
erforderlich

How the request was answered; null while pending.

Verfügbare Optionen:
increased_limit,
upgraded_plan,
dismissed,
null
resolvedByUserId
string<uuid> | null
erforderlich

Admin or service account that answered the request.

email
string<email>

Present only when the key also has the USER_MANAGEMENT_API scope.

name
string | null

Present only when the key also has the USER_MANAGEMENT_API scope.