Skip to main content
Jeder API-Endpunkt mit Ausnahme von GET /v3/self ist durch eine spezifische Berechtigung geschützt. Ein Service-Benutzer erhält seine Berechtigungen über die ihm zugewiesene Rolle; ein persönliches Zugriffstoken hat die Berechtigungen des Nutzers, der es erstellt hat. Die erforderliche Berechtigung für jeden Endpunkt ist auf seiner jeweiligen API-Referenzseite dokumentiert. Diese Seite bietet eine Zusammenfassung aller Berechtigungen nach Geltungsbereich. Basis-URLs:
  • https://api.devin.ai/v3/organizations/* — Endpunkte mit Geltungsbereich für eine einzelne Organisation
  • https://api.devin.ai/v3/enterprise/* — Endpunkte, die Berechtigungen auf Enterprise-Ebene erfordern
Devin Enterprise-Kunden mit einer dedizierten Bereitstellung sollten api.devin.ai durch ihre eigene API-Domain ersetzen (z. B. api.your-company.devinenterprise.com). Weitere Details zur Einrichtung finden Sie im Enterprise-Schnellstart.
Ihre Organisations-ID finden Sie oben auf der Seite Settings → Devin API.
Einige Enterprise-Endpunkte beziehen sich auf bestimmte Organisationen und verwenden Pfade wie /v3/enterprise/organizations/{org_id}/... (zum Beispiel Audit-Logs und Tags). Auch wenn sie einen org_id-Parameter enthalten, erfordern sie Berechtigungen auf Enterprise-Ebene.

​
Enterprise-Berechtigungen

​
Organisationsberechtigungen

​
Vererbung von Berechtigungen

Enterprise-Servicebenutzer authentifizieren sich an /v3/enterprise/*-Endpunkten und können über alle Organisationen hinweg arbeiten. Ihnen werden Rollen auf Enterprise-Ebene zugewiesen, und sie erben automatisch die entsprechenden Berechtigungen auf Orgebene in jeder Organisation (zum Beispiel gewährt ViewAccountSessions die Berechtigung ViewOrgSessions in allen Organisationen). Organisationsservicebenutzer sind auf eine einzelne Organisation beschränkt und authentifizieren sich ausschließlich an /v3/organizations/{org_id}/*-Endpunkten. Ihnen werden Rollen auf Orgebene zugewiesen.

​
Service-Benutzer erstellen

Service-Benutzer werden über die Devin UI erstellt:
  1. Enterprise-Service-Benutzer: Enterprise settings → Devin API (Tab Service users)
  2. Organisation-Service-Benutzer: Organization settings → Devin API (Tab Service users)
Weitere Informationen zur Einrichtung finden Sie in der Schnellstartanleitung für Teams oder der Enterprise-Schnellstart.