Create a Devin session

curl --request POST \
  --url http://localhost:3000/api/v1/devin/sessions/create \
  --header 'Content-Type: application/json' \
  --data '
{
  "advancedMode": "<string>",
  "asUser": "<string>",
  "attachmentUrl": [
    "<string>"
  ],
  "bypassApproval": true,
  "childPlaybook": "<string>",
  "devinId": "<string>",
  "devinMode": "<string>",
  "execute": true,
  "knowledge": [
    "<string>"
  ],
  "maxAcu": "<string>",
  "noMaxAcuLimit": false,
  "noResumable": false,
  "platform": "<string>",
  "playbook": "<string>",
  "project": "<string>",
  "prompt": "<string>",
  "promptFile": "<string>",
  "proxRun": "<string>",
  "repo": [
    "<string>"
  ],
  "resumable": true,
  "secret": [
    "<string>"
  ],
  "sessionLink": [
    "<string>"
  ],
  "sessionSecret": [
    "<string>"
  ],
  "structuredOutputRequired": true,
  "structuredOutputSchema": "<string>",
  "tag": [
    "<string>"
  ],
  "task": "<string>",
  "title": "<string>"
}
'

import requests

url = "http://localhost:3000/api/v1/devin/sessions/create"

payload = {
    "advancedMode": "<string>",
    "asUser": "<string>",
    "attachmentUrl": ["<string>"],
    "bypassApproval": True,
    "childPlaybook": "<string>",
    "devinId": "<string>",
    "devinMode": "<string>",
    "execute": True,
    "knowledge": ["<string>"],
    "maxAcu": "<string>",
    "noMaxAcuLimit": False,
    "noResumable": False,
    "platform": "<string>",
    "playbook": "<string>",
    "project": "<string>",
    "prompt": "<string>",
    "promptFile": "<string>",
    "proxRun": "<string>",
    "repo": ["<string>"],
    "resumable": True,
    "secret": ["<string>"],
    "sessionLink": ["<string>"],
    "sessionSecret": ["<string>"],
    "structuredOutputRequired": True,
    "structuredOutputSchema": "<string>",
    "tag": ["<string>"],
    "task": "<string>",
    "title": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    advancedMode: '<string>',
    asUser: '<string>',
    attachmentUrl: ['<string>'],
    bypassApproval: true,
    childPlaybook: '<string>',
    devinId: '<string>',
    devinMode: '<string>',
    execute: true,
    knowledge: ['<string>'],
    maxAcu: '<string>',
    noMaxAcuLimit: false,
    noResumable: false,
    platform: '<string>',
    playbook: '<string>',
    project: '<string>',
    prompt: '<string>',
    promptFile: '<string>',
    proxRun: '<string>',
    repo: ['<string>'],
    resumable: true,
    secret: ['<string>'],
    sessionLink: ['<string>'],
    sessionSecret: ['<string>'],
    structuredOutputRequired: true,
    structuredOutputSchema: '<string>',
    tag: ['<string>'],
    task: '<string>',
    title: '<string>'
  })
};

