The Devin Enterprise API provides programmatic access to enterprise-specific features including consumption tracking, member management, and organization administration.
The Enterprise API is currently in beta. While we strive to maintain backward compatibility, some endpoints may change as we improve the API.

Looking for the regular API reference?

Access the standard Devin API documentation for sessions, secrets, and knowledge management.

​
Authentication

Enterprise API endpoints require a valid API key with enterprise admin permissions. You can obtain an API key from your settings page.
Keep your API keys secure and never share them in publicly accessible areas such as GitHub repositories or client-side code. Enterprise API keys provide access to sensitive organizational data.

​
Available Endpoints

Our Enterprise API provides endpoints organized into the following categories:

​
Consumption

Track and analyze ACU consumption across your enterprise:

Consumption Cycles

List all billing cycles for the enterprise

Daily Consumption

Get daily consumption data for the current billing cycle

User Daily Consumption

Get daily consumption data for a specific user

​
Metrics

Track pull request and usage metrics for your enterprise:

PR Metrics

Get pull request metrics for your enterprise

Usage Metrics

Get usage metrics (sessions and searches) for your enterprise

Searches Metrics

Get search count metrics for your enterprise

​
Members

Manage enterprise members and their access:

List Enterprise Members

Get a paginated list of all members in your enterprise

Get Member Details

Get detailed information about a specific enterprise member

Delete Enterprise Member

Permanently delete an enterprise member

User Organizations

Get organizations that a specific user has access to

Invite Enterprise Members

Invite multiple users to the enterprise by email (bulk invite, max 100)

​
Groups

Manage enterprise IdP (Identity Provider) groups and their organization associations:
IdP groups must be explicitly enabled for your enterprise and are only supported for some enterprise SSO connections. Contact your administrator to enable group support.

List Enterprise Groups

Get a paginated list of all IdP groups in your enterprise

Get Group Details

Get detailed information about a specific IdP group

Group Organizations

List organizations that an IdP group belongs to

​
Organizations

Manage organizations within your enterprise:

List Organizations

Get a paginated list of all organizations in your enterprise

Create Organization

Create a new organization within your enterprise

Get Organization Details

Get detailed information about a specific organization

Update Organization

Update an organization’s ACU limit and/or display name

Delete Organization

Delete an organization from your enterprise

Organization Groups

Get groups within a specific organization

Add Group to Organization

Add an IdP group to an organization with a specific role

Remove Group from Organization

Remove an IdP group from an organization

Organization Members

Get members within a specific organization

Organization Permissions

Get git permissions for a specific organization

​
API Keys

Manage enterprise API keys:

Create a Service API Key

Create a service account API key for an organization

List API Keys

Get a paginated list of enterprise API keys

Get Enterprise API Key

Retrieve the full API key by ID

Revoke API Key

Revoke a specific enterprise API key

Revoke All API Keys

Revoke all API keys across organizations in the enterprise

​
Infrastructure

Monitor and manage your VPC infrastructure:

List Hypervisors

Get hypervisor status information for VPC monitoring

​
Audit Logs

Track and analyze audit logs across your enterprise:

Audit Logs

Get audit logs for enterprise activities and consumption

​
Sessions (Beta)

Beta Feature - The Sessions API endpoints are currently in beta. While we strive to maintain backward compatibility, these endpoints may change as we improve the feature.
Track and analyze Devin sessions across your enterprise:

List Enterprise Sessions (Beta)

Get a paginated list of all Devin sessions with filtering and analysis data

Get Session Details (Beta)

Get detailed information about a specific Devin session

​
Base URL

All Enterprise API endpoints use the base URL: 
https://api.devin.ai/v2/enterprise/

​
Pagination

Many Enterprise API endpoints support pagination using the following query parameters:
  • skip: Number of items to skip (default: 0)
  • limit: Maximum number of items to return (default: 100, max: 1000)
Paginated responses include:
  • items: Array of result items
  • total: Total number of items available
  • skip: Number of items skipped
  • limit: Maximum items per page
  • has_more: Whether more items are available
  • next_cursor: Cursor for the next page (if applicable)

​
Error Handling

The Enterprise API uses standard HTTP status codes and returns detailed error information in JSON format: 
{
  "detail": [
    {
      "loc": ["query", "limit"],
      "msg": "ensure this value is less than or equal to 1000",
      "type": "value_error.number.not_le"
    }
  ]
}

​
Support

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