Skip to main content

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.

This page provides code examples for common v2 Enterprise API use cases.

Quick Examples

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']}")
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": "Engineering Team",
        "acu_limit": 1000
    }
)

org = response.json()
print(f"Created organization: {org['id']}")
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"Current cycle: {current_cycle['start_date']} to {current_cycle['end_date']}")
print(f"ACUs used: {current_cycle['acus_used']}")
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']}")
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"Invited {len(result['invited'])} members")
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']}")
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"Permission added: {response.json()}")
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("Invalid API key")
    elif e.response.status_code == 403:
        print("Insufficient permissions - Enterprise Admin required")
    elif e.response.status_code == 429:
        print("Rate limit exceeded - wait and retry")
    else:
        print(f"API error: {e}")

Support

Need Help?

For questions about the API or to report issues, email support@cognition.ai