> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Schnellstart: Teams

> Erste Schritte mit der Devin API als Nutzer:in eines Teams oder einer Standardorganisation

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.

<Note>
  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](/de/api-reference/getting-started/enterprise-quickstart) an.
</Note>

<div id="step-1-create-a-service-user">
  ## Schritt 1: Servicebenutzer erstellen
</div>

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

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

<div id="step-2-generate-an-api-key">
  ## Schritt 2: API key generieren
</div>

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:

```bash theme={null}
export DEVIN_API_KEY="cog_your_key_here"
```

<div id="step-3-make-your-first-api-call">
  ## Schritt 3: Tätigen Sie Ihren ersten API-Aufruf
</div>

Erstellen Sie eine Devin-Session:

```bash theme={null}
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"}'
```

<Tip>
  Sie finden Ihre Organisations-ID auf der Seite **Settings → Service Users**.
</Tip>

<Note>
  **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](/de/api-reference/overview#session-attribution).
</Note>

<div id="step-4-common-operations">
  ## Schritt 4: Häufige Aktionen
</div>

<div id="list-your-sessions">
  ### Ihre Sessions auflisten
</div>

```bash theme={null}
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<div id="send-a-message-to-a-running-session">
  ### Eine Nachricht an eine laufende Session senden
</div>

```bash theme={null}
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"}'
```

<div id="manage-knowledge">
  ### Knowledge verwalten
</div>

```bash theme={null}
# 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_description": "When writing code", "body": "Use TypeScript strict mode..."}'
```

<div id="permissions-for-teams-users">
  ## Berechtigungen für Teams-Benutzer
</div>

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](/de/api-reference/getting-started/enterprise-quickstart).

<div id="next-steps">
  ## Nächste Schritte
</div>

* Erkunden Sie die **Organization API**-Endpunkte in der Seitenleiste
* Sehen Sie sich [gängige Abläufe](/de/api-reference/common-flows) für gängige Integrationsmuster an
* Lernen Sie die [Authentifizierung](/de/api-reference/authentication) im Detail kennen
* Richten Sie [geplante Sitzungen](/de/api-reference/v3/schedules/organizations-schedules) für wiederkehrende Aufgaben ein