Enterprise API Overview
Learn how to programmatically access enterprise-specific features and reporting using our REST API
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.
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:
Base URL
All Enterprise API endpoints use the base URL:
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 itemstotal
: Total number of items availableskip
: Number of items skippedlimit
: Maximum items per pagehas_more
: Whether more items are availablenext_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:
Support
For questions about the Enterprise API or to report issues, email support@cognition.ai.