Raw authenticated call to any Devin v3 endpoint: {method, path, query?, body?}. Use for anything the typed devin::session::* wrappers do not cover.
bodyunknown
Optional JSON request body.
methodstring*required
HTTP method: GET, POST, PUT, PATCH, or DELETE.
pathstring*required
Path relative to the configured base URL, e.g. `organizations/{org_id}/sessions`.
queryunknown
Optional query parameters as a flat object.
devin::on-config-change
functionInternal: reload devin configuration when it changes.
devin::pr-review::status
functionGet the latest Devin review status for a pull/merge request.
commit_shastring
Commit SHA (full or short); defaults to the PR head when omitted.
pr_urlstring*required
Full URL of the pull/merge request to look up.
Trigger a Devin review for a pull/merge request by its URL.
pr_urlstring*required
Full URL of the pull/merge request to review.
Run one Devin CLI turn and wait for the result. Accepts `prompt` or a `messages` array; streams raw CLI stdout onto devin::events, terminal AgentEvent frames onto agent::events, and returns {session_id, devin_session_id, url, result, stop_reason, is_error}.
cwdstring
Working directory the CLI runs in. Empty = the worker's process directory.
iii_contextboolean
Prepend the iii runtime discovery prompt as leading instructions (default from config).
messagesobject[]
Alternative to prompt: role/content messages; the last user entry becomes the prompt.
contentunknown*required
Either a plain string or an array of content blocks.
promptstring
The prompt handed to the `devin` CLI for this turn.
session_idstring
iii session id; reuse to keep the same local record. Omit to generate one.
devin::session::create
functionCreate a Devin cloud session from a prompt. Optional fields (title, tags, playbook_id, snapshot_id, idempotent, max_acu_limit, secret_ids, knowledge_ids, unlisted) map to POST /sessions.
attachment_urlsstring[]
(v3) File attachment URLs.
bypass_approvalboolean
(v3) Skip approval workflows for this session.
devin_modestring
(v3) Agent mode: normal, fast, lite, ultra, or fusion.
idempotentboolean
(v1) Reuse an existing matching session instead of creating a duplicate.
knowledge_idsstring[]
Knowledge ids to attach to the session.
max_acu_limitinteger· uint64min 0
Cap the session's ACU consumption.
messagesobject[]
Alternative to prompt: role/content messages; the last user entry becomes the prompt.
contentunknown*required
Either a plain string or an array of content blocks.
playbook_idstring
Playbook id to run.
promptstring
The task prompt for the new Devin session.
reposstring[]
(v3) Repository identifiers to attach to the session.
resumableboolean
(v3) Preserve VM state so the session can be resumed (default true).
secret_idsstring[]
Secret ids to expose to the session.
snapshot_idstring
(v1) Machine snapshot id to start the session from.
tagsstring[]
Tags to apply to the session.
titlestring
Human-readable session title.
unlistedboolean
(v1) Create the session as unlisted.
devin::session::get
functionFetch one Devin cloud session (status, messages, output) by session id.
session_idstring*required
iii session id (devin::run) or Devin cloud session id (devin::session::*).
devin::session::message
functionSend a follow-up message to a running Devin cloud session.
messagestring*required
The message to send.
session_idstring*required
Devin cloud session id (returned by devin::session::create).
devin::sessions::list
functionList every devin::run / devin::start session this worker has recorded, each linked to its Devin session id. For all Devin cloud sessions org-wide, use devin::api {method: GET, path: sessions}.
Start a Devin CLI turn and return immediately; watch devin::events / agent::events (group_id = session_id) for progress and turn_end.
cwdstring
Working directory the CLI runs in. Empty = the worker's process directory.
iii_contextboolean
Prepend the iii runtime discovery prompt as leading instructions (default from config).
messagesobject[]
Alternative to prompt: role/content messages; the last user entry becomes the prompt.
contentunknown*required
Either a plain string or an array of content blocks.
promptstring
The prompt handed to the `devin` CLI for this turn.
session_idstring
iii session id; reuse to keep the same local record. Omit to generate one.
Point-in-time status of a local devin::run session.
session_idstring*required
iii session id (devin::run) or Devin cloud session id (devin::session::*).
Interrupt a live devin::run CLI turn for a session.
session_idstring*required
iii session id (devin::run) or Devin cloud session id (devin::session::*).