devin_request
Destructive
Run a Cognition Devin CLI request synchronously with headless print mode, configurable permissions, sandboxing, session resume, and ACP transport for summarization or code review.
Instructions
Run a Cognition Devin CLI request synchronously (auto-defers to a pollable job past the sync deadline when async jobs are enabled; otherwise runs to completion). Headless print mode (devin -p).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Model name or alias (e.g. opus, latest) | |
| config | No | Config file path (Devin --config <PATH>) | |
| prompt | No | Prompt text for Devin CLI. Required in practice; promptFile is additive (loads an initial prompt from a file). | |
| sandbox | No | Run the Devin session in a sandbox (Devin --sandbox). Safety control: never defaulted on; pass true to opt in. | |
| agentType | No | ACP agent variant for transport=acp (`devin acp --agent-type`): 'summarizer' (no tools, text summary) or 'review' (read-only + shell code-review). Ignored for the CLI transport. | |
| sessionId | No | Devin session ID to resume (emits --resume <id>; use resumeLatest for --continue). Note: the gw-* id minted for a brand-new session is not resumable via sessionId; continue with resumeLatest:true. | |
| transport | No | Transport: 'cli' (default) runs the Devin CLI; 'acp' routes through `devin acp` when [acp].enabled and the provider's runtime_enabled are set (fails closed otherwise). | cli |
| promptFile | No | Load the initial prompt from a file (--prompt-file) | |
| agentConfig | No | Agent config file path (Devin --agent-config <FILE>) | |
| forceRefresh | No | Bypass dedup and force a fresh CLI run even if a recent identical request exists | |
| resumeLatest | No | Resume the most recent Devin session in cwd (--continue). Note: the gw-* id minted for a brand-new session is not resumable via sessionId; continue with resumeLatest:true. | |
| correlationId | No | Request trace ID (auto if omitted) | |
| exportSession | No | Export the session (Devin --export [<PATH>]). true emits a bare --export; a string path emits --export <path>. | |
| idleTimeoutMs | No | Idle timeout in ms (min 30s, max 1h, omit=CLI default) | |
| optimizePrompt | No | Optimize prompt before execution | |
| permissionMode | No | Devin CLI permission mode (--permission-mode). auto auto-approves read-only tools; smart additionally auto-runs actions a fast model judges safe; dangerous auto-approves all. When omitted, Devin uses its own headless default; pass auto or smart for unattended runs. | |
| compressResponse | No | Compress the response display text via the native compressor (default: [compression].enabled in config.toml, off unless opted in). Skipped for structured output. | |
| createNewSession | No | Force a new session | |
| optimizeResponse | No | Optimize response output | |
| respectWorkspaceTrust | No | Respect workspace trust (Devin --respect-workspace-trust <bool>). Devin defaults true for interactive and false for print mode; set explicitly to override. |