> ## 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.

# CloudDevinOptions

## Properties

**acpVersion** `AcpProtocolVersion`

ACP version to offer. Defaults to 2 (allows v1 fallback); 1 requires v1.

**apiKey** `string`

Personal access token (`cog_…`). Defaults to `$DEVIN_API_KEY`.

**baseUrl** `string`

API base URL, e.g. `"https://api.devin.ai"`. Defaults to `$DEVIN_BASE_URL`,
then the production URL. The ACP WebSocket endpoint is derived from it
(`wss://…`).

**clientCapabilities** `CognitionClientCapabilities`

Extra `cognition.ai/*` client capabilities to advertise on `initialize`,
merged over the SDK defaults. Set a flag to `false` to opt out.

**fetch** `(input: RequestInfo | URL, init: RequestInit) =\> Promise\<Response\>`

Custom fetch implementation for the v3 API client (proxies, testing, ...).

**onPermission** `PermissionHandler`

Called when the agent asks for permission (e.g. to run a command).
Defaults to rejecting, so unattended runs are safe by default.

**orgId** `string`

Organization to create sessions in. Defaults to `$DEVIN_ORG_ID`; when
neither is set, the agent picks the organization.

**tracing** `SessionInstrumentation`

Trace every session this client opens, e.g.
`traceSessions({ tracer })` from `@cognition-ai/sdk/tracing`. Sessions
refine or opt out with their own `tracing` option.


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