Skip to navigation
API ReferenceV3

Send a message to a session

Send a message to an active session. The session will be automatically resumed if suspended.

Authentication

AuthorizationBearer

Personal API Key (apk_user_) or Service API Key (apk_)

Path parameters

devin_idstringRequired

Devin session ID (prefix: devin-)

org_idstringRequired

Organization ID (prefix: org-)

Request

This endpoint expects an object.
messagestringRequired
message_as_user_idstring or nullOptional

Response

Successful Response
acus_consumeddouble
Total ACUs consumed by this session so far.
created_atinteger

Unix timestamp (seconds) when the session was created.

org_idstring

Organization that owns this session (prefix org-).

pull_requestslist of objects
Pull requests created by this session.
session_idstring

Unique session identifier (prefix devin-).

statusenum

Current lifecycle status: running, suspended, stopped, or blocked.

tagslist of strings
Tags applied to this session.
updated_atinteger

Unix timestamp (seconds) of the last session update.

urlstring
URL to view the session in the Devin web app.
categoryenum or nullOptional

The session's assigned use-case category, if categorisation has run. Only populated on get/list endpoints.

child_session_idslist of strings or nullOptional
Devin IDs of child sessions spawned by this session.
is_archivedbooleanOptionalDefaults to false
Whether the session has been archived.
originenum or nullOptional
The origin from which the session was created.
parent_session_idstring or nullOptional
Devin ID of the parent session, if this is a child session.
playbook_idstring or nullOptional
Playbook running in this session, if any.
service_user_idstring or nullOptional
Service user ID if the session was created via API key.
status_detailenum or nullOptional

Additional detail about the session's current status. When status is 'running': 'working' (actively working), 'waiting_for_user' (needs user input), 'waiting_for_approval' (awaiting action approval in safe mode), or 'finished' (task complete). When status is 'suspended': the reason for suspension such as 'inactivity', 'user_request', 'usage_limit_exceeded', 'out_of_credits', 'out_of_quota', 'no_quota_allocation', 'payment_declined', 'org_usage_limit_exceeded', 'total_session_limit_exceeded', or 'error'. Only populated on get/list endpoints.

structured_outputmap from strings to any or nullOptional

Validated structured output from the session. Only populated on get/list endpoints.

subcategorystring or nullOptional

The session's assigned subcategory display name. 'Other' when a category is set but no subcategory was assigned or resolved. Only populated on get/list endpoints.

titlestring or nullOptional

Human-readable session title.

user_idstring or nullOptional
ID of the user who created or owns the session.

Errors

422
Unprocessable Entity Error