fetch('http://localhost:3000/api/v1/devin/sessions/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "3000",
  CURLOPT_URL => "http://localhost:3000/api/v1/devin/sessions/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'advancedMode' => '<string>',
    'asUser' => '<string>',
    'attachmentUrl' => [
        '<string>'
    ],
    'bypassApproval' => true,
    'childPlaybook' => '<string>',
    'devinId' => '<string>',
    'devinMode' => '<string>',
    'execute' => true,
    'knowledge' => [
        '<string>'
    ],
    'maxAcu' => '<string>',
    'noMaxAcuLimit' => false,
    'noResumable' => false,
    'platform' => '<string>',
    'playbook' => '<string>',
    'project' => '<string>',
    'prompt' => '<string>',
    'promptFile' => '<string>',
    'proxRun' => '<string>',
    'repo' => [
        '<string>'
    ],
    'resumable' => true,
    'secret' => [
        '<string>'
    ],
    'sessionLink' => [
        '<string>'
    ],
    'sessionSecret' => [
        '<string>'
    ],
    'structuredOutputRequired' => true,
    'structuredOutputSchema' => '<string>',
    'tag' => [
        '<string>'
    ],
    'task' => '<string>',
    'title' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:3000/api/v1/devin/sessions/create"

	payload := strings.NewReader("{\n  \"advancedMode\": \"<string>\",\n  \"asUser\": \"<string>\",\n  \"attachmentUrl\": [\n    \"<string>\"\n  ],\n  \"bypassApproval\": true,\n  \"childPlaybook\": \"<string>\",\n  \"devinId\": \"<string>\",\n  \"devinMode\": \"<string>\",\n  \"execute\": true,\n  \"knowledge\": [\n    \"<string>\"\n  ],\n  \"maxAcu\": \"<string>\",\n  \"noMaxAcuLimit\": false,\n  \"noResumable\": false,\n  \"platform\": \"<string>\",\n  \"playbook\": \"<string>\",\n  \"project\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"promptFile\": \"<string>\",\n  \"proxRun\": \"<string>\",\n  \"repo\": [\n    \"<string>\"\n  ],\n  \"resumable\": true,\n  \"secret\": [\n    \"<string>\"\n  ],\n  \"sessionLink\": [\n    \"<string>\"\n  ],\n  \"sessionSecret\": [\n    \"<string>\"\n  ],\n  \"structuredOutputRequired\": true,\n  \"structuredOutputSchema\": \"<string>\",\n  \"tag\": [\n    \"<string>\"\n  ],\n  \"task\": \"<string>\",\n  \"title\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://localhost:3000/api/v1/devin/sessions/create")
  .header("Content-Type", "application/json")
  .body("{\n  \"advancedMode\": \"<string>\",\n  \"asUser\": \"<string>\",\n  \"attachmentUrl\": [\n    \"<string>\"\n  ],\n  \"bypassApproval\": true,\n  \"childPlaybook\": \"<string>\",\n  \"devinId\": \"<string>\",\n  \"devinMode\": \"<string>\",\n  \"execute\": true,\n  \"knowledge\": [\n    \"<string>\"\n  ],\n  \"maxAcu\": \"<string>\",\n  \"noMaxAcuLimit\": false,\n  \"noResumable\": false,\n  \"platform\": \"<string>\",\n  \"playbook\": \"<string>\",\n  \"project\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"promptFile\": \"<string>\",\n  \"proxRun\": \"<string>\",\n  \"repo\": [\n    \"<string>\"\n  ],\n  \"resumable\": true,\n  \"secret\": [\n    \"<string>\"\n  ],\n  \"sessionLink\": [\n    \"<string>\"\n  ],\n  \"sessionSecret\": [\n    \"<string>\"\n  ],\n  \"structuredOutputRequired\": true,\n  \"structuredOutputSchema\": \"<string>\",\n  \"tag\": [\n    \"<string>\"\n  ],\n  \"task\": \"<string>\",\n  \"title\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://localhost:3000/api/v1/devin/sessions/create")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"advancedMode\": \"<string>\",\n  \"asUser\": \"<string>\",\n  \"attachmentUrl\": [\n    \"<string>\"\n  ],\n  \"bypassApproval\": true,\n  \"childPlaybook\": \"<string>\",\n  \"devinId\": \"<string>\",\n  \"devinMode\": \"<string>\",\n  \"execute\": true,\n  \"knowledge\": [\n    \"<string>\"\n  ],\n  \"maxAcu\": \"<string>\",\n  \"noMaxAcuLimit\": false,\n  \"noResumable\": false,\n  \"platform\": \"<string>\",\n  \"playbook\": \"<string>\",\n  \"project\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"promptFile\": \"<string>\",\n  \"proxRun\": \"<string>\",\n  \"repo\": [\n    \"<string>\"\n  ],\n  \"resumable\": true,\n  \"secret\": [\n    \"<string>\"\n  ],\n  \"sessionLink\": [\n    \"<string>\"\n  ],\n  \"sessionSecret\": [\n    \"<string>\"\n  ],\n  \"structuredOutputRequired\": true,\n  \"structuredOutputSchema\": \"<string>\",\n  \"tag\": [\n    \"<string>\"\n  ],\n  \"task\": \"<string>\",\n  \"title\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "maxAcuLimit": 123,
  "maxAcuLimitSource": "<string>",
  "session": {
    "devinId": "<string>",
    "status": "<string>",
    "statusDetail": "<string>",
    "tags": [
      "<string>"
    ],
    "title": "<string>",
    "updatedAt": 123,
    "url": "<string>",
    "acusConsumed": 123,
    "devinMode": "<string>",
    "effectiveCreateAsUserId": "<string>",
    "id": "<string>",
    "isArchived": true,
    "lastSyncedAt": 123,
    "maxAcuLimit": 123,
    "maxAcuLimitSource": "<string>",
    "origin": "<string>",
    "originId": "<string>",
    "originType": "<string>",
    "platform": "<string>",
    "projectId": "<string>",
    "proxRunId": "<string>",
    "resumable": true,
    "serviceUserId": "<string>",
    "taskId": "<string>",
    "userId": "<string>"
  },
  "status": "created",
  "devinMode": "<string>",
  "platform": "<string>",
  "resumable": true
}

