> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# DevinApi.SessionCreateRequest

## Properties

**attachment\_urls** `string[] | null`

**bypass\_approval** `boolean | null`

**child\_playbook\_id** `string | null`

**create\_as\_user\_id** `string | null`

**devin\_id** `string | null`

**devin\_mode** `DevinMode | null`

**Type:** `DevinMode | null`

Override the Devin agent mode for the session. 'normal' uses the default Agent mode, 'fast' uses Fast mode, 'lite' uses Devin Lite, 'ultra' uses Devin Ultra, and 'fusion' uses Fusion. Preview modes are subject to the same feature flag and enterprise agent preview restrictions as the web app.

**knowledge\_ids** `string[] | null`

**max\_acu\_limit** `number | null`

**org\_id** `string` *required*

Organization ID (prefix: org-)

**platform** `string | null`

Override the VM platform for the session (e.g. 'windows'). When omitted (or set to 'inherit'), a session created by a parent Devin inherits the parent's platform; otherwise the organization default is used. Any value must match a platform configured for your organization (case-insensitive); unrecognized values are rejected with a 400 whose error body lists the available platform labels for the org.

**playbook\_id** `string | null`

**prompt** `string` *required*

**repos** `string[] | null`

**resumable** `boolean`

Whether to preserve the session's VM state after it stops so the session can be resumed. Set to false for disposable sessions.

**secret\_ids** `string[] | null`

**session\_links** `string[] | null`

**session\_secrets** `SessionSecretInput[] | null`

**Type:** `SessionSecretInput[] | null`

**structured\_output\_required** `boolean | null`

When true (default), the agent MUST call provide\_structured\_output with is\_final=true before its turn ends. When false, the tool is available but not required — it is not guaranteed to be called in a given turn.

**structured\_output\_schema** `Record\<string, unknown\> | null`

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

**tags** `string[] | null`

**title** `string | null`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.