Skip to main content
The v1 API is being deprecated in favor of the Organization API which provides role-based access control, session attribution, and new features like cursor-based pagination. See the migration guide for step-by-step instructions.
The v1 API provides core functionality for creating and managing Devin sessions, along with supporting resources like secrets, knowledge, and playbooks. Base URL: https://api.devin.ai/v1/* Authentication: Personal or Service API Keys (learn more)

Permissions

The v1 API uses organization-scoped authentication. API keys are scoped to a specific (org_id, user_id) pair and provide access to resources within that organization. The v1 API does not use the full RBAC permission system - access is determined by the API key’s organization scope. For fine-grained RBAC control, use the Organization API instead.

Sessions

Manage Devin sessions and interact with them:

List Sessions

List all current Devin sessions for your organization

Create a Session

Start a new Devin session with a task description and optional parameters

Get Session Details

Retrieve information about an existing session’s status and output

Send Message

Interact with an active session by sending messages to Devin

Upload Files

Upload files for Devin to work with during sessions

Update Session Tags

Update the tags associated with a Devin session

Secrets

Manage secrets and credentials for your organization:

List Secrets

View metadata for all secrets in your organization

Delete Secret

Permanently remove a secret from your organization

Knowledge

Manage knowledge for your organization:

List Knowledge

List all knowledge and folders in your organization

Create Knowledge

Create a new piece of knowledge

Update Knowledge

Update a piece of knowledge

Delete Knowledge

Delete a piece of knowledge

Playbooks

Manage reusable instruction sets for your organization:

List Playbooks

View all playbooks accessible to your organization

Create Playbook

Create a new team playbook with instructions and optional macro

Get Playbook

Retrieve details of a specific playbook

Update Playbook

Update an existing team playbook

Delete Playbook

Delete a team playbook from your organization

Next steps

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