POST

api

devin

sessions

create

Create a Devin session

curl --request POST \
  --url http://localhost:3000/api/v1/devin/sessions/create \
  --header 'Content-Type: application/json' \
  --data '
{
  "advancedMode": "<string>",
  "asUser": "<string>",
  "attachmentUrl": [
    "<string>"
  ],
  "bypassApproval": true,
  "childPlaybook": "<string>",
  "devinId": "<string>",
  "devinMode": "<string>",
  "execute": true,
  "knowledge": [
    "<string>"
  ],
  "maxAcu": "<string>",
  "noMaxAcuLimit": false,
  "noResumable": false,
  "platform": "<string>",
  "playbook": "<string>",
  "project": "<string>",
  "prompt": "<string>",
  "promptFile": "<string>",
  "proxRun": "<string>",
  "repo": [
    "<string>"
  ],
  "resumable": true,
  "secret": [
    "<string>"
  ],
  "sessionLink": [
    "<string>"
  ],
  "sessionSecret": [
    "<string>"
  ],
  "structuredOutputRequired": true,
  "structuredOutputSchema": "<string>",
  "tag": [
    "<string>"
  ],
  "task": "<string>",
  "title": "<string>"
}
'

import requests

url = "http://localhost:3000/api/v1/devin/sessions/create"

payload = {
    "advancedMode": "<string>",
    "asUser": "<string>",
    "attachmentUrl": ["<string>"],
    "bypassApproval": True,
    "childPlaybook": "<string>",
    "devinId": "<string>",
    "devinMode": "<string>",
    "execute": True,
    "knowledge": ["<string>"],
    "maxAcu": "<string>",
    "noMaxAcuLimit": False,
    "noResumable": False,
    "platform": "<string>",
    "playbook": "<string>",
    "project": "<string>",
    "prompt": "<string>",
    "promptFile": "<string>",
    "proxRun": "<string>",
    "repo": ["<string>"],
    "resumable": True,
    "secret": ["<string>"],
    "sessionLink": ["<string>"],
    "sessionSecret": ["<string>"],
    "structuredOutputRequired": True,
    "structuredOutputSchema": "<string>",
    "tag": ["<string>"],
    "task": "<string>",
    "title": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    advancedMode: '<string>',
    asUser: '<string>',
    attachmentUrl: ['<string>'],
    bypassApproval: true,
    childPlaybook: '<string>',
    devinId: '<string>',
    devinMode: '<string>',
    execute: true,
    knowledge: ['<string>'],
    maxAcu: '<string>',
    noMaxAcuLimit: false,
    noResumable: false,
    platform: '<string>',
    playbook: '<string>',
    project: '<string>',
    prompt: '<string>',
    promptFile: '<string>',
    proxRun: '<string>',
    repo: ['<string>'],
    resumable: true,
    secret: ['<string>'],
    sessionLink: ['<string>'],
    sessionSecret: ['<string>'],
    structuredOutputRequired: true,
    structuredOutputSchema: '<string>',
    tag: ['<string>'],
    task: '<string>',
    title: '<string>'
  })
};

