Skip to main content

​
Properties

​
AcpProtocolVersion
ACP version to offer. Defaults to 2 (allows v1 fallback); 1 requires v1.
​
string
Personal access token (cog_…). Defaults to $DEVIN_API_KEY.
​
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://…).
​
CognitionClientCapabilities
Extra cognition.ai/* client capabilities to advertise on initialize, merged over the SDK defaults. Set a flag to false to opt out.
​
(input: RequestInfo | URL, init: RequestInit) => Promise<Response>
Custom fetch implementation for the v3 API client (proxies, testing, …).
​
PermissionHandler
Called when the agent asks for permission (e.g. to run a command). Defaults to rejecting, so unattended runs are safe by default.
​
string
Organization to create sessions in. Defaults to $DEVIN_ORG_ID; when neither is set, the agent picks the organization.
​
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.