Authentication
Connect to Devin with a service user API key. Create a service user under Settings → Service users, give it a role with theManageOrgSessions and ViewOrgSessions permissions, and generate a key. The key is only shown once.
Connection details
Both are on the Settings → Service users page. The organization ID is part of every
API path, so a wrong value fails the connection test the same way a wrong key does.
Devin actions
Launch agent
Create a Devin session and send it a task. Configuration
The Playbook dropdown lists the organization and enterprise playbooks your service
user can see. Preview Devin modes have to be enabled for your organization; leave the
field empty to use the organization default.
Output
The node completes as soon as the session is created — it does not wait for Devin to
finish. The Devin API has no callback to announce that a session finished, so there is
nothing to wait on without polling.
url, or read it back from the
Devin API with the sessionId.
Use cases
Automated code changes
Automated code changes
Turn a qualified request into a pull request without a human in the loop.
Codebase research
Codebase research
Ask Devin to investigate a repository and return structured findings.
Repeatable procedures
Repeatable procedures
Run a playbook per incoming item so every session follows the same steps.
Triage at scale
Triage at scale
Launch one session per incoming issue and collect the pull requests they open.
Best practices
- Give Devin a complete prompt - Nothing downstream is waiting to answer a follow-up question
- Use playbooks for repeated work - They keep sessions consistent across records
- Set a max ACU limit - It bounds what a single run can cost
- Tag sessions launched from Cargo - It makes them easy to find in reporting, and it is how you correlate a workflow run with the sessions it started

