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 v3 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
Usage Examples
View Code Examples
Check out our code examples and common use cases to get started quickly with the v1 API