fetch('http://localhost:3000/api/v1/devin/sessions/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "3000",
  CURLOPT_URL => "http://localhost:3000/api/v1/devin/sessions/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'advancedMode' => '<string>',
    'asUser' => '<string>',
    'attachmentUrl' => [
        '<string>'
    ],
    'bypassApproval' => true,
    'childPlaybook' => '<string>',
    'devinId' => '<string>',
    'devinMode' => '<string>',
    'execute' => true,
    'knowledge' => [
        '<string>'
    ],
    'maxAcu' => '<string>',
    'noMaxAcuLimit' => false,
    'noResumable' => false,
    'platform' => '<string>',
    'playbook' => '<string>',
    'project' => '<string>',
    'prompt' => '<string>',
    'promptFile' => '<string>',
    'proxRun' => '<string>',
    'repo' => [
        '<string>'
    ],
    'resumable' => true,
    'secret' => [
        '<string>'
    ],
    'sessionLink' => [
        '<string>'
    ],
    'sessionSecret' => [
        '<string>'
    ],
    'structuredOutputRequired' => true,
    'structuredOutputSchema' => '<string>',
    'tag' => [
        '<string>'
    ],
    'task' => '<string>',
    'title' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:3000/api/v1/devin/sessions/create"

	payload := strings.NewReader("{\n  \"advancedMode\": \"<string>\",\n  \"asUser\": \"<string>\",\n  \"attachmentUrl\": [\n    \"<string>\"\n  ],\n  \"bypassApproval\": true,\n  \"childPlaybook\": \"<string>\",\n  \"devinId\": \"<string>\",\n  \"devinMode\": \"<string>\",\n  \"execute\": true,\n  \"knowledge\": [\n    \"<string>\"\n  ],\n  \"maxAcu\": \"<string>\",\n  \"noMaxAcuLimit\": false,\n  \"noResumable\": false,\n  \"platform\": \"<string>\",\n  \"playbook\": \"<string>\",\n  \"project\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"promptFile\": \"<string>\",\n  \"proxRun\": \"<string>\",\n  \"repo\": [\n    \"<string>\"\n  ],\n  \"resumable\": true,\n  \"secret\": [\n    \"<string>\"\n  ],\n  \"sessionLink\": [\n    \"<string>\"\n  ],\n  \"sessionSecret\": [\n    \"<string>\"\n  ],\n  \"structuredOutputRequired\": true,\n  \"structuredOutputSchema\": \"<string>\",\n  \"tag\": [\n    \"<string>\"\n  ],\n  \"task\": \"<string>\",\n  \"title\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://localhost:3000/api/v1/devin/sessions/create")
  .header("Content-Type", "application/json")
  .body("{\n  \"advancedMode\": \"<string>\",\n  \"asUser\": \"<string>\",\n  \"attachmentUrl\": [\n    \"<string>\"\n  ],\n  \"bypassApproval\": true,\n  \"childPlaybook\": \"<string>\",\n  \"devinId\": \"<string>\",\n  \"devinMode\": \"<string>\",\n  \"execute\": true,\n  \"knowledge\": [\n    \"<string>\"\n  ],\n  \"maxAcu\": \"<string>\",\n  \"noMaxAcuLimit\": false,\n  \"noResumable\": false,\n  \"platform\": \"<string>\",\n  \"playbook\": \"<string>\",\n  \"project\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"promptFile\": \"<string>\",\n  \"proxRun\": \"<string>\",\n  \"repo\": [\n    \"<string>\"\n  ],\n  \"resumable\": true,\n  \"secret\": [\n    \"<string>\"\n  ],\n  \"sessionLink\": [\n    \"<string>\"\n  ],\n  \"sessionSecret\": [\n    \"<string>\"\n  ],\n  \"structuredOutputRequired\": true,\n  \"structuredOutputSchema\": \"<string>\",\n  \"tag\": [\n    \"<string>\"\n  ],\n  \"task\": \"<string>\",\n  \"title\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://localhost:3000/api/v1/devin/sessions/create")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"advancedMode\": \"<string>\",\n  \"asUser\": \"<string>\",\n  \"attachmentUrl\": [\n    \"<string>\"\n  ],\n  \"bypassApproval\": true,\n  \"childPlaybook\": \"<string>\",\n  \"devinId\": \"<string>\",\n  \"devinMode\": \"<string>\",\n  \"execute\": true,\n  \"knowledge\": [\n    \"<string>\"\n  ],\n  \"maxAcu\": \"<string>\",\n  \"noMaxAcuLimit\": false,\n  \"noResumable\": false,\n  \"platform\": \"<string>\",\n  \"playbook\": \"<string>\",\n  \"project\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"promptFile\": \"<string>\",\n  \"proxRun\": \"<string>\",\n  \"repo\": [\n    \"<string>\"\n  ],\n  \"resumable\": true,\n  \"secret\": [\n    \"<string>\"\n  ],\n  \"sessionLink\": [\n    \"<string>\"\n  ],\n  \"sessionSecret\": [\n    \"<string>\"\n  ],\n  \"structuredOutputRequired\": true,\n  \"structuredOutputSchema\": \"<string>\",\n  \"tag\": [\n    \"<string>\"\n  ],\n  \"task\": \"<string>\",\n  \"title\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "maxAcuLimit": 123,
  "maxAcuLimitSource": "<string>",
  "session": {
    "devinId": "<string>",
    "status": "<string>",
    "statusDetail": "<string>",
    "tags": [
      "<string>"
    ],
    "title": "<string>",
    "updatedAt": 123,
    "url": "<string>",
    "acusConsumed": 123,
    "devinMode": "<string>",
    "effectiveCreateAsUserId": "<string>",
    "id": "<string>",
    "isArchived": true,
    "lastSyncedAt": 123,
    "maxAcuLimit": 123,
    "maxAcuLimitSource": "<string>",
    "origin": "<string>",
    "originId": "<string>",
    "originType": "<string>",
    "platform": "<string>",
    "projectId": "<string>",
    "proxRunId": "<string>",
    "resumable": true,
    "serviceUserId": "<string>",
    "taskId": "<string>",
    "userId": "<string>"
  },
  "status": "created",
  "devinMode": "<string>",
  "platform": "<string>",
  "resumable": true
}

