> ## 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.

# v2 API Overview (Legacy)

> Enterprise-wide management, analytics, and compliance for administrators

<Warning>
  This API version is deprecated. Use [API v3](/api-reference/v3/overview) with service user authentication. See the [migration guide](/api-reference/getting-started/migration-guide) for step-by-step instructions.
</Warning>

The v2 API provides enterprise-wide management, analytics, and compliance capabilities for enterprise administrators.

<Note>
  Access to the v2 API requires Enterprise Admin role.
</Note>

**Base URL:** `https://api.devin.ai/v2/enterprise/*`

**Authentication:** Enterprise Admin Personal API Keys ([learn more](/api-reference/authentication))

## Permissions

The v2 API requires the **Enterprise Admin** role. Only users with this role can generate personal API keys that work with v2 endpoints. Service API keys and organization-level keys are not accepted.

All v2 endpoints provide enterprise-wide access to resources across all organizations within the enterprise. For organization-scoped access or fine-grained RBAC control, use the [Organization API](/api-reference/v3/overview) or [Enterprise API](/api-reference/v3/overview) respectively.

## API Keys

Provision and manage service API keys for your enterprise:

<CardGroup cols={2}>
  <Card title="Provision Service Key" icon="key" href="/api-reference/v2/api-keys/provision-service-key">
    Create a new service API key for automation
  </Card>

  <Card title="List API Keys" icon="list" href="/api-reference/v2/api-keys/list-enterprise-api-keys">
    View all API keys in your enterprise
  </Card>

  <Card title="Revoke API Key" icon="ban" href="/api-reference/v2/api-keys/revoke-enterprise-api-key">
    Revoke a specific API key
  </Card>
</CardGroup>

## Audit Logs

Access compliance and security audit trails:

<CardGroup cols={2}>
  <Card title="Get Audit Logs" icon="scroll" href="/api-reference/v2/audit-logs">
    Retrieve enterprise-wide audit logs for compliance
  </Card>
</CardGroup>

## Consumption

Track ACU usage and billing:

<CardGroup cols={2}>
  <Card title="Consumption Cycles" icon="chart-pie" href="/api-reference/v2/consumption/consumption-cycles">
    View consumption cycle summaries
  </Card>

  <Card title="Daily Consumption" icon="calendar-day" href="/api-reference/v2/consumption/daily-consumption">
    Get daily consumption breakdowns
  </Card>

  <Card title="User Daily Consumption" icon="user" href="/api-reference/v2/consumption/user-daily-consumption">
    Track consumption by user
  </Card>
</CardGroup>

## Groups

Manage enterprise IdP groups:

<CardGroup cols={2}>
  <Card title="List Groups" icon="users" href="/api-reference/v2/groups/list-enterprise-groups">
    View all IdP groups in your enterprise
  </Card>

  <Card title="Get Group Details" icon="circle-info" href="/api-reference/v2/groups/get-group-details">
    Retrieve details for a specific group
  </Card>
</CardGroup>

## Members

Manage enterprise members and roles:

<CardGroup cols={2}>
  <Card title="List Members" icon="users" href="/api-reference/v2/members/list-enterprise-members">
    View all members in your enterprise
  </Card>

  <Card title="Get Member Details" icon="circle-info" href="/api-reference/v2/members/get-member-details">
    Retrieve details for a specific member
  </Card>

  <Card title="Invite Members" icon="envelope" href="/api-reference/v2/members/invite-enterprise-members">
    Invite new members to your enterprise
  </Card>

  <Card title="Delete Member" icon="trash" href="/api-reference/v2/members/delete-enterprise-member">
    Remove a member from your enterprise
  </Card>

  <Card title="List Roles" icon="shield" href="/api-reference/v2/members/list-roles">
    View available roles
  </Card>
</CardGroup>

## Metrics

Access analytics and usage metrics:

<CardGroup cols={2}>
  <Card title="PR Metrics" icon="code-pull-request" href="/api-reference/v2/consumption/pr-metrics">
    View pull request metrics
  </Card>

  <Card title="Session Metrics" icon="chart-line" href="/api-reference/v2/consumption/sessions-metrics">
    Access session analytics
  </Card>

  <Card title="Search Metrics" icon="magnifying-glass-chart" href="/api-reference/v2/consumption/searches-metrics">
    View search usage metrics
  </Card>

  <Card title="Usage Metrics" icon="gauge-high" href="/api-reference/v2/consumption/usage-metrics">
    Get overall usage analytics
  </Card>
</CardGroup>

## Organizations

Manage sub-organizations:

<CardGroup cols={2}>
  <Card title="List Organizations" icon="building" href="/api-reference/v2/organizations/list-organizations">
    View all organizations in your enterprise
  </Card>

  <Card title="Create Organization" icon="plus" href="/api-reference/v2/organizations/create-organization">
    Create a new sub-organization
  </Card>

  <Card title="Get Organization" icon="circle-info" href="/api-reference/v2/organizations/get-organization-details">
    Retrieve organization details
  </Card>

  <Card title="Update Organization" icon="pencil" href="/api-reference/v2/organizations/update-organization">
    Update organization settings
  </Card>

  <Card title="Delete Organization" icon="trash" href="/api-reference/v2/organizations/delete-organization">
    Delete a sub-organization
  </Card>
</CardGroup>

## Sessions

View enterprise-wide session data:

<CardGroup cols={2}>
  <Card title="List Sessions" icon="list" href="/api-reference/v2/sessions/list-enterprise-sessions">
    View all sessions across the enterprise
  </Card>

  <Card title="Session Insights" icon="lightbulb" href="/api-reference/v2/sessions/list-enterprise-sessions-insights">
    Get AI-powered session insights
  </Card>

  <Card title="Get Session" icon="circle-info" href="/api-reference/v2/sessions/get-enterprise-session">
    Retrieve details for a specific session
  </Card>
</CardGroup>

## Playbooks

Manage enterprise-wide playbooks:

<CardGroup cols={2}>
  <Card title="List Playbooks" icon="book" href="/api-reference/v2/playbooks/list-playbooks">
    View all playbooks
  </Card>

  <Card title="Create Playbook" icon="plus" href="/api-reference/v2/playbooks/create-playbook">
    Create a new playbook
  </Card>
</CardGroup>

## Next steps

Migrate to the [current API](/api-reference/overview) for RBAC with service users, session attribution, and new features. See the [migration guide](/api-reference/getting-started/migration-guide).