v1

latestOpenAPI 3.1.02026-07-13231960.5 KB

Sessions

Create a new session

Create a new Devin session. Provide a prompt to describe the task. The session can optionally be made unlisted or idempotent.

post/v1/sessions

promptstring required

The task description for Devin

snapshot_idstring nullable

ID of a machine snapshot to use

unlistedboolean nullable

Whether the session should be unlisted

idempotentboolean nullable

Enable idempotent session creation

max_acu_limitinteger nullable

Maximum ACU limit for the session

secret_idsstring[] nullable

List of secret IDs to use. If None, use all secrets. If empty list, use no secrets.

knowledge_idsstring[] nullable

List of knowledge IDs to use. If None, use all knowledge. If empty list, use no knowledge.

tagsstring[] nullable

List of tags to add to the session.

titlestring nullable

Custom title for the session. If None, a title will be generated automatically.

Session created

session_idstring required

Unique identifier for the session

urlstring required

URL to view the session in the web interface

is_new_sessionboolean

Indicates if a new session was created (only present if idempotent=true)