Devin

Usage Instructions

Integrate Devin into your workflow. Create sessions to assign coding tasks, send messages to guide active sessions, and retrieve session status and results. Devin autonomously writes, runs, and tests code.

Tools

`devin_create_session`

Create a new Devin session with a prompt. Devin will autonomously work on the task described in the prompt.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`prompt`	string	Yes	No description
`playbookId`	string	No	No description
`maxAcuLimit`	number	No	No description
`tags`	string	No	No description

Output

Parameter	Type	Description
`sessionId`	string	Unique identifier for the session
`url`	string	URL to view the session in the Devin UI
`status`	string	Session status (new, claimed, running, exit, error, suspended, resuming)
`statusDetail`	string	Detailed status (working, waiting_for_user, waiting_for_approval, finished, inactivity, etc.)
`title`	string	Session title
`createdAt`	number	Unix timestamp when the session was created
`updatedAt`	number	Unix timestamp when the session was last updated
`acusConsumed`	number	ACUs consumed by the session
`tags`	json	Tags associated with the session
`pullRequests`	json	Pull requests created during the session
`structuredOutput`	json	Structured output from the session
`playbookId`	string	Associated playbook ID

`devin_get_session`

Retrieve details of an existing Devin session including status, tags, pull requests, and structured output.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`sessionId`	string	Yes	No description

Output

Parameter	Type	Description
`sessionId`	string	Unique identifier for the session
`url`	string	URL to view the session in the Devin UI
`status`	string	Session status (new, claimed, running, exit, error, suspended, resuming)
`statusDetail`	string	Detailed status (working, waiting_for_user, waiting_for_approval, finished, inactivity, etc.)
`title`	string	Session title
`createdAt`	number	Unix timestamp when the session was created
`updatedAt`	number	Unix timestamp when the session was last updated
`acusConsumed`	number	ACUs consumed by the session
`tags`	json	Tags associated with the session
`pullRequests`	json	Pull requests created during the session
`structuredOutput`	json	Structured output from the session
`playbookId`	string	Associated playbook ID

`devin_list_sessions`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`limit`	number	No	No description

Output

Parameter	Type	Description
`sessions`	array	List of Devin sessions
↳ `sessionId`	string	Unique identifier for the session
↳ `url`	string	URL to view the session
↳ `status`	string	Session status
↳ `statusDetail`	string	Detailed status
↳ `title`	string	Session title
↳ `createdAt`	number	Creation timestamp (Unix)
↳ `updatedAt`	number	Last updated timestamp (Unix)
↳ `tags`	json	Session tags

`devin_send_message`

Send a message to a Devin session. If the session is suspended, it will be automatically resumed. Returns the updated session state.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`sessionId`	string	Yes	No description
`message`	string	Yes	No description

Output

Parameter	Type	Description
`sessionId`	string	Unique identifier for the session
`url`	string	URL to view the session in the Devin UI
`status`	string	Session status (new, claimed, running, exit, error, suspended, resuming)
`statusDetail`	string	Detailed status (working, waiting_for_user, waiting_for_approval, finished, inactivity, etc.)
`title`	string	Session title
`createdAt`	number	Unix timestamp when the session was created
`updatedAt`	number	Unix timestamp when the session was last updated
`acusConsumed`	number	ACUs consumed by the session
`tags`	json	Tags associated with the session
`pullRequests`	json	Pull requests created during the session
`structuredOutput`	json	Structured output from the session
`playbookId`	string	Associated playbook ID

Devin

On this page