ReferenceHTTP APIAgents

Record whether a connection's models run the auto-mode classifier

POST
/v1/installation/settings/connections/{id}/auto-mode

The operator (installation.settings.manage, the workspace owner), signed in; an API key is 403 whatever its scopes. Records the operator's judgement for one connection: supported, unsupported or unknown (the default). Only supported lets an agent whose mode is default, acceptEdits, dontAsk or plan run as auto on this connection, from the next claim of each session; running sessions keep their current run. Changes that field only: the connection's definition, and so every fingerprint made over it, stays. A disabled connection is 409 disabled. Writes a set_connection_auto_mode receipt.

Auth: cookie session only; no scope. Idempotency-Key: ignored.

Authorization

cookieSession
cookie__Host-werft_session<token>

For the web console: the browser session cookie set by POST /v1/auth/login. It holds the scopes of the user's workspace role (owner: all; admin and member: all but sessions:recover). Requests other than GET must also send X-Requested-With: werft-web.

Path Parameters

id*string

The model connection's id.

Length1 <= length

Header Parameters

X-Requested-With?"werft-web"

Required with a cookie session: the literal werft-web.

Value in"werft-web"

Request Body

application/json
  1. body
auto_mode*string
Value in"supported""unsupported""unknown"

Response Body

The entry's id and the change's receipt.

application/json
  1. response
id*string
Length1 <= length
receipt_id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
Example Request
curl -X POST 'https://example.com/v1/installation/settings/connections/string/auto-mode' \  -H 'Content-Type: application/json' \  -d '{  "auto_mode": "supported"}'
Example Response
{  "id": "anthropic-main",  "receipt_id": "019a0000-0000-7000-8000-0000000000f3"}