Replace the Organization agent defaults

PATCH /v1/organization/agent-defaults

Publishes the next version of the Organization layer at the version If-Match names and writes the Audit event organization.agent_defaults.update. Bounds and locks need the owner. From 1.24.0 turning the AI disclosure off (safety.disclosure.required false) is an elevated change: the api accepts it only from the owner in a console session, never from an API key, and only with disclosure_attestation (disclosure_attestation_required); the Audit event then records the attestation, the Member and that the disclosure went off. Turning it back on needs no attestation and is audited the same way.

Request

Set VOCAL_API to the base URL of your API and VOCAL_API_KEY to an API key with the agents:write scope (Authentication and keys). Replace each placeholder, such as agt_... or <name>, with your own value.

curl -X PATCH "$VOCAL_API/v1/organization/agent-defaults" \
  -H "Authorization: Bearer $VOCAL_API_KEY" \
  -H 'If-Match: "1"' \
  -H "Content-Type: application/json" \
  -d '{
    "values": {}
  }'

const response = await fetch(`${process.env.VOCAL_API}/v1/organization/agent-defaults`, {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.VOCAL_API_KEY}`,
    'If-Match': '"1"',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "values": {}
  }),
});
console.log(response.status, await response.text());

import os

import requests

response = requests.patch(
    f"{os.environ['VOCAL_API']}/v1/organization/agent-defaults",
    headers={
        "Authorization": f"Bearer {os.environ['VOCAL_API_KEY']}",
        "If-Match": '"1"',
    },
    json={
        "values": {},
    },
)
print(response.status_code, response.text)

Parameters

Request body

Content type application/json, required: OrganizationAgentDefaultsUpdateRequest.

Responses

Fields of the 200 answer

The shape is OrganizationAgentDefaults.