Devin

Use Devin to assign coding tasks and manage their sessions from a workflow. Create Session accepts a prompt, optional playbook, ACU (Autonomous Compute Unit) limit, and tags.

Use Get Session to poll status before consuming pull requests or structured output; session details also report resource use. List Sessions supports pagination. Send Message supplies context or redirects an active session and resumes suspended sessions automatically. Set an ACU limit when you need a spending boundary.

Use the block

Create coding sessions, list or inspect their status and results, and send messages to guide active or suspended work. Use playbooks and ACU limits for repeatable tasks and spending control.

Actions

Devin Create Session

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

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Devin API key (service user credential starting with cog_)
orgId	string	Yes	Devin organization ID (prefixed with org-)
prompt	string	Yes	The task prompt for Devin to work on
playbookId	string	No	Optional playbook ID to guide the session
maxAcuLimit	number	No	Maximum ACU limit for the session
tags	string	No	Comma-separated tags for the session

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 (array of strings)
pullRequests	json	Pull requests created during the session ([{pr_url, pr_state}])
structuredOutput	json	Structured output from the session
playbookId	string	Associated playbook ID
isArchived	boolean	Whether the session is archived

Devin Get Session

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

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Devin API key (service user credential starting with cog_)
orgId	string	Yes	Devin organization ID (prefixed with org-)
sessionId	string	Yes	The session ID to retrieve

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 (array of strings)
pullRequests	json	Pull requests created during the session ([{pr_url, pr_state}])
structuredOutput	json	Structured output from the session
playbookId	string	Associated playbook ID
isArchived	boolean	Whether the session is archived

Devin List Sessions

List Devin sessions in the organization. Returns up to 100 sessions by default.

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Devin API key (service user credential starting with cog_)
orgId	string	Yes	Devin organization ID (prefixed with org-)
limit	number	No	Maximum number of sessions to return (1-200, default: 100)
after	string	No	Pagination cursor (endCursor from a previous response) to fetch the next page

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 (array of strings)
↳ acusConsumed	number	ACUs consumed by the session
↳ pullRequests	json	Pull requests created during the session ([{pr_url, pr_state}])
↳ playbookId	string	Associated playbook ID
↳ isArchived	boolean	Whether the session is archived
endCursor	string	Pagination cursor for the next page, or null if last page
hasNextPage	boolean	Whether more sessions are available
total	number	Total number of sessions, if provided

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.

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Devin API key (service user credential starting with cog_)
orgId	string	Yes	Devin organization ID (prefixed with org-)
sessionId	string	Yes	The session ID to send the message to
message	string	Yes	The message to send to Devin

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 (array of strings)
pullRequests	json	Pull requests created during the session ([{pr_url, pr_state}])
structuredOutput	json	Structured output from the session
playbookId	string	Associated playbook ID
isArchived	boolean	Whether the session is archived

Devin List Session Messages

List the messages exchanged in a Devin session, including messages from both the user and Devin.

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Devin API key (service user credential starting with cog_)
orgId	string	Yes	Devin organization ID (prefixed with org-)
sessionId	string	Yes	The session ID to list messages for
limit	number	No	Maximum number of messages to return (1-200, default: 100)
after	string	No	Pagination cursor (endCursor from a previous response) to fetch the next page

Output

Parameter	Type	Description
messages	array	Messages exchanged in the session
↳ eventId	string	Unique identifier for the message event
↳ source	string	Origin of the message (devin or user)
↳ message	string	The message content
↳ createdAt	number	Unix timestamp when the message was created
endCursor	string	Pagination cursor for the next page, or null if last page
hasNextPage	boolean	Whether more messages are available
total	number	Total number of messages, if provided

Devin List Session Attachments

List the files uploaded to or produced by a Devin session.

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Devin API key (service user credential starting with cog_)
orgId	string	Yes	Devin organization ID (prefixed with org-)
sessionId	string	Yes	The session ID to list attachments for

Output

Parameter	Type	Description
attachments	array	Attachments associated with the session
↳ attachmentId	string	Unique identifier for the attachment
↳ name	string	Attachment file name
↳ url	string	URL to download the attachment
↳ source	string	Origin of the attachment (devin or user)
↳ contentType	string	MIME type of the attachment

Devin Get Session Tags

Retrieve the tags currently applied to a Devin session.

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Devin API key (service user credential starting with cog_)
orgId	string	Yes	Devin organization ID (prefixed with org-)
sessionId	string	Yes	The session ID to retrieve tags for

Output

Parameter	Type	Description
tags	json	Tags applied to the session (array of strings)

Devin Append Session Tags

Add tags to a Devin session without removing existing tags (max 50 tags total).

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Devin API key (service user credential starting with cog_)
orgId	string	Yes	Devin organization ID (prefixed with org-)
sessionId	string	Yes	The session ID to add tags to
tags	string	Yes	Tags to append to the session (comma-separated string or array of strings)

Output

Parameter	Type	Description
tags	json	Updated list of tags on the session (array of strings)

Devin Replace Session Tags

Replace all tags on a Devin session with a new set of tags (max 50 tags).

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Devin API key (service user credential starting with cog_)
orgId	string	Yes	Devin organization ID (prefixed with org-)
sessionId	string	Yes	The session ID to replace tags on
tags	string	Yes	Tags that will overwrite the existing tags (comma-separated string or array of strings)

Output

Parameter	Type	Description
tags	json	Updated list of tags on the session (array of strings)

Devin Archive Session

Archive a Devin session. Archived sessions can still be viewed but cannot be modified or resumed.

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Devin API key (service user credential starting with cog_)
orgId	string	Yes	Devin organization ID (prefixed with org-)
sessionId	string	Yes	The session ID to archive

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 (array of strings)
pullRequests	json	Pull requests created during the session ([{pr_url, pr_state}])
structuredOutput	json	Structured output from the session
playbookId	string	Associated playbook ID
isArchived	boolean	Whether the session is archived

Devin Terminate Session

Terminate a Devin session. Optionally archive the session instead of permanently terminating it.

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Devin API key (service user credential starting with cog_)
orgId	string	Yes	Devin organization ID (prefixed with org-)
sessionId	string	Yes	The session ID to terminate
archive	boolean	No	Archive the session instead of permanently terminating it (default: false)

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 (array of strings)
pullRequests	json	Pull requests created during the session ([{pr_url, pr_state}])
structuredOutput	json	Structured output from the session
playbookId	string	Associated playbook ID
isArchived	boolean	Whether the session is archived