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 session metrics for your enterprise:

PR Metrics

Get pull request metrics for your enterprise

Sessions Metrics

Get session 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

​
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

Get Organization Details

Get detailed information about a specific organization

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

​
Audit Logs

Track and analyze audit logs across your enterprise:

Audit Logs

Get audit logs for enterprise activities and consumption

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