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

# v2 Nutzungsbeispiele

> Codebeispiele und häufige Anwendungsfälle für die Enterprise-API v2

Diese Seite enthält Codebeispiele für häufige Anwendungsfälle der Enterprise-API v2.

<div id="quick-examples">
  ## Schnellstart-Beispiele
</div>

<AccordionGroup>
  <Accordion title="Enterprise-Mitglieder auflisten">
    ```python theme={null}
    import os
    import requests

    API_KEY = os.getenv("DEVIN_API_KEY")
    BASE_URL = "https://api.devin.ai/v2/enterprise"

    response = requests.get(
        f"{BASE_URL}/members",
        headers={"Authorization": f"Bearer {API_KEY}"}
    )

    members = response.json()
    for member in members["members"]:
        print(f"{member['email']} - {member['role']}")
    ```
  </Accordion>

  <Accordion title="Organisation erstellen">
    ```python theme={null}
    import os
    import requests

    API_KEY = os.getenv("DEVIN_API_KEY")
    BASE_URL = "https://api.devin.ai/v2/enterprise"

    response = requests.post(
        f"{BASE_URL}/organizations",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "name": "Ingenieurteam",
            "acu_limit": 1000
        }
    )

    org = response.json()
    print(f"Organisation erstellt: {org['id']}")
    ```
  </Accordion>

  <Accordion title="Nutzungsmetriken abrufen">
    ```python theme={null}
    import os
    import requests

    API_KEY = os.getenv("DEVIN_API_KEY")
    BASE_URL = "https://api.devin.ai/v2/enterprise"

    response = requests.get(
        f"{BASE_URL}/consumption/cycles",
        headers={"Authorization": f"Bearer {API_KEY}"}
    )

    cycles = response.json()
    current_cycle = cycles["cycles"][0]
    print(f"Aktueller Zyklus: {current_cycle['start_date']} bis {current_cycle['end_date']}")
    print(f"Verwendete ACUs: {current_cycle['acus_used']}")
    ```
  </Accordion>

  <Accordion title="Sitzungsanalysen abrufen">
    ```python theme={null}
    import os
    import requests

    API_KEY = os.getenv("DEVIN_API_KEY")
    BASE_URL = "https://api.devin.ai/v2/enterprise"

    response = requests.get(
        f"{BASE_URL}/sessions/insights",
        headers={"Authorization": f"Bearer {API_KEY}"},
        params={"limit": 50, "offset": 0}
    )

    sessions = response.json()
    for session in sessions["sessions"]:
        print(f"Session {session['id']}: {session['insight']}")
    ```
  </Accordion>

  <Accordion title="Mitglieder zum Enterprise-Account einladen">
    ```python theme={null}
    import os
    import requests

    API_KEY = os.getenv("DEVIN_API_KEY")
    BASE_URL = "https://api.devin.ai/v2/enterprise"

    response = requests.post(
        f"{BASE_URL}/members/invite",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "emails": ["user1@company.com", "user2@company.com"],
            "role": "member"
        }
    )

    result = response.json()
    print(f"{len(result['invited'])} Mitglieder eingeladen")
    ```
  </Accordion>

  <Accordion title="Audit-Protokolle abrufen">
    ```python theme={null}
    import os
    import requests
    from datetime import datetime, timedelta

    API_KEY = os.getenv("DEVIN_API_KEY")
    BASE_URL = "https://api.devin.ai/v2/enterprise"

    start_date = (datetime.now() - timedelta(days=7)).isoformat()

    response = requests.get(
        f"{BASE_URL}/audit-logs",
        headers={"Authorization": f"Bearer {API_KEY}"},
        params={"start_date": start_date, "limit": 100}
    )

    logs = response.json()
    for log in logs["logs"]:
        print(f"{log['timestamp']} - {log['action']} by {log['actor']}")
    ```
  </Accordion>

  <Accordion title="Organisationsrechte verwalten">
    ```python theme={null}
    import os
    import requests

    API_KEY = os.getenv("DEVIN_API_KEY")
    BASE_URL = "https://api.devin.ai/v2/enterprise"
    org_id = "your_org_id"

    response = requests.post(
        f"{BASE_URL}/organizations/{org_id}/permissions",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "provider": "github",
            "repository": "org/repo-name",
            "permission": "read"
        }
    )

    print(f"Berechtigung hinzugefügt: {response.json()}")
    ```
  </Accordion>

  <Accordion title="Fehlerbehandlung">
    ```python theme={null}
    import os
    import requests

    API_KEY = os.getenv("DEVIN_API_KEY")
    BASE_URL = "https://api.devin.ai/v2/enterprise"

    try:
        response = requests.get(
            f"{BASE_URL}/members",
            headers={"Authorization": f"Bearer {API_KEY}"}
        )
        response.raise_for_status()
        data = response.json()
    except requests.exceptions.HTTPError as e:
        if e.response.status_code == 401:
            print("Ungültiger API Key")
        elif e.response.status_code == 403:
            print("Unzureichende Berechtigungen – Enterprise-Administrator erforderlich")
        elif e.response.status_code == 429:
            print("Ratenlimit überschritten – warten und erneut versuchen")
        else:
            print(f"API-Fehler: {e}")
    ```
  </Accordion>
</AccordionGroup>

<div id="support">
  ## Support
</div>

<Card title="Benötigen Sie Hilfe?">
  Bei Fragen zur API oder um Probleme zu melden, schreiben Sie an [support@cognition.ai](mailto:support@cognition.ai)
</Card>