Schnellstart: Teams

In dieser Anleitung richten Sie den API-Zugriff für Teams und Standardorganisationen (ohne Enterprise) ein. Sie legen einen Servicebenutzer an, erhalten Ihre Zugangsdaten und führen innerhalb weniger Minuten Ihren ersten API-Aufruf aus.

Wenn Sie zu einem Enterprise-Konto mit mehreren Organisationen, benutzerdefinierten Rollen oder Single Sign-On (SSO) gehören, sehen Sie sich stattdessen den Enterprise-Schnellstart an.

Schritt 1: Service-Benutzer erstellen

Gehen Sie in Ihrer Organisation zu Settings > Service-Benutzer
Klicken Sie auf Service-Benutzer erstellen
Wählen Sie einen aussagekräftigen Namen (z. B. „CI Pipeline“, „Monitoring Bot“)
Wählen Sie eine Rolle:
- Admin — Vollzugriff, einschließlich Organisationseinstellungen und Mitgliedschaften
- Member — kann Devin-Sitzungen und die meisten Organisationsressourcen erstellen und verwalten, jedoch keine Organisationseinstellungen oder Mitgliedschaften

Verwenden Sie für die meisten Automatisierungen die Rolle Member. Verwenden Sie Admin nur, wenn Ihre Integration Organisationseinstellungen oder andere Benutzer verwalten muss.

Schritt 2: API key generieren

Nachdem Sie den Service User erstellt haben, klicken Sie auf Generate API key
Kopieren Sie den Schlüssel sofort — er beginnt mit cog_ und wird nicht erneut angezeigt
Speichern Sie ihn sicher als Umgebungsvariable:

export DEVIN_API_KEY="cog_your_key_here"

Schritt 3: Tätigen Sie Ihren ersten API-Aufruf

Erstellen Sie eine Devin-Session:

export DEVIN_ORG_ID="your_org_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a simple Python script that prints Hello World"}'

Sie finden Ihre Organisations-ID auf der Seite Settings → Service Users.

Möchten Sie, dass Sessions Ihrem Benutzer zugeordnet werden? Standardmäßig werden Sessions dem Servicebenutzer zugeordnet. Um Sessions im Namen eines bestimmten Benutzers zu erstellen (sodass sie in der Session-Liste dieses Benutzers erscheinen), fügen Sie "create_as_user_id": "user_abc123" zum Request-Body hinzu. Dies erfordert die Rolle Admin (die die Berechtigung ImpersonateOrgSessions umfasst). Ausführliche Informationen finden Sie unter Session attribution.

Schritt 4: Häufige Aktionen

Ihre Sessions auflisten

curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

Eine Nachricht an eine laufende Session senden

export SESSION_ID="your_session_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions/$SESSION_ID/messages" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Please also add unit tests"}'

Knowledge verwalten

# Knowledge-Einträge auflisten
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Einen Knowledge-Eintrag erstellen
curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Coding standards", "trigger": "When writing code", "body": "Use TypeScript strict mode..."}'

Berechtigungen für Teams-Benutzer

Teams-Organisationen verwenden ein einfaches Berechtigungsmodell:

Rolle	Kann Sessions erstellen	Kann Ressourcen verwalten	Kann Einstellungen verwalten
Mitglied	Ja	Ja (Knowledge, Playbooks, Secrets)	Nein
Admin	Ja	Ja	Ja

Weitere Informationen zur feingranularen, rollenbasierten Zugriffskontrolle (RBAC) finden Sie im Enterprise-Schnellstart.

Nächste Schritte

Erkunden Sie die Organization API-Endpunkte in der Seitenleiste
Sehen Sie sich gängige Abläufe für gängige Integrationsmuster an
Lernen Sie die Authentifizierung im Detail kennen
Richten Sie geplante Sitzungen für wiederkehrende Aufgaben ein

Erste Schritte

Konzepte

Agent Lifecycle

Kontextverwaltung

Umgebungsverwaltung

Automatisierung

Integrationen

Analytics

Observability

Devin für Sicherheit

Infrastruktur

Identität & Zugriff

Konfiguration

Legacy API v1

Legacy API v2

Schritt 1: Service-Benutzer erstellen

Schritt 2: API key generieren

Schritt 3: Tätigen Sie Ihren ersten API-Aufruf

Schritt 4: Häufige Aktionen

Ihre Sessions auflisten

Eine Nachricht an eine laufende Session senden

Knowledge verwalten

Berechtigungen für Teams-Benutzer

Nächste Schritte

​Schritt 1: Service-Benutzer erstellen

​Schritt 2: API key generieren

​Schritt 3: Tätigen Sie Ihren ersten API-Aufruf

​Schritt 4: Häufige Aktionen

​Ihre Sessions auflisten

​Eine Nachricht an eine laufende Session senden

​Knowledge verwalten

​Berechtigungen für Teams-Benutzer

​Nächste Schritte

Schritt 1: Service-Benutzer erstellen

Schritt 2: API key generieren

Schritt 3: Tätigen Sie Ihren ersten API-Aufruf

Schritt 4: Häufige Aktionen

Ihre Sessions auflisten

Eine Nachricht an eine laufende Session senden

Knowledge verwalten

Berechtigungen für Teams-Benutzer

Nächste Schritte