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 (Kontenebene) 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
Berechtigungstypen
| Berechtigung | Beschreibung | Endpoints |
|---|---|---|
ManageAccountKnowledge | Knowledge-Notizen auf Enterprise- oder Organisationsebene verwalten | Notes-Endpunkte (GET, POST, PUT, DELETE) |
ManageAccountPlaybooks | Playbooks auf Enterprise- oder Organisationsebene verwalten | Playbooks-Endpunkte (GET, POST, PUT, DELETE) |
ManageEnterpriseSettings | Unternehmensweite Einstellungen, einschließlich Organisations-Tags, verwalten | Tags-Endpunkte, Organisationsverwaltung |
Geltungsbereiche von Servicebenutzern
/v3beta1/enterprise/*.
Organization Service Users sind auf eine bestimmte Organisation beschränkt und können nur auf Ressourcen innerhalb dieser Organisation zugreifen. Sie verwenden Endpunkte unter /v3beta1/organizations/{org_id}/*.
Erstellen von Service-Benutzern
- Enterprise-Einstellungen → Service Users: Erstellen Sie Service-Benutzer auf Enterprise- oder Organisationsebene mit benutzerdefinierten Rollen
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
Enterprise-Gruppen auflisten
Enterprise-IdP-Gruppen anzeigen
Enterprise-Gruppe hinzufügen
Eine IdP-Gruppe zum Enterprise-Account hinzufügen
Organisationsgruppen auflisten
Organisations-IdP-Gruppen anzeigen
Organisationsgruppe hinzufügen
Eine IdP-Gruppe zu einer Organisation hinzufügen
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
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
Sehen Sie sich Codebeispiele und typische Anwendungsfälle für die v3 API an
