@@ -50,6 +50,7 @@ Create a new Devin session with a prompt. Devin will autonomously work on the ta
5050| Parameter | Type | Required | Description |
5151| --------- | ---- | -------- | ----------- |
5252| ` apiKey ` | string | Yes | Devin API key \( service user credential starting with cog_ \) |
53+ | ` orgId ` | string | Yes | Devin organization ID \( prefixed with org-\) |
5354| ` prompt ` | string | Yes | The task prompt for Devin to work on |
5455| ` playbookId ` | string | No | Optional playbook ID to guide the session |
5556| ` maxAcuLimit ` | number | No | Maximum ACU limit for the session |
@@ -67,10 +68,11 @@ Create a new Devin session with a prompt. Devin will autonomously work on the ta
6768| ` createdAt ` | number | Unix timestamp when the session was created |
6869| ` updatedAt ` | number | Unix timestamp when the session was last updated |
6970| ` acusConsumed ` | number | ACUs consumed by the session |
70- | ` tags ` | json | Tags associated with the session |
71- | ` pullRequests ` | json | Pull requests created during the session |
71+ | ` tags ` | json | Tags associated with the session \( array of strings \) |
72+ | ` pullRequests ` | json | Pull requests created during the session \(\[\{ pr_url, pr_state \}\]\) |
7273| ` structuredOutput ` | json | Structured output from the session |
7374| ` playbookId ` | string | Associated playbook ID |
75+ | ` isArchived ` | boolean | Whether the session is archived |
7476
7577### ` devin_get_session `
7678
@@ -81,6 +83,7 @@ Retrieve details of an existing Devin session including status, tags, pull reque
8183| Parameter | Type | Required | Description |
8284| --------- | ---- | -------- | ----------- |
8385| ` apiKey ` | string | Yes | Devin API key \( service user credential starting with cog_ \) |
86+ | ` orgId ` | string | Yes | Devin organization ID \( prefixed with org-\) |
8487| ` sessionId ` | string | Yes | The session ID to retrieve |
8588
8689#### Output
@@ -95,10 +98,11 @@ Retrieve details of an existing Devin session including status, tags, pull reque
9598| ` createdAt ` | number | Unix timestamp when the session was created |
9699| ` updatedAt ` | number | Unix timestamp when the session was last updated |
97100| ` acusConsumed ` | number | ACUs consumed by the session |
98- | ` tags ` | json | Tags associated with the session |
99- | ` pullRequests ` | json | Pull requests created during the session |
101+ | ` tags ` | json | Tags associated with the session \( array of strings \) |
102+ | ` pullRequests ` | json | Pull requests created during the session \(\[\{ pr_url, pr_state \}\]\) |
100103| ` structuredOutput ` | json | Structured output from the session |
101104| ` playbookId ` | string | Associated playbook ID |
105+ | ` isArchived ` | boolean | Whether the session is archived |
102106
103107### ` devin_list_sessions `
104108
@@ -109,7 +113,9 @@ List Devin sessions in the organization. Returns up to 100 sessions by default.
109113| Parameter | Type | Required | Description |
110114| --------- | ---- | -------- | ----------- |
111115| ` apiKey ` | string | Yes | Devin API key \( service user credential starting with cog_ \) |
116+ | ` orgId ` | string | Yes | Devin organization ID \( prefixed with org-\) |
112117| ` limit ` | number | No | Maximum number of sessions to return \( 1-200, default: 100\) |
118+ | ` after ` | string | No | Pagination cursor \( endCursor from a previous response\) to fetch the next page |
113119
114120#### Output
115121
@@ -123,7 +129,14 @@ List Devin sessions in the organization. Returns up to 100 sessions by default.
123129| ↳ ` title ` | string | Session title |
124130| ↳ ` createdAt ` | number | Creation timestamp \( Unix\) |
125131| ↳ ` updatedAt ` | number | Last updated timestamp \( Unix\) |
126- | ↳ ` tags ` | json | Session tags |
132+ | ↳ ` tags ` | json | Session tags \( array of strings\) |
133+ | ↳ ` acusConsumed ` | number | ACUs consumed by the session |
134+ | ↳ ` pullRequests ` | json | Pull requests created during the session \(\[\{ pr_url, pr_state\}\]\) |
135+ | ↳ ` playbookId ` | string | Associated playbook ID |
136+ | ↳ ` isArchived ` | boolean | Whether the session is archived |
137+ | ` endCursor ` | string | Pagination cursor for the next page, or null if last page |
138+ | ` hasNextPage ` | boolean | Whether more sessions are available |
139+ | ` total ` | number | Total number of sessions, if provided |
127140
128141### ` devin_send_message `
129142
@@ -134,6 +147,7 @@ Send a message to a Devin session. If the session is suspended, it will be autom
134147| Parameter | Type | Required | Description |
135148| --------- | ---- | -------- | ----------- |
136149| ` apiKey ` | string | Yes | Devin API key \( service user credential starting with cog_ \) |
150+ | ` orgId ` | string | Yes | Devin organization ID \( prefixed with org-\) |
137151| ` sessionId ` | string | Yes | The session ID to send the message to |
138152| ` message ` | string | Yes | The message to send to Devin |
139153
@@ -149,9 +163,177 @@ Send a message to a Devin session. If the session is suspended, it will be autom
149163| ` createdAt ` | number | Unix timestamp when the session was created |
150164| ` updatedAt ` | number | Unix timestamp when the session was last updated |
151165| ` acusConsumed ` | number | ACUs consumed by the session |
152- | ` tags ` | json | Tags associated with the session |
153- | ` pullRequests ` | json | Pull requests created during the session |
166+ | ` tags ` | json | Tags associated with the session \( array of strings \) |
167+ | ` pullRequests ` | json | Pull requests created during the session \(\[\{ pr_url, pr_state \}\]\) |
154168| ` structuredOutput ` | json | Structured output from the session |
155169| ` playbookId ` | string | Associated playbook ID |
170+ | ` isArchived ` | boolean | Whether the session is archived |
171+
172+ ### ` devin_list_session_messages `
173+
174+ List the messages exchanged in a Devin session, including messages from both the user and Devin.
175+
176+ #### Input
177+
178+ | Parameter | Type | Required | Description |
179+ | --------- | ---- | -------- | ----------- |
180+ | ` apiKey ` | string | Yes | Devin API key \( service user credential starting with cog_ \) |
181+ | ` orgId ` | string | Yes | Devin organization ID \( prefixed with org-\) |
182+ | ` sessionId ` | string | Yes | The session ID to list messages for |
183+ | ` limit ` | number | No | Maximum number of messages to return \( 1-200, default: 100\) |
184+ | ` after ` | string | No | Pagination cursor \( endCursor from a previous response\) to fetch the next page |
185+
186+ #### Output
187+
188+ | Parameter | Type | Description |
189+ | --------- | ---- | ----------- |
190+ | ` messages ` | array | Messages exchanged in the session |
191+ | ↳ ` eventId ` | string | Unique identifier for the message event |
192+ | ↳ ` source ` | string | Origin of the message \( devin or user\) |
193+ | ↳ ` message ` | string | The message content |
194+ | ↳ ` createdAt ` | number | Unix timestamp when the message was created |
195+ | ` endCursor ` | string | Pagination cursor for the next page, or null if last page |
196+ | ` hasNextPage ` | boolean | Whether more messages are available |
197+ | ` total ` | number | Total number of messages, if provided |
198+
199+ ### ` devin_list_session_attachments `
200+
201+ List the files uploaded to or produced by a Devin session.
202+
203+ #### Input
204+
205+ | Parameter | Type | Required | Description |
206+ | --------- | ---- | -------- | ----------- |
207+ | ` apiKey ` | string | Yes | Devin API key \( service user credential starting with cog_ \) |
208+ | ` orgId ` | string | Yes | Devin organization ID \( prefixed with org-\) |
209+ | ` sessionId ` | string | Yes | The session ID to list attachments for |
210+
211+ #### Output
212+
213+ | Parameter | Type | Description |
214+ | --------- | ---- | ----------- |
215+ | ` attachments ` | array | Attachments associated with the session |
216+ | ↳ ` attachmentId ` | string | Unique identifier for the attachment |
217+ | ↳ ` name ` | string | Attachment file name |
218+ | ↳ ` url ` | string | URL to download the attachment |
219+ | ↳ ` source ` | string | Origin of the attachment \( devin or user\) |
220+ | ↳ ` contentType ` | string | MIME type of the attachment |
221+
222+ ### ` devin_get_session_tags `
223+
224+ Retrieve the tags currently applied to a Devin session.
225+
226+ #### Input
227+
228+ | Parameter | Type | Required | Description |
229+ | --------- | ---- | -------- | ----------- |
230+ | ` apiKey ` | string | Yes | Devin API key \( service user credential starting with cog_ \) |
231+ | ` orgId ` | string | Yes | Devin organization ID \( prefixed with org-\) |
232+ | ` sessionId ` | string | Yes | The session ID to retrieve tags for |
233+
234+ #### Output
235+
236+ | Parameter | Type | Description |
237+ | --------- | ---- | ----------- |
238+ | ` tags ` | json | Tags applied to the session \( array of strings\) |
239+
240+ ### ` devin_append_session_tags `
241+
242+ Add tags to a Devin session without removing existing tags (max 50 tags total).
243+
244+ #### Input
245+
246+ | Parameter | Type | Required | Description |
247+ | --------- | ---- | -------- | ----------- |
248+ | ` apiKey ` | string | Yes | Devin API key \( service user credential starting with cog_ \) |
249+ | ` orgId ` | string | Yes | Devin organization ID \( prefixed with org-\) |
250+ | ` sessionId ` | string | Yes | The session ID to add tags to |
251+ | ` tags ` | string | Yes | Tags to append to the session \( comma-separated string or array of strings\) |
252+
253+ #### Output
254+
255+ | Parameter | Type | Description |
256+ | --------- | ---- | ----------- |
257+ | ` tags ` | json | Updated list of tags on the session \( array of strings\) |
258+
259+ ### ` devin_replace_session_tags `
260+
261+ Replace all tags on a Devin session with a new set of tags (max 50 tags).
262+
263+ #### Input
264+
265+ | Parameter | Type | Required | Description |
266+ | --------- | ---- | -------- | ----------- |
267+ | ` apiKey ` | string | Yes | Devin API key \( service user credential starting with cog_ \) |
268+ | ` orgId ` | string | Yes | Devin organization ID \( prefixed with org-\) |
269+ | ` sessionId ` | string | Yes | The session ID to replace tags on |
270+ | ` tags ` | string | Yes | Tags that will overwrite the existing tags \( comma-separated string or array of strings\) |
271+
272+ #### Output
273+
274+ | Parameter | Type | Description |
275+ | --------- | ---- | ----------- |
276+ | ` tags ` | json | Updated list of tags on the session \( array of strings\) |
277+
278+ ### ` devin_archive_session `
279+
280+ Archive a Devin session. Archived sessions can still be viewed but cannot be modified or resumed.
281+
282+ #### Input
283+
284+ | Parameter | Type | Required | Description |
285+ | --------- | ---- | -------- | ----------- |
286+ | ` apiKey ` | string | Yes | Devin API key \( service user credential starting with cog_ \) |
287+ | ` orgId ` | string | Yes | Devin organization ID \( prefixed with org-\) |
288+ | ` sessionId ` | string | Yes | The session ID to archive |
289+
290+ #### Output
291+
292+ | Parameter | Type | Description |
293+ | --------- | ---- | ----------- |
294+ | ` sessionId ` | string | Unique identifier for the session |
295+ | ` url ` | string | URL to view the session in the Devin UI |
296+ | ` status ` | string | Session status \( new, claimed, running, exit, error, suspended, resuming\) |
297+ | ` statusDetail ` | string | Detailed status \( working, waiting_for_user, waiting_for_approval, finished, inactivity, etc.\) |
298+ | ` title ` | string | Session title |
299+ | ` createdAt ` | number | Unix timestamp when the session was created |
300+ | ` updatedAt ` | number | Unix timestamp when the session was last updated |
301+ | ` acusConsumed ` | number | ACUs consumed by the session |
302+ | ` tags ` | json | Tags associated with the session \( array of strings\) |
303+ | ` pullRequests ` | json | Pull requests created during the session \(\[\{ pr_url, pr_state\}\]\) |
304+ | ` structuredOutput ` | json | Structured output from the session |
305+ | ` playbookId ` | string | Associated playbook ID |
306+ | ` isArchived ` | boolean | Whether the session is archived |
307+
308+ ### ` devin_terminate_session `
309+
310+ Terminate a Devin session. Optionally archive the session instead of permanently terminating it.
311+
312+ #### Input
313+
314+ | Parameter | Type | Required | Description |
315+ | --------- | ---- | -------- | ----------- |
316+ | ` apiKey ` | string | Yes | Devin API key \( service user credential starting with cog_ \) |
317+ | ` orgId ` | string | Yes | Devin organization ID \( prefixed with org-\) |
318+ | ` sessionId ` | string | Yes | The session ID to terminate |
319+ | ` archive ` | boolean | No | Archive the session instead of permanently terminating it \( default: false\) |
320+
321+ #### Output
322+
323+ | Parameter | Type | Description |
324+ | --------- | ---- | ----------- |
325+ | ` sessionId ` | string | Unique identifier for the session |
326+ | ` url ` | string | URL to view the session in the Devin UI |
327+ | ` status ` | string | Session status \( new, claimed, running, exit, error, suspended, resuming\) |
328+ | ` statusDetail ` | string | Detailed status \( working, waiting_for_user, waiting_for_approval, finished, inactivity, etc.\) |
329+ | ` title ` | string | Session title |
330+ | ` createdAt ` | number | Unix timestamp when the session was created |
331+ | ` updatedAt ` | number | Unix timestamp when the session was last updated |
332+ | ` acusConsumed ` | number | ACUs consumed by the session |
333+ | ` tags ` | json | Tags associated with the session \( array of strings\) |
334+ | ` pullRequests ` | json | Pull requests created during the session \(\[\{ pr_url, pr_state\}\]\) |
335+ | ` structuredOutput ` | json | Structured output from the session |
336+ | ` playbookId ` | string | Associated playbook ID |
337+ | ` isArchived ` | boolean | Whether the session is archived |
156338
157339
0 commit comments