PUT
/api/agent-network/settingsUpdate Agent Network settings
Updates the account-level Agent Network settings; the request carries every field, replacing the mutable ones (collection toggles and retention). Returns 404 when the account has no settings row yet — bootstrap it with POST first. The endpoint and proxy address are assigned at bootstrap and immutable; the request must carry them unchanged, and a request carrying different values is rejected.
Settings update request
access_log_retention_daysintegerrequired
Days to retain full access-log rows; older rows are swept. 0 or less means keep indefinitely.
enable_log_collectionbooleanrequired
Whether per-request access-log entries are collected for this account's agent-network traffic.
enable_prompt_collectionbooleanrequired
Master switch for request/response prompt capture.
endpointstringrequired
The account's gateway endpoint hostname. Immutable — must match the assigned value; a different value is rejected.
proxy_addressstringrequired
Declared cluster address of the proxy serving this account's gateway. Immutable — must match the assigned value; a different value is rejected.
redact_piibooleanrequired
Whether captured prompts have PII redacted.
200Updated Agent Network settings
access_log_retention_daysintegeroptional
Days to retain full access-log rows; older rows are swept. 0 or less means keep indefinitely. Usage records are retained independently.
created_atstringoptional
Timestamp when the settings row was created. Absent until the account is bootstrapped.
dedicatedbooleanrequired
Whether the account's gateway is served by a proxy dedicated to it (endpoint equals proxy_address).
enable_log_collectionbooleanrequired
Whether per-request access-log entries are collected for this account's agent-network traffic.
enable_prompt_collectionbooleanrequired
Master switch for request/response prompt capture. Capture runs only when this is on AND a policy guardrail also enables it.
endpointstringrequired
Bare hostname agents call for this account. Empty until the account is bootstrapped.
proxy_addressstringrequired
Declared cluster address of the proxy serving this account's gateway. Equal to `endpoint` when a dedicated proxy serves the account; otherwise the endpoint's immediate parent (a shared cluster the endpoint hangs one label beneath). Empty until the account is bootstrapped.
redact_piibooleanrequired
Whether captured prompts have PII redacted. Effective redaction is the OR of this and any policy guardrail's redact setting.
updated_atstringoptional
Timestamp when the settings row was last updated. Absent until the account is bootstrapped.
400Bad Request
401Requires authentication
403Forbidden
404Resource not found
422Validation failed
500Internal Server Error
Error handling
A 400 is returned: Bad Request. A 401 is returned: Requires authentication. A 403 is returned: Forbidden. A 404 is returned: Resource not found. A 422 is returned: Validation failed. A 500 is returned: Internal Server Error.