Body

application/json

advancedMode

string

Legacy: analyze|create|improve|batch|manage

asUser

string

create_as_user_id (impersonate user)

attachmentUrl

string[]

Attachment URLs

bypassApproval

boolean

Request bypass_approval=true

childPlaybook

string

Child playbook ID

devinId

string

Idempotent session creation key

devinMode

string

Agent mode: normal|fast|lite|ultra

execute

boolean

Actually create the Devin session; default is a dry-run that only shows the plan (exit 3)

knowledge

string[]

Knowledge note IDs

maxAcu

string

Per-session max ACU ceiling

noMaxAcuLimit

boolean

default:false

Intentionally omit max_acu_limit

noResumable

boolean

default:false

Disposable session, do not preserve VM state

platform

string

VM platform override (org-specific)

playbook

string

Playbook ID

project

string

Link to Ravi project

prompt

string

Prompt for Devin

promptFile

string

Read prompt from file

proxRun

string

Link to prox run

repo

string[]

Repos; can be repeated or comma-separated

resumable

boolean

Preserve VM state for resume (default: true)

secret

string[]

Secret IDs (org-level secret references)

sessionLink

string[]

Linked Devin sessions

sessionSecret

string[]

Inline session secrets (key=value); sensitive by default

structuredOutputRequired

boolean

Require structured output before turn ends

structuredOutputSchema

string

JSON schema for structured output

tag

string[]

Tags; can be repeated or comma-separated

task

string

Link to Ravi task

title

string

Session title

Response

Success — body conforms to the @Returns schema.

maxAcuLimit

number | null

required

maxAcuLimitSource

string

required

session

object

required

Show child attributes

status

string

required

Allowed value: "created"

devinMode

string | null

platform

string | null

resumable

boolean | null

{key}

any