Zum Hauptinhalt springen
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: Servicebenutzer erstellen

  1. Gehen Sie in Ihrer Organisation zu Settings > Service users
  2. Klicken Sie auf Create service user
  3. Wählen Sie einen aussagekräftigen Namen (z. B. „CI Pipeline“, „Monitoring Bot“)
  4. Wählen Sie eine Rolle:
    • Admin — Vollzugriff zum Verwalten von Sessions, Knowledge, Playbooks, Secrets und Einstellungen
    • Member — kann Devin-Sessions erstellen und verwalten sowie Ressourcen anzeigen
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

  1. Nachdem Sie den Service User erstellt haben, klicken Sie auf Generate API key
  2. Kopieren Sie den Schlüssel sofort — er beginnt mit cog_ und wird nicht erneut angezeigt
  3. Speichern Sie ihn sicher als Umgebungsvariable:
export DEVIN_API_KEY="cog_your_key_here"

​
Schritt 3: Führen Sie Ihren ersten API-Aufruf aus

Erstellen Sie eine Devin-Session: 
curl -X POST "https://api.devin.ai/v3/organizations/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a simple Python script that prints Hello World"}'
Sie müssen Ihre Organisations-ID nicht in der URL angeben. Da Ihr Service-User auf eine einzelne Organisation beschränkt ist, ermittelt die API die ID automatisch. Optional können Sie sie dennoch angeben: /v3/organizations/{org_id}/sessions. Sie finden Ihre Organisations-ID unter Settings → Organization details.
Möchten Sie, dass Sessions Ihrem User zugeordnet werden? Standardmäßig werden Sessions dem Service-User zugeordnet. Um Sessions im Namen eines bestimmten Users zu erstellen (sodass sie in der Session-Liste dieses Users 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

​
Sitzungen auflisten

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

​
Eine Nachricht an eine laufende Sitzung senden

export SESSION_ID="your_session_id"

curl -X POST "https://api.devin.ai/v3/organizations/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/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

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

​
Berechtigungen für Teams-Benutzer

Teams-Organisationen verwenden ein einfaches Berechtigungsmodell:
RolleKann Sessions erstellenKann Ressourcen verwaltenKann Einstellungen verwalten
MitgliedJaJa (Knowledge, Playbooks, Secrets)Nein
AdminJaJaJa
Weitere Informationen zur feingranularen, rollenbasierten Zugriffskontrolle (RBAC) finden Sie im Enterprise-Schnellstart.

​
Nächste Schritte