Skip to main content
The v2 API is being deprecated in favor of the Enterprise API which provides role-based access control with service users, session attribution, and new features like cursor-based pagination. See the migration guide for step-by-step instructions.
The v2 API provides enterprise-wide management, analytics, and compliance capabilities for enterprise administrators.
Access to the v2 API requires Enterprise Admin role.
Base URL: https://api.devin.ai/v2/enterprise/* Authentication: Enterprise Admin Personal API Keys (learn more)

​
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 or Enterprise API respectively.

​
API Keys

Provision and manage service API keys for your enterprise:

Provision Service Key

Create a new service API key for automation

List API Keys

View all API keys in your enterprise

Revoke API Key

Revoke a specific API key

Revoke All Keys

Revoke all API keys for a user

​
Audit Logs

Access compliance and security audit trails:

Get Audit Logs

Retrieve enterprise-wide audit logs for compliance

​
Consumption

Track ACU usage and billing:

Consumption Cycles

View consumption cycle summaries

Daily Consumption

Get daily consumption breakdowns

User Daily Consumption

Track consumption by user

​
Groups

Manage enterprise IdP groups:

List Groups

View all IdP groups in your enterprise

Add Groups

Add new IdP groups to your enterprise

Get Group Details

Retrieve details for a specific group

​
Members

Manage enterprise members and roles:

List Members

View all members in your enterprise

Get Member Details

Retrieve details for a specific member

Invite Members

Invite new members to your enterprise

Update Roles

Update a member’s roles

Delete Member

Remove a member from your enterprise

List Roles

View available roles

​
Metrics

Access analytics and usage metrics:

PR Metrics

View pull request metrics

Session Metrics

Access session analytics

Search Metrics

View search usage metrics

Usage Metrics

Get overall usage analytics

​
Organizations

Manage sub-organizations:

List Organizations

View all organizations in your enterprise

Create Organization

Create a new sub-organization

Get Organization

Retrieve organization details

Update Organization

Update organization settings

Delete Organization

Delete a sub-organization

​
Sessions

View enterprise-wide session data:

List Sessions

View all sessions across the enterprise

Session Insights

Get AI-powered session insights

Get Session

Retrieve details for a specific session

​
Playbooks

Manage enterprise-wide playbooks:

List Playbooks

View all playbooks

Create Playbook

Create a new playbook

Get Playbook

Retrieve playbook details

Update Playbook

Update an existing playbook

Delete Playbook

Delete a playbook

​
Next steps

Migrate to the current API for RBAC with service users, session attribution, and new features. See the migration guide.