Die v3 API befindet sich derzeit in der Beta-Phase. Einige Endpunkte können sich ändern, während wir die API weiter verbessern.
https://api.devin.ai/v3beta1/enterprise/*– Endpunkte, die Enterprise-Berechtigungen erfordernhttps://api.devin.ai/v3beta1/organizations/*– Endpunkte, die auf eine einzelne Organisation beschränkt sind
Einige Enterprise-Endpunkte beziehen sich auf bestimmte Organisationen, werden aber weiterhin durch
Berechtigungen auf Enterprise-Ebene geschützt. Diese verwenden Pfade wie
/v3beta1/enterprise/organizations/{org_id}/...
(zum Beispiel GET /v3beta1/enterprise/organizations/{org_id}/audit-logs).
Auch wenn sie einen org_id-Pfadparameter enthalten, erfordern sie trotzdem
Berechtigungen auf Enterprise-Ebene wie ManageEnterpriseSettings.Berechtigungen und RBAC
/v3beta1/enterprise/*, und Organisationsberechtigungen steuern die Endpunkte /v3beta1/organizations/{org_id}/*. Ein Enterprise-Servicebenutzer mit einer Berechtigung auf Enterprise-Ebene erbt automatisch die entsprechende Organisationsberechtigung für alle Organisationen.
Enterprise-Berechtigungen
| Berechtigung | Umfasst |
|---|---|
ReadAccountMeta | Eigenes Konto (wird standardmäßig allen Servicebenutzern gewährt) |
ManageEnterpriseSettings | Audit-Logs, Organisationstags |
ManageOrganizations | CRUD für Organisationen, Grenzwerte für Organisationsgruppen |
ManageAccountMembership | Rollen, Enterprise-Benutzer, Enterprise-IdP-Gruppen, Mitgliedschaft von Enterprise-Servicebenutzern, Registrierung von Enterprise-IdP-Gruppen |
ManageAccountServiceUsers | Bereitstellung von Servicebenutzern (Enterprise) |
ManageAccountKnowledge | Knowledge-Notizen (Enterprise) |
ManageAccountPlaybooks | Playbooks (Enterprise) |
ManageGitIntegrations | Git-Verbindungen, Git-Berechtigungen |
ManageBilling | Verbrauchszyklen, tägliche Verbrauchsübersichten |
ViewAccountMetrics | Nutzungsmetriken (DAU/WAU/MAU, PRs, Sitzungen, Suchvorgänge, aktive Benutzer), Warteschlangenstatus |
ViewEnterpriseInfraDetails | Hypervisoren |
ViewAccountSessions | Sitzungsliste und -details (Enterprise, schreibgeschützt) |
ManageAccountSessions | Nachrichten an Sitzungen senden (Enterprise) |
ViewAccountSearches | Suchvorgänge (Enterprise) |
Organisationsberechtigungen
| Berechtigung | Steuert |
|---|---|
ManageOrgSecrets | Secrets (CRUD) |
ManageOrgKnowledge | Knowledge-Notizen (Organisation) |
ManageOrgPlaybooks | Playbooks (Organisation) |
ManageOrgServiceUsers | Bereitstellung von Service-Usern (Organisation) |
ViewOrgSessions | Sitzungsübersicht und -details (Organisation, schreibgeschützt) |
ManageOrgSessions | Nachrichten senden, Sitzungen beenden und archivieren |
UseDevinSessions | Sitzungen erstellen |
ImpersonateOrgSessions | Sitzungen im Namen anderer Nutzer erstellen (create_as_user_id) |
ViewOrgSearches | Suchvorgänge (Organisation) |
Berechtigungsbereiche von Servicebenutzern
/v3beta1/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 /v3beta1/organizations/{org_id}/*-Endpunkten. Ihnen werden Rollen auf Orgebene zugewiesen.
Erstellen von Service-Benutzern
- UI: Enterprise Settings → Service Users — Erstellen Sie Enterprise- oder organisationsweite Service-Benutzer mit benutzerdefinierten Rollen und generieren Sie API-Token.
- API:
POST /v3beta1/enterprise/service-usersoderPOST /v3beta1/organizations/{org_id}/service-users— Service-Benutzer mit einer angegebenen Rolle und TTL programmgesteuert bereitstellen. Die Berechtigungen des neuen Benutzers müssen eine Teilmenge der Berechtigungen des Aufrufers sein (Privilegieneskalation wird verhindert).
Self
Audit-Logs
Enterprise-Audit-Protokolle
Unternehmensweite Audit-Protokolle abrufen
Audit-Protokolle für Organisationen
Audit-Protokolle für eine bestimmte Organisation abrufen
Verbrauch
Verbrauchszyklen
Zusammenfassungen der Verbrauchszyklen anzeigen
Täglicher Verbrauch
Tägliche Verbrauchsübersichten abrufen
Nach Organisation
Verbrauch pro Organisation nachverfolgen
Nach Benutzer
Verbrauch pro Benutzer nachverfolgen
Nach Sitzung
Verbrauch pro Sitzung nachverfolgen
Organisationen
Organisationen auflisten
Alle Organisationen anzeigen
Organisation erstellen
Eine neue Organisation erstellen
Organisation aktualisieren
Organisationseinstellungen aktualisieren
Organisation löschen
Eine Organisation löschen
Servicebenutzer
Enterprise-Servicebenutzer auflisten
Enterprise-Servicebenutzer anzeigen
Enterprise-Servicebenutzer erstellen
Enterprise-Servicebenutzer erstellen
Enterprise-Servicebenutzer aktualisieren
Enterprise-Servicebenutzer aktualisieren
Enterprise-Servicebenutzer löschen
Enterprise-Servicebenutzer löschen
Organisations-Servicebenutzer auflisten
Organisations-Servicebenutzer anzeigen
Organisations-Servicebenutzer erstellen
Organisations-Servicebenutzer erstellen
Benutzer
Enterprise-Benutzer auflisten
Enterprise-Benutzer anzeigen
Enterprise-Benutzer hinzufügen
Einen Benutzer zur Enterprise hinzufügen
Enterprise-Benutzer aktualisieren
Einen Enterprise-Benutzer aktualisieren
Enterprise-Benutzer entfernen
Einen Benutzer aus der Enterprise entfernen
Organisationsbenutzer auflisten
Organisationsbenutzer anzeigen
Organisationsbenutzer hinzufügen
Einen Benutzer zu einer Organisation hinzufügen
IdP-Gruppen
Registrierte Enterprise-Gruppen auflisten
Registrierte IdP-Gruppen für dieses Enterprise auflisten
Enterprise-Gruppen registrieren
IdP-Gruppen für dieses Enterprise registrieren
Registrierte Enterprise-Gruppe entfernen
Eine registrierte IdP-Gruppe aus diesem Enterprise entfernen
Enterprise-Gruppen auflisten
Enterprise-IdP-Gruppenzuweisungen anzeigen
Enterprise-Gruppe zuweisen
Eine IdP-Gruppenrolle auf Enterprise-Ebene zuweisen
Organisationsgruppen auflisten
Organisations-IdP-Gruppenzuweisungen anzeigen
Organisationsgruppe zuweisen
Eine IdP-Gruppenrolle auf Organisationsebene zuweisen
Git-Berechtigungen
Berechtigungen auflisten
Git-Berechtigungen für eine Organisation einsehen
Berechtigung hinzufügen
Eine Git-Berechtigung hinzufügen
Berechtigung entfernen
Eine Git-Berechtigung entfernen
Notizen
Enterprise-Knowledge-Notizen auflisten
Enterprise-Knowledge-Notizen anzeigen
Enterprise-Knowledge-Notiz erstellen
Neue Enterprise-Knowledge-Notiz erstellen
Org-Knowledge-Notizen auflisten
Organisations-Knowledge-Notizen anzeigen
Org-Knowledge-Notiz erstellen
Neue Organisations-Knowledge-Notiz erstellen
Playbooks
Enterprise-Playbooks auflisten
Enterprise-Playbooks anzeigen
Enterprise-Playbook erstellen
Neues Enterprise-Playbook erstellen
Org-Playbooks auflisten
Org-Playbooks anzeigen
Org-Playbook erstellen
Neues Org-Playbook erstellen
Sitzungen
Sitzungen auflisten
Sitzungen einer Organisation anzeigen
Sitzung erstellen
Eine neue Sitzung erstellen
Sitzung beenden
Eine aktive Sitzung beenden
Sitzung archivieren
Eine Sitzung zur zukünftigen Referenz archivieren
Tags abrufen
Tags für eine Organisation anzeigen
Tags hinzufügen
Tags zu einer Organisation hinzufügen
Tags ersetzen
Alle Tags einer Organisation ersetzen
Tag löschen
Einen bestimmten Tag entfernen
Rollen & Metriken
Rollen auflisten
Verfügbare Rollen anzeigen
Nutzungsmetriken
Enterprise-Nutzungsmetriken abrufen
Organisationsmetriken
Nutzungsmetriken für Organisationen abrufen
Anwendungsbeispiele
Codebeispiele ansehen
Codebeispiele und typische Anwendungsfälle der v3-API ansehen