# Devin Docs ## Docs - [Billing](https://docs.devin.ai/admin/billing.md) - [Common Issues](https://docs.devin.ai/admin/common-issues.md) - [Security at Cognition](https://docs.devin.ai/admin/security.md): We want Devin to be a core contributor in your organization, and have prioritized security, data privacy and compliance to make it possible - [Authentication](https://docs.devin.ai/api-reference/authentication.md): Understand principals, tokens, and how to authenticate with the Devin API - [Common Flows](https://docs.devin.ai/api-reference/common-flows.md): End-to-end workflow guides for common API use cases - [Pagination](https://docs.devin.ai/api-reference/concepts/pagination.md): How cursor-based pagination works across the Devin API - [Quick start: Enterprise](https://docs.devin.ai/api-reference/getting-started/enterprise-quickstart.md): Get started with the Devin API as an enterprise user with RBAC and multi-org support - [Migrating from v1/v2](https://docs.devin.ai/api-reference/getting-started/migration-guide.md): Migrate your integrations from API v1 or v2 to the current API - [Quick start: Teams](https://docs.devin.ai/api-reference/getting-started/teams-quickstart.md): Get started with the Devin API as a teams or standard organization user - [API Overview](https://docs.devin.ai/api-reference/overview.md): Learn how to programmatically interact with Devin using our REST APIs - [Personal Access Tokens [Closed Beta]](https://docs.devin.ai/api-reference/personal-access-tokens.md): Authenticate as yourself for programmatic API access - [API Release Notes](https://docs.devin.ai/api-reference/release-notes.md): Track changes, new features, and improvements to Devin's APIs - [Download an attachment](https://docs.devin.ai/api-reference/v1/attachments/download-attachment-files.md): Download attachment files that were previously uploaded. Returns a redirect to a presigned URL for secure file access. - [Upload an attachment](https://docs.devin.ai/api-reference/v1/attachments/upload-files-for-devin-to-work-with.md): Upload files for Devin to work with during sessions. Supports various file types including code, data, and documentation files. - [Create knowledge entry](https://docs.devin.ai/api-reference/v1/knowledge/create-knowledge.md): Create a new knowledge entry for the organization. - [Delete knowledge entry](https://docs.devin.ai/api-reference/v1/knowledge/delete-knowledge.md): Delete a knowledge entry from the organization. - [List all knowledge](https://docs.devin.ai/api-reference/v1/knowledge/list-knowledge.md): List all knowledge entries and folders for the organization. - [Update knowledge entry](https://docs.devin.ai/api-reference/v1/knowledge/update-knowledge.md): Update an existing knowledge entry. - [v1 API Overview (Legacy)](https://docs.devin.ai/api-reference/v1/overview.md): Core session management and automation with org-scoped access - [Create Playbook](https://docs.devin.ai/api-reference/v1/playbooks/create-playbook.md): Create a new team playbook - [Delete Playbook](https://docs.devin.ai/api-reference/v1/playbooks/delete-playbook.md): Delete a team playbook - [Get Playbook](https://docs.devin.ai/api-reference/v1/playbooks/get-playbook.md): Retrieve details of a specific playbook - [List Playbooks](https://docs.devin.ai/api-reference/v1/playbooks/list-playbooks.md): Retrieve all playbooks accessible to your organization - [Update Playbook](https://docs.devin.ai/api-reference/v1/playbooks/update-playbook.md): Update an existing team playbook - [Create Secret](https://docs.devin.ai/api-reference/v1/secrets/create-secret.md): Create a new secret in your organization - [Delete a secret](https://docs.devin.ai/api-reference/v1/secrets/delete-secret.md): Permanently delete a secret by its ID. This action cannot be undone. - [List secrets](https://docs.devin.ai/api-reference/v1/secrets/list-secrets.md): List metadata for all secrets in your organization. Does not return secret values. - [Create a new session](https://docs.devin.ai/api-reference/v1/sessions/create-a-new-devin-session.md): Create a new Devin session. You can optionally specify parameters like snapshot ID and session visibility. - [List sessions](https://docs.devin.ai/api-reference/v1/sessions/list-sessions.md): List all Devin sessions for your organization. - [Retrieve details about an existing session](https://docs.devin.ai/api-reference/v1/sessions/retrieve-details-about-an-existing-session.md): Retrieve detailed information about an existing Devin session, including its status, output, and metadata. - [Send a message to a session](https://docs.devin.ai/api-reference/v1/sessions/send-a-message-to-an-existing-devin-session.md): Send a message to an existing Devin session to provide additional instructions or information. - [Terminate a session](https://docs.devin.ai/api-reference/v1/sessions/terminate-a-session.md): Terminate an active Devin session. Once terminated, the session cannot be resumed. - [Update session tags](https://docs.devin.ai/api-reference/v1/sessions/update-session-tags.md): Update the tags associated with a Devin session. - [List API Keys](https://docs.devin.ai/api-reference/v2/api-keys/list-enterprise-api-keys.md): List API keys across an Enterprise - [Create a Service API Key](https://docs.devin.ai/api-reference/v2/api-keys/provision-service-key.md): Provision a service API key for an Organization in the Enterprise - [Revoke All API Keys](https://docs.devin.ai/api-reference/v2/api-keys/revoke-all-enterprise-api-keys.md): Revoke all API keys across organizations in the enterprise - [Revoke API Key](https://docs.devin.ai/api-reference/v2/api-keys/revoke-enterprise-api-key.md): Revoke a specific enterprise API key - [Get Audit Logs](https://docs.devin.ai/api-reference/v2/audit-logs.md): Retrieve audit logs for the entire enterprise. - [Consumption Cycles](https://docs.devin.ai/api-reference/v2/consumption/consumption-cycles.md): Generate a list of all billing cycles for the enterprise - [Daily Consumption](https://docs.devin.ai/api-reference/v2/consumption/daily-consumption.md): Return daily consumption for the current billing cycle - [PR Metrics](https://docs.devin.ai/api-reference/v2/consumption/pr-metrics.md): Get pull request metrics for your enterprise - [Searches Metrics](https://docs.devin.ai/api-reference/v2/consumption/searches-metrics.md): Get search count metrics for your enterprise - [Sessions Metrics](https://docs.devin.ai/api-reference/v2/consumption/sessions-metrics.md): Get sessions metrics for your enterprise - [Usage Metrics](https://docs.devin.ai/api-reference/v2/consumption/usage-metrics.md): Get usage metrics (sessions, searches, and PRs) for your enterprise - [User Daily Consumption](https://docs.devin.ai/api-reference/v2/consumption/user-daily-consumption.md): Return daily consumption for a specific user - [Add Enterprise Groups](https://docs.devin.ai/api-reference/v2/groups/add-enterprise-groups.md): Add new enterprise groups to your organization - [Get Group Details](https://docs.devin.ai/api-reference/v2/groups/get-group-details.md): Get details for a specific IdP group in this Enterprise - [List Enterprise Groups](https://docs.devin.ai/api-reference/v2/groups/list-enterprise-groups.md): List IdP groups in this Enterprise - [List Hypervisors](https://docs.devin.ai/api-reference/v2/infrastructure/list-enterprise-hypervisors.md): Get hypervisor status information for VPC monitoring - [Delete Enterprise Member](https://docs.devin.ai/api-reference/v2/members/delete-enterprise-member.md): Remove a user from an organization - [Get Member Details](https://docs.devin.ai/api-reference/v2/members/get-member-details.md): Get detailed information about a specific enterprise member - [Invite Enterprise Members](https://docs.devin.ai/api-reference/v2/members/invite-enterprise-members.md): Invite multiple users to the enterprise by email (bulk invite, max 100 users) - [List Enterprise Members](https://docs.devin.ai/api-reference/v2/members/list-enterprise-members.md): List paginated members in this enterprise - [List available roles](https://docs.devin.ai/api-reference/v2/members/list-roles.md): List all roles that are available to the user's enterprise - [Migrate member roles](https://docs.devin.ai/api-reference/v2/members/migrate-member-roles.md): Migrate all users from one account role to another - [Update member roles](https://docs.devin.ai/api-reference/v2/members/update-member-roles.md): Update enterprise roles for specific enterprise members - [User Organizations](https://docs.devin.ai/api-reference/v2/members/user-organizations.md): Get paginated list of organizations that this user has access to - [Get Organization Group Limits](https://docs.devin.ai/api-reference/v2/org-group-limits/get-org-group-limits.md): Get the current organization groups configuration - [Update Organization Group Limits](https://docs.devin.ai/api-reference/v2/org-group-limits/update-org-group-limits.md): Update the organization groups configuration - [Add Group to Organization](https://docs.devin.ai/api-reference/v2/organizations/add-group-to-organization.md): Add a new IdP group to an organization - [Add Organization Members](https://docs.devin.ai/api-reference/v2/organizations/add-organization-members.md): Bulk add users to one or more organizations within your enterprise - [Add Organization Permissions](https://docs.devin.ai/api-reference/v2/organizations/add-organization-permissions.md): Add git permissions to an organization - [Clone a Repository into an Organization](https://docs.devin.ai/api-reference/v2/organizations/clone-repository.md): Clone a repository into an organization' snapshot - [Create Organization](https://docs.devin.ai/api-reference/v2/organizations/create-organization.md): Create a new organization in this enterprise - [Delete Organization](https://docs.devin.ai/api-reference/v2/organizations/delete-organization.md): Delete an organization from this enterprise - [Delete Organization Permission](https://docs.devin.ai/api-reference/v2/organizations/delete-organization-permission.md): Remove a git permission from an organization - [Get Organization Details](https://docs.devin.ai/api-reference/v2/organizations/get-organization-details.md): Get details for a specific organization in this enterprise - [List Organizations](https://docs.devin.ai/api-reference/v2/organizations/list-organizations.md): List paginated organizations in this enterprise - [Migrate organization member roles](https://docs.devin.ai/api-reference/v2/organizations/migrate-organization-member-roles.md): Migrate all users from one organization role to another - [Organization Connections](https://docs.devin.ai/api-reference/v2/organizations/organization-connections.md): Get paginated list of git connections that this organization has access to - [Organization Groups](https://docs.devin.ai/api-reference/v2/organizations/organization-groups.md): Get paginated list of enterprise groups that are in this organization - [Organization Members](https://docs.devin.ai/api-reference/v2/organizations/organization-members.md): Get paginated list of users that are in this organization - [Organization Permissions](https://docs.devin.ai/api-reference/v2/organizations/organization-permissions.md): Get paginated list of git permissions that this organization has access to - [Remove Group from Organization](https://docs.devin.ai/api-reference/v2/organizations/remove-group-from-organization.md): Remove an IdP group from an organization - [Remove User from Organization](https://docs.devin.ai/api-reference/v2/organizations/remove-user-from-organization.md): Remove a user from an organization - [Update Organization](https://docs.devin.ai/api-reference/v2/organizations/update-organization.md): Update an organization's ACU limit and/or display name - [Update organization member roles](https://docs.devin.ai/api-reference/v2/organizations/update-organization-member-roles.md): Update organization roles for specific members - [v2 API Overview (Legacy)](https://docs.devin.ai/api-reference/v2/overview.md): Enterprise-wide management, analytics, and compliance for administrators - [Create Enterprise Playbook](https://docs.devin.ai/api-reference/v2/playbooks/create-playbook.md): Create a new playbook in your enterprise - [Delete Enterprise Playbook](https://docs.devin.ai/api-reference/v2/playbooks/delete-playbook.md): Delete an enterprise playbook by ID - [Get Enterprise Playbook](https://docs.devin.ai/api-reference/v2/playbooks/get-playbook.md): Retrieve a specific enterprise playbook by ID - [List Enterprise Playbooks](https://docs.devin.ai/api-reference/v2/playbooks/list-playbooks.md): List all enterprise playbooks available to the authenticated user - [Update Enterprise Playbook](https://docs.devin.ai/api-reference/v2/playbooks/update-playbook.md): Update an existing enterprise playbook by ID - [Bulk Index Repositories](https://docs.devin.ai/api-reference/v2/repositories/bulk-index-repositories.md): Index multiple repositories (up to 100) for use in Devin sessions. - [Get Repository Indexing Status](https://docs.devin.ai/api-reference/v2/repositories/get-repository-status.md): Retrieve the indexing status of repositories for a specific organization. - [Get Self](https://docs.devin.ai/api-reference/v2/self/get-self.md): Get information about the authenticated API key - [Get Enterprise Session](https://docs.devin.ai/api-reference/v2/sessions/get-enterprise-session.md): Get detailed information about a specific Devin session including analysis data and pull requests - [List Enterprise Sessions](https://docs.devin.ai/api-reference/v2/sessions/list-enterprise-sessions.md): Get a paginated list of Devin sessions for your enterprise - [List Enterprise Sessions (Insights)](https://docs.devin.ai/api-reference/v2/sessions/list-enterprise-sessions-insights.md): Get a paginated list of Devin sessions with detailed analysis data for your enterprise - [List Organization Sessions](https://docs.devin.ai/api-reference/v2/sessions/list-organization-sessions.md): Get a paginated list of Devin sessions for a specific organization - [List Organization Sessions (Insights)](https://docs.devin.ai/api-reference/v2/sessions/list-organization-sessions-insights.md): Get a paginated list of Devin sessions with detailed analysis data for a specific organization - [Get Enterprise Snapshot Details](https://docs.devin.ai/api-reference/v2/snapshots/get-enterprise-snapshot.md): Get detailed information about a specific Snapshot including pending running scripts - [Get User Usage Analysis (Beta)](https://docs.devin.ai/api-reference/v2/user-usage/get-user-usage-analysis-beta.md): Get paginated user usage analysis with detailed ACU consumption metrics across different time periods - [Download an attachment](https://docs.devin.ai/api-reference/v3/attachments/get-organizations-attachments.md): Download a file attachment. Returns a redirect to a presigned URL. - [Upload an attachment](https://docs.devin.ai/api-reference/v3/attachments/post-organizations-attachments.md): Upload a file attachment that can be used in Devin sessions. - [List Audit Logs](https://docs.devin.ai/api-reference/v3/audit-logs/enterprise-audit-logs.md): List audit logs for the enterprise. - [List Organization Audit Logs](https://docs.devin.ai/api-reference/v3/audit-logs/organizations-audit-logs.md): List audit logs for the organization. - [List Consumption Cycles](https://docs.devin.ai/api-reference/v3/consumption/consumption-cycles.md) - [Get Daily Consumption](https://docs.devin.ai/api-reference/v3/consumption/consumption-daily.md): Get daily ACU consumption for the entire enterprise. - [Get Organization Daily Consumption](https://docs.devin.ai/api-reference/v3/consumption/consumption-daily-organizations.md): Get daily ACU consumption for a specific organization. - [Get Service User Daily Consumption](https://docs.devin.ai/api-reference/v3/consumption/consumption-daily-service-users.md): Get daily ACU consumption for a specific service user. - [Get Session Daily Consumption](https://docs.devin.ai/api-reference/v3/consumption/consumption-daily-sessions.md): Get daily ACU consumption for a specific session. - [Get User Daily Consumption](https://docs.devin.ai/api-reference/v3/consumption/consumption-daily-users.md): Get daily ACU consumption for a specific user. - [Get Daily Consumption](https://docs.devin.ai/api-reference/v3/consumption/organizations-consumption-daily.md): Get daily ACU consumption for the organization. - [Get Service User Daily Consumption](https://docs.devin.ai/api-reference/v3/consumption/organizations-consumption-daily-service-users.md): Get daily ACU consumption for a specific service user within the organization. - [Get Session Daily Consumption](https://docs.devin.ai/api-reference/v3/consumption/organizations-consumption-daily-sessions.md): Get daily ACU consumption for a specific session within the organization. - [Get User Daily Consumption](https://docs.devin.ai/api-reference/v3/consumption/organizations-consumption-daily-users.md): Get daily ACU consumption for a specific user within the organization. - [List Git Connections](https://docs.devin.ai/api-reference/v3/git-connections/git-providers-connections.md) - [Clear Git Permissions](https://docs.devin.ai/api-reference/v3/git-permissions/clear-organizations-git-providers-permissions.md) - [Delete Git Permission](https://docs.devin.ai/api-reference/v3/git-permissions/delete-organizations-git-providers-permissions.md) - [List Git Permissions](https://docs.devin.ai/api-reference/v3/git-permissions/organizations-git-providers-permissions.md): List git permissions for the organization. - [Create Git Permissions](https://docs.devin.ai/api-reference/v3/git-permissions/post-organizations-git-providers-permissions.md) - [Replace Git Permissions](https://docs.devin.ai/api-reference/v3/git-permissions/put-organizations-git-providers-permissions.md) - [List Guardrail Violations](https://docs.devin.ai/api-reference/v3/guardrail-violations/enterprise-guardrail-violations.md): List guardrail violations across the enterprise. - [List Organization Guardrail Violations](https://docs.devin.ai/api-reference/v3/guardrail-violations/organizations-guardrail-violations.md): List guardrail violations for a specific organization. - [List Hypervisors](https://docs.devin.ai/api-reference/v3/hypervisors/hypervisors.md) - [Delete Account IDP Group](https://docs.devin.ai/api-reference/v3/idp-groups/delete-enterprise-idp-group.md): Remove a registered IDP group from this enterprise. - [Delete IDP Group](https://docs.devin.ai/api-reference/v3/idp-groups/delete-members-idp-groups.md) - [Delete Organization IDP Group](https://docs.devin.ai/api-reference/v3/idp-groups/delete-organizations-members-idp-groups.md): Remove idp_group from the organization. - [List Account IDP Groups](https://docs.devin.ai/api-reference/v3/idp-groups/enterprise-idp-groups.md): List IDP groups registered with this enterprise. - [Get IDP Group](https://docs.devin.ai/api-reference/v3/idp-groups/get-members-idp-group.md) - [List Organization IDP Groups](https://docs.devin.ai/api-reference/v3/idp-groups/list-organizations-members-idp-groups.md) - [List IDP Groups](https://docs.devin.ai/api-reference/v3/idp-groups/members-idp-groups.md) - [Get Organization IDP Group](https://docs.devin.ai/api-reference/v3/idp-groups/organizations-members-idp-groups.md) - [Update IDP Group](https://docs.devin.ai/api-reference/v3/idp-groups/patch-members-idp-groups.md) - [Update Organization IDP Group](https://docs.devin.ai/api-reference/v3/idp-groups/patch-organizations-members-idp-groups.md) - [Register Account IDP Groups](https://docs.devin.ai/api-reference/v3/idp-groups/post-enterprise-idp-groups.md): Bulk create IDP groups for this enterprise. Existing groups are ignored. - [Assign IDP Group](https://docs.devin.ai/api-reference/v3/idp-groups/post-members-idp-groups.md) - [Assign Organization IDP Group](https://docs.devin.ai/api-reference/v3/idp-groups/post-organizations-members-idp-groups.md) - [Clear IP Access List](https://docs.devin.ai/api-reference/v3/ip-access-list/clear-ip-access-list.md) - [Get IP Access List](https://docs.devin.ai/api-reference/v3/ip-access-list/get-ip-access-list.md) - [Replace IP Access List](https://docs.devin.ai/api-reference/v3/ip-access-list/replace-ip-access-list.md) - [Get Active Users for Custom Date Range](https://docs.devin.ai/api-reference/v3/metrics/metrics-active-users.md): Get unique active users for a custom date range. - [Get Daily Active Users](https://docs.devin.ai/api-reference/v3/metrics/metrics-dau.md): Get daily active users for each day in the specified time range. - [Get Monthly Active Users](https://docs.devin.ai/api-reference/v3/metrics/metrics-mau.md): Get monthly active users for each month in the specified time range. - [Get PR Metrics](https://docs.devin.ai/api-reference/v3/metrics/metrics-prs.md): Get aggregated PR metrics for the enterprise account. - [Get Search Metrics](https://docs.devin.ai/api-reference/v3/metrics/metrics-searches.md): Get aggregated search metrics for the enterprise account. - [Get Session Metrics](https://docs.devin.ai/api-reference/v3/metrics/metrics-sessions.md): Get aggregated session metrics for the enterprise account. - [Get Session Metrics by Category](https://docs.devin.ai/api-reference/v3/metrics/metrics-sessions-by-category.md): Get session counts and ACU consumption grouped by category and subcategory. - [Get Usage Metrics](https://docs.devin.ai/api-reference/v3/metrics/metrics-usage.md): Get aggregated usage metrics for the enterprise account. - [Get Weekly Active Users](https://docs.devin.ai/api-reference/v3/metrics/metrics-wau.md): Get weekly active users for each week in the specified time range. - [Get Active Users for Custom Date Range](https://docs.devin.ai/api-reference/v3/metrics/organizations-metrics-active-users.md): Get unique active users for a custom date range. - [Get Daily Active Users](https://docs.devin.ai/api-reference/v3/metrics/organizations-metrics-dau.md): Get daily active users for each day in the specified time range. - [Get Monthly Active Users](https://docs.devin.ai/api-reference/v3/metrics/organizations-metrics-mau.md): Get monthly active users for each month in the specified time range. - [Get PR Metrics](https://docs.devin.ai/api-reference/v3/metrics/organizations-metrics-prs.md): Get aggregated PR metrics for the organization. - [Get Search Metrics](https://docs.devin.ai/api-reference/v3/metrics/organizations-metrics-searches.md): Get aggregated search metrics for the organization. - [Get Session Metrics](https://docs.devin.ai/api-reference/v3/metrics/organizations-metrics-sessions.md): Get aggregated session metrics for the organization. - [Get Organization Usage Metrics](https://docs.devin.ai/api-reference/v3/metrics/organizations-metrics-usage.md): Get aggregated usage metrics for the enterprise account. - [Get Usage Metrics](https://docs.devin.ai/api-reference/v3/metrics/organizations-metrics-usage-org.md): Get aggregated usage metrics for the organization. - [Get Weekly Active Users](https://docs.devin.ai/api-reference/v3/metrics/organizations-metrics-wau.md): Get weekly active users for each week in the specified time range. - [Delete a note](https://docs.devin.ai/api-reference/v3/notes/delete-enterprise-knowledge-notes-note-id.md) - [Delete an org-level note](https://docs.devin.ai/api-reference/v3/notes/delete-organizations-knowledge-notes-note-id.md): Delete a note for an organization. - [Get knowledge folder structure with note counts.](https://docs.devin.ai/api-reference/v3/notes/enterprise-knowledge-folders.md): Return the full folder tree with per-folder note counts. - [List all notes.](https://docs.devin.ai/api-reference/v3/notes/enterprise-knowledge-notes.md) - [Get a note by ID](https://docs.devin.ai/api-reference/v3/notes/get-enterprise-knowledge-note.md): Get a note by ID. - [Get an org-level note](https://docs.devin.ai/api-reference/v3/notes/get-organizations-knowledge-note.md): Get a note by ID for an organization. - [Get knowledge folder structure with note counts.](https://docs.devin.ai/api-reference/v3/notes/organizations-knowledge-folders.md): Return the full folder tree with per-folder note counts. - [List org-level notes](https://docs.devin.ai/api-reference/v3/notes/organizations-knowledge-notes.md): List notes for an organization. - [Create an enterprise-level note](https://docs.devin.ai/api-reference/v3/notes/post-enterprise-knowledge-notes.md) - [Create an org-level note](https://docs.devin.ai/api-reference/v3/notes/post-organizations-knowledge-notes.md): Create a note for an organization. - [Update a note](https://docs.devin.ai/api-reference/v3/notes/put-enterprise-knowledge-notes-note-id.md) - [Update an org-level note](https://docs.devin.ai/api-reference/v3/notes/put-organizations-knowledge-notes-note-id.md): Update a note for an organization. - [Get Organization Group Limits](https://docs.devin.ai/api-reference/v3/org-group-limits/get-org-group-limits.md): Get the current organization groups configuration - [Update Organization Group Limits](https://docs.devin.ai/api-reference/v3/org-group-limits/update-org-group-limits.md): Update the organization groups configuration - [Delete Organization](https://docs.devin.ai/api-reference/v3/organizations/delete-organizations.md): Delete an organization from this enterprise - [Get Organization](https://docs.devin.ai/api-reference/v3/organizations/get-enterprise-organization.md): Get details for a specific organization in the enterprise. - [List Organizations](https://docs.devin.ai/api-reference/v3/organizations/organizations.md): List organizations in the enterprise. - [Update Organization](https://docs.devin.ai/api-reference/v3/organizations/patch-organizations.md): Update an organization's name and/or ACU limits - [Create Organization](https://docs.devin.ai/api-reference/v3/organizations/post-organizations.md): Create a new organization in this enterprise - [Permissions & RBAC](https://docs.devin.ai/api-reference/v3/overview.md): Permission reference for the Devin API - [Delete a playbook](https://docs.devin.ai/api-reference/v3/playbooks/delete-enterprise-playbooks-playbook-id.md) - [Delete an org-level playbook](https://docs.devin.ai/api-reference/v3/playbooks/delete-organizations-playbooks-playbook-id.md): Delete a playbook for an organization. - [List all playbooks.](https://docs.devin.ai/api-reference/v3/playbooks/enterprise-playbooks.md) - [Get a playbook by ID.](https://docs.devin.ai/api-reference/v3/playbooks/get-enterprise-playbook.md): Get a specific playbook by ID. - [Get an org-level playbook by ID](https://docs.devin.ai/api-reference/v3/playbooks/get-organizations-playbook.md): Get a specific playbook by ID for an organization. - [List org-level playbooks](https://docs.devin.ai/api-reference/v3/playbooks/organizations-playbooks.md): List playbooks for an organization. - [Create an enterprise-level playbook](https://docs.devin.ai/api-reference/v3/playbooks/post-enterprise-playbooks.md) - [Create an org-level playbook](https://docs.devin.ai/api-reference/v3/playbooks/post-organizations-playbooks.md): Create a playbook for an organization. - [Update a playbook](https://docs.devin.ai/api-reference/v3/playbooks/put-enterprise-playbooks-playbook-id.md) - [Update an org-level playbook](https://docs.devin.ai/api-reference/v3/playbooks/put-organizations-playbooks-playbook-id.md): Update a playbook for an organization. - [Get Queue](https://docs.devin.ai/api-reference/v3/queue/enterprise-queue.md): Get the queue status for an enterprise. - [List Roles](https://docs.devin.ai/api-reference/v3/roles/roles.md): Get roles for this enterprise - [Delete schedule](https://docs.devin.ai/api-reference/v3/schedules/delete-organizations-schedule.md): Soft delete a schedule. - [Get schedule](https://docs.devin.ai/api-reference/v3/schedules/get-organizations-schedule.md): Get a specific schedule by ID. - [List schedules](https://docs.devin.ai/api-reference/v3/schedules/organizations-schedules.md): List all schedules for the organization. - [Update schedule](https://docs.devin.ai/api-reference/v3/schedules/patch-organizations-schedule.md): Update an existing schedule. - [Create schedule](https://docs.devin.ai/api-reference/v3/schedules/post-organizations-schedules.md): Create a new scheduled session. - [Delete an org-level secret](https://docs.devin.ai/api-reference/v3/secrets/delete-organizations-secrets.md): Delete a secret for an organization. - [List org-level secrets](https://docs.devin.ai/api-reference/v3/secrets/organizations-secrets.md): List secrets for an organization. - [Create an org-level secret](https://docs.devin.ai/api-reference/v3/secrets/post-organizations-secrets.md): Create a secret for an organization. - [Get Self](https://docs.devin.ai/api-reference/v3/self/self.md) - [Revoke API key for service user](https://docs.devin.ai/api-reference/v3/service-users/delete-enterprise-service-user-api-key.md): Revoke an API key for a service user. - [Delete Service User](https://docs.devin.ai/api-reference/v3/service-users/delete-members-service-users.md) - [Delete Organization Service User](https://docs.devin.ai/api-reference/v3/service-users/delete-organizations-members-service-users.md): Remove service user from the organization. - [List API keys for service user](https://docs.devin.ai/api-reference/v3/service-users/get-enterprise-service-user-api-keys.md): List API keys for a service user, optionally filtered by status. - [Get Service User](https://docs.devin.ai/api-reference/v3/service-users/get-members-service-user.md): Get a service user by ID. - [List Service Users](https://docs.devin.ai/api-reference/v3/service-users/members-service-users.md): List service users in the enterprise. - [List Organization Service Users](https://docs.devin.ai/api-reference/v3/service-users/organizations-members-service-users.md): List service users in the organization. - [Update Service User](https://docs.devin.ai/api-reference/v3/service-users/patch-members-service-users.md): Update enterprise role for service user. - [Update Organization Service User](https://docs.devin.ai/api-reference/v3/service-users/patch-organizations-members-service-users.md): Update organization role for service user. - [Create API key for service user](https://docs.devin.ai/api-reference/v3/service-users/post-enterprise-service-user-api-keys.md): Create a new API key for a service user. - [Assign Service User](https://docs.devin.ai/api-reference/v3/service-users/post-members-service-users.md): Assign enterprise role to service user. - [Assign Organization Service User](https://docs.devin.ai/api-reference/v3/service-users/post-organizations-members-service-users.md): Assign organization role to service user. - [Rotate API key for service user](https://docs.devin.ai/api-reference/v3/service-users/rotate-enterprise-service-user-api-key.md): Rotate an API key for a service user. - [Terminate Session](https://docs.devin.ai/api-reference/v3/sessions/delete-organizations-sessions.md): Terminate session - [List sessions for account](https://docs.devin.ai/api-reference/v3/sessions/enterprise-sessions.md): List all sessions across the enterprise. - [List sessions with insights](https://docs.devin.ai/api-reference/v3/sessions/enterprise-sessions-insights.md): List sessions with detailed insights including message counts, session size classification, and AI-generated analysis. - [Get session details](https://docs.devin.ai/api-reference/v3/sessions/get-enterprise-session.md): Get details of a specific session. - [List session attachments](https://docs.devin.ai/api-reference/v3/sessions/get-enterprise-session-attachments.md): List all attachments for a session. - [Get session insights](https://docs.devin.ai/api-reference/v3/sessions/get-enterprise-session-insights.md): Get detailed insights for a specific session, including message counts, session size classification, and AI-generated analysis. - [List session messages](https://docs.devin.ai/api-reference/v3/sessions/get-enterprise-session-messages.md): List all messages for a session with cursor-based pagination, ordered chronologically. - [Get session tags](https://docs.devin.ai/api-reference/v3/sessions/get-enterprise-session-tags.md): Get the tags for a specific session. - [Get Session](https://docs.devin.ai/api-reference/v3/sessions/get-organizations-session.md): Get details of a specific session. - [List session attachments](https://docs.devin.ai/api-reference/v3/sessions/get-organizations-session-attachments.md): List all attachments for a session. - [Get session insights](https://docs.devin.ai/api-reference/v3/sessions/get-organizations-session-insights.md): Get detailed insights for a specific session, including message counts, session size classification, and AI-generated analysis. - [List session messages](https://docs.devin.ai/api-reference/v3/sessions/get-organizations-session-messages.md): List all messages for a session with cursor-based pagination, ordered chronologically. - [Get session tags](https://docs.devin.ai/api-reference/v3/sessions/get-organizations-session-tags.md): Get the tags for a specific session. - [List Sessions](https://docs.devin.ai/api-reference/v3/sessions/organizations-sessions.md): List sessions. - [List sessions with insights](https://docs.devin.ai/api-reference/v3/sessions/organizations-sessions-insights.md): List sessions with detailed insights including message counts, session size classification, and AI-generated analysis. - [Generate session insights](https://docs.devin.ai/api-reference/v3/sessions/post-enterprise-session-insights-generate.md): Trigger on-demand generation of session insights. - [Append session tags](https://docs.devin.ai/api-reference/v3/sessions/post-enterprise-session-tags.md): Append tags to a session (deduplicating with existing tags). - [Send a message to a session](https://docs.devin.ai/api-reference/v3/sessions/post-enterprise-sessions-messages.md): Send a message to an active session. The session will be automatically resumed if suspended. - [Generate session insights](https://docs.devin.ai/api-reference/v3/sessions/post-organizations-session-insights-generate.md): Trigger on-demand generation of session insights. - [Append session tags](https://docs.devin.ai/api-reference/v3/sessions/post-organizations-session-tags.md): Append tags to a session (deduplicating with existing tags). - [Create Session](https://docs.devin.ai/api-reference/v3/sessions/post-organizations-sessions.md): Create a new session - [Archive Session](https://docs.devin.ai/api-reference/v3/sessions/post-organizations-sessions-archive.md): Archive session and put it to sleep if currently running - [Send a message to a session](https://docs.devin.ai/api-reference/v3/sessions/post-organizations-sessions-messages.md): Send a message to an active session. The session will be automatically resumed if suspended. - [Replace session tags](https://docs.devin.ai/api-reference/v3/sessions/put-enterprise-session-tags.md): Replace all tags on a session. - [Replace session tags](https://docs.devin.ai/api-reference/v3/sessions/put-organizations-session-tags.md): Replace all tags on a session. - [Clear Organization Default Tag](https://docs.devin.ai/api-reference/v3/tags/delete-enterprise-organizations-default-tag.md): Clear the default tag for an organization. - [Clear Organization Tags](https://docs.devin.ai/api-reference/v3/tags/delete-organizations-tags.md): Clear all allowed session tags for an organization. - [Remove Organization Tag](https://docs.devin.ai/api-reference/v3/tags/delete-organizations-tags-tag.md): Remove a single tag from the allowed session tags for an organization. - [Get Organization Default Tag](https://docs.devin.ai/api-reference/v3/tags/get-enterprise-organizations-default-tag.md): Get the current default tag for an organization. - [Get Organization Allowed Tags](https://docs.devin.ai/api-reference/v3/tags/organizations-tags.md): Get the allowed session tags for an organization. - [Append Organization Tags](https://docs.devin.ai/api-reference/v3/tags/post-organizations-tags.md): Append tags to the allowed session tags for an organization. - [Set Organization Default Tag](https://docs.devin.ai/api-reference/v3/tags/put-enterprise-organizations-default-tag.md): Set the default tag for an organization. The tag must exist in the allowed tags list. - [Replace Organization Allowed Tags](https://docs.devin.ai/api-reference/v3/tags/put-organizations-tags.md): Replace the full set of allowed session tags for an organization. - [Delete User](https://docs.devin.ai/api-reference/v3/users/delete-members-users.md) - [Delete Organization User](https://docs.devin.ai/api-reference/v3/users/delete-organizations-members-users.md) - [Get User](https://docs.devin.ai/api-reference/v3/users/get-members-user.md): Get a user by ID. Returns both direct and IDP-group-derived role assignments. - [List IDP Group Users](https://docs.devin.ai/api-reference/v3/users/members-idp-users.md): List users whose enterprise membership is derived from IDP group assignments. - [List Users](https://docs.devin.ai/api-reference/v3/users/members-users.md) - [List Organization IDP Group Users](https://docs.devin.ai/api-reference/v3/users/organizations-members-idp-users.md): List users whose organization membership is derived from IDP group assignments. - [List Organization Users](https://docs.devin.ai/api-reference/v3/users/organizations-members-users.md) - [Update User](https://docs.devin.ai/api-reference/v3/users/patch-members-users.md) - [Update Organization User](https://docs.devin.ai/api-reference/v3/users/patch-organizations-members-users.md) - [Invite Users](https://docs.devin.ai/api-reference/v3/users/post-members-users.md) - [Assign Organization User](https://docs.devin.ai/api-reference/v3/users/post-organizations-members-users.md) - [Importing Code Settings](https://docs.devin.ai/collaborate-with-devin/vscode-profiles.md): Use your local settings and extensions while working in Devin's IDE - [Dedicated SaaS Private Networking](https://docs.devin.ai/enterprise/deployment/dedicated_saas_private_networking.md) - [Enterprise Deployment](https://docs.devin.ai/enterprise/deployment/overview.md): Learn about Devin's enterprise deployment options: SaaS and Dedicated SaaS architectures. - [Getting Started with Devin Enterprise](https://docs.devin.ai/enterprise/getting-started/get-started.md): Step-by-step guide for configuring Devin Enterprise, including organizations, user roles, SSO, and integrations. - [Understanding Organizations](https://docs.devin.ai/enterprise/getting-started/organizations.md): Learn how to structure and manage organizations in Devin Enterprise - [Artifacts](https://docs.devin.ai/enterprise/integrations/artifacts/overview.md): Accessing Your Artifacts - [Azure DevOps](https://docs.devin.ai/enterprise/integrations/azure-devops.md): Work with Devin directly in your Azure DevOps repositories - [Git Integrations](https://docs.devin.ai/enterprise/integrations/git-integrations.md): Connect Devin with your source code repositories - [GitHub Enterprise Server Integration](https://docs.devin.ai/enterprise/integrations/github-enterprise-server.md): Work with Devin directly in your GitHub Enterprise Server repos - [Custom Roles & RBAC](https://docs.devin.ai/enterprise/security-access/custom-roles.md): Configure fine-grained access control with custom roles and role-based access control (RBAC) in Devin Enterprise. - [IdP Group Integration](https://docs.devin.ai/enterprise/security-access/idp-groups.md): Configure Identity Provider (IdP) group integration for streamlined user access management in Devin Enterprise. - [IP Access Lists](https://docs.devin.ai/enterprise/security-access/ip-access-lists.md): Restrict API and webapp access to specific IP addresses or CIDR ranges - [Enterprise security](https://docs.devin.ai/enterprise/security-access/security/enterprise-security.md) - [Azure AD SSO Setup](https://docs.devin.ai/enterprise/security-access/sso/azure.md): Configure Single Sign-On with Azure AD (Entra ID) - [OIDC SSO Setup](https://docs.devin.ai/enterprise/security-access/sso/oidc.md): Configure Single Sign-On with a Generic OpenID Connect Identity Provider - [Okta SSO Setup](https://docs.devin.ai/enterprise/security-access/sso/okta.md): Configure Single Sign-On with Okta - [SAML SSO Setup](https://docs.devin.ai/enterprise/security-access/sso/saml.md): Configure Single Sign-On with a SAML Identity Provider - [Trust Center](https://docs.devin.ai/enterprise/security-access/trust-center.md): Security practices, compliance certifications, and data privacy commitments - [Good vs. Bad Instructions](https://docs.devin.ai/essential-guidelines/good-vs-bad-instructions.md): What works and what doesn't - [Instructing Devin Effectively](https://docs.devin.ai/essential-guidelines/instructing-devin-effectively.md): How to achieve optimal results. - [How does Devin fit into my existing SDLC?](https://docs.devin.ai/essential-guidelines/sdlc-integration.md): Understanding how Devin integrates with your software development lifecycle - [When to Use Devin](https://docs.devin.ai/essential-guidelines/when-to-use-devin.md) - [Introducing Devin](https://docs.devin.ai/get-started/devin-intro.md): Devin is the AI software engineer, built to help ambitious engineering teams crush their backlogs. - [Your First Session](https://docs.devin.ai/get-started/first-run.md): Start your first session and see what Devin can do - [Bitbucket](https://docs.devin.ai/integrations/bitbucket.md): Work with Devin directly in your Bitbucket repositories - [GitHub](https://docs.devin.ai/integrations/gh.md): Work with Devin directly in your repos - [GitLab](https://docs.devin.ai/integrations/gitlab.md): Work with Devin directly in your GitLab repositories - [Jira](https://docs.devin.ai/integrations/jira.md): Assign Jira tickets to Devin and turn them into PRs - [Linear](https://docs.devin.ai/integrations/linear.md): Assign Linear tickets to Devin and turn them into PRs - [Microsoft Teams](https://docs.devin.ai/integrations/microsoft-teams.md): Chat and collaborate with Devin directly in Microsoft Teams - [Integrations Overview](https://docs.devin.ai/integrations/overview.md): Connect Devin to your existing tools and workflows - [GitHub Pull Request Templates](https://docs.devin.ai/integrations/pr-templates.md): How Devin discovers and uses GitHub-style pull request templates, including the custom Devin template filename. - [Self-Hosted SCM & Artifacts](https://docs.devin.ai/integrations/self-hosted-scm-artifacts.md): Connect Devin SaaS to your self-hosted source code management and artifact repositories - [Slack](https://docs.devin.ai/integrations/slack.md): Chat and collaborate with Devin directly in your company Slack - [Tutorial Library](https://docs.devin.ai/learn-about-devin/workflows.md): Videos on how to use Devin by the team - [AGENTS.md](https://docs.devin.ai/onboard-devin/agents-md.md): Add AGENTS.md files to provide context and instructions for Devin - [Index a Repository](https://docs.devin.ai/onboard-devin/index-repo.md): Enable Ask Devin and DeepWiki by indexing your repositories - [Knowledge Onboarding](https://docs.devin.ai/onboard-devin/knowledge-onboarding.md): Knowledge is a collection of instructions and advice that Devin can reference in all sessions. Think of it as onboarding a new employee with the relevant organizational context. - [Repo Setup](https://docs.devin.ai/onboard-devin/repo-setup.md): Set up Devin's Machine to start building - [VPN Configuration](https://docs.devin.ai/onboard-devin/vpn.md): Configure VPN access for Devin to connect to your internal network - [Autofix Settings - Bot Comments](https://docs.devin.ai/product-guides/bot-comment-settings.md): Control which bots Devin responds to on pull requests - [Creating Playbooks](https://docs.devin.ai/product-guides/creating-playbooks.md): Build a library of reusable prompts for your organization - [Deployments](https://docs.devin.ai/product-guides/deployment-capabilities.md): Devin's abilities and limitations in deploying frontend and backend applications. - [Invite your Team](https://docs.devin.ai/product-guides/invite-team.md): Only available for Team and Enterprise plans - [Knowledge](https://docs.devin.ai/product-guides/knowledge.md): Share important context and knowledge to help Devin get onboarded - [Scheduled Sessions](https://docs.devin.ai/product-guides/scheduled-sessions.md): Automate recurring or one-time Devin sessions that run on a schedule - [Secrets & Site Cookies](https://docs.devin.ai/product-guides/secrets.md): Securely share credentials with Devin so it can access any tool - [Session Insights](https://docs.devin.ai/product-guides/session-insights.md): Analyze your Devin sessions and get actionable feedback to improve future interactions - [Skills](https://docs.devin.ai/product-guides/skills.md): Teach Devin reusable procedures by committing SKILL.md files to your repos - [Using Playbooks](https://docs.devin.ai/product-guides/using-playbooks.md) - [2024](https://docs.devin.ai/release-notes/2024.md) - [2025](https://docs.devin.ai/release-notes/2025.md) - [2026](https://docs.devin.ai/release-notes/2026.md) - [Recent Updates](https://docs.devin.ai/release-notes/overview.md) - [Best Practices](https://docs.devin.ai/use-cases/best-practices.md): How to structure work for Devin to maximize efficiency and ROI - [Data & Analysis](https://docs.devin.ai/use-cases/data-analysis.md) - [Clear Engineering Backlogs](https://docs.devin.ai/use-cases/examples/clear-engineering-backlogs.md): Let Devin tackle your engineering backlogs - [COBOL Modernization](https://docs.devin.ai/use-cases/examples/cobol-modernization.md): Modernize legacy COBOL systems to contemporary technologies - [Java Upgrades](https://docs.devin.ai/use-cases/examples/java-upgrades.md): Upgrade your Java applications to the latest versions with ease - [JavaScript to TypeScript Migration](https://docs.devin.ai/use-cases/examples/javascript-to-typescript.md): Migrate JavaScript codebases to TypeScript for improved type safety and developer experience - [NoSQL to SQL Migration](https://docs.devin.ai/use-cases/examples/nosql-to-sql.md): Migrate from NoSQL databases to SQL for improved data consistency and relational integrity - [SAS to PySpark Migration](https://docs.devin.ai/use-cases/examples/sas-to-pyspark.md): Migrate SAS analytics workflows to modern PySpark infrastructure - [Use Cases](https://docs.devin.ai/use-cases/gallery/index.md) - [Overview](https://docs.devin.ai/use-cases/index.md): Proven use cases deployed across hundreds of enterprises - [Interactive Applications](https://docs.devin.ai/use-cases/interactive-applications.md) - [Migration & Modernization](https://docs.devin.ai/use-cases/migration-modernization.md) - [Testing & Refactoring](https://docs.devin.ai/use-cases/testing-refactoring.md) - [API Integration](https://docs.devin.ai/use-cases/tutorials/api-integration.md): Devin can integrate, configure, and test third party APIs in your applications. - [Code Coverage](https://docs.devin.ai/use-cases/tutorials/code-coverage.md): Devin can analyze your codebase's test suite and write additional tests to increase code coverage for your team. - [Containerization](https://docs.devin.ai/use-cases/tutorials/containerization.md): In this tutorial, we’ll show you how Devin can configure a Docker container to standardize your team’s dev environment. - [Managing Frontend Components](https://docs.devin.ai/use-cases/tutorials/frontend-components.md): Devin can work with frontend libraries and share visuals with you during its sessions. - [MCP Use Cases](https://docs.devin.ai/use-cases/tutorials/mcp-use-cases.md) - [Web Scraping & Automation](https://docs.devin.ai/use-cases/web-scraping.md) - [Advanced Capabilities](https://docs.devin.ai/work-with-devin/advanced-capabilities.md): Devin can orchestrate managed sessions, analyze past work, create playbooks, and manage your knowledge base - [Ask Devin](https://docs.devin.ai/work-with-devin/ask-devin.md): Use Ask Devin to ask questions about your codebase, plan tasks, and generate high-context sessions - [Computer Use](https://docs.devin.ai/work-with-devin/computer-use.md): How Devin uses a full desktop environment to interact with GUIs, test applications, and visually verify changes - [Data Analyst Agent](https://docs.devin.ai/work-with-devin/data-analyst.md): Use the Data Analyst agent for fast database queries, data analysis, and visualizations - [DeepWiki](https://docs.devin.ai/work-with-devin/deepwiki.md): Architecture diagrams, documentation, links to sources, and more for all your repos - [DeepWiki MCP](https://docs.devin.ai/work-with-devin/deepwiki-mcp.md): How to use the official DeepWiki MCP server - [Devin MCP](https://docs.devin.ai/work-with-devin/devin-mcp.md): How to use the official Devin MCP server for private and public repositories - [Devin Review](https://docs.devin.ai/work-with-devin/devin-review.md): A new way to quickly review and understand complex PRs. - [Devin Session Tools](https://docs.devin.ai/work-with-devin/devin-session-tools.md): Complete guide to Devin's IDE, Browser, and Shell tools - [MCP (Model Context Protocol) Marketplace](https://docs.devin.ai/work-with-devin/mcp.md) - [Slash Commands](https://docs.devin.ai/work-with-devin/slash-commands.md): Use slash commands to quickly insert predefined text prompt templates and streamline your workflow with Devin - [Testing & Video Recordings](https://docs.devin.ai/work-with-devin/testing-and-recordings.md): How Devin tests your changes end-to-end and sends you video recordings as proof ## OpenAPI Specs - [v3-openapi](https://docs.devin.ai/v3-openapi.yaml) - [v2-openapi](https://docs.devin.ai/v2-openapi.yaml) - [v1-openapi](https://docs.devin.ai/v1-openapi.yaml) - [package-lock](https://docs.devin.ai/package-lock.json)