v1

latestOpenAPI 3.1.02026-07-26269227514.8 KB

Create a new session

Create a new Devin session with the specified prompt and configuration options.

post/v1/sessions

Request body

idempotentboolean
knowledge_idsstring[] nullable

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

max_acu_limitinteger nullable

Maximum ACU limit, must be positive

playbook_idstring nullable
promptstring required
secret_idsstring[] nullable

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

snapshot_idstring nullable
structured_output_schemaobject nullable

JSON Schema (Draft 7) for validating structured output. Max 64KB. Must be self-contained (no external $ref).

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.

unlistedboolean

Response

Successful Response

is_new_sessionboolean nullable
session_idstring required
urlstring required