NEAR AI Cloud: Update one admin setting (Admin only)

PATCH /v1/admin/settings/{key} Update one admin setting (Admin only) Deprecated: this endpoint is moving to cloud-platform at the same path; the cloud-platform base URL will be announced. Behaviour may differ in edge cases.

Partial update: fields in the body are merged into the stored value, null resets a field to its default. The result is validated as a whole; an invalid value is rejected with 400 and nothing is stored. Takes effect immediately on the instance that handles it, and on the others within 10 minutes (there is no cross-instance push). For a faster stop of an attested third party on the other instances, redeploy; per-org fallback_disabled only excludes registered fallback providers for that organization and is not a source-wide stop.

A PATCH setting tinfoil_trust.model_pins verifies each pinned Sigstore bundle offline (up to 32, a few ms each) synchronously in the request, which is acceptable for an admin-only write path.

Admin permissions: admin session or read_write token. A read_only token receives HTTP 403 with error.type insufficient_permissions before the handler runs.

Parameters:

• key (path, string, required): Setting key, e.g. placement.

Request body (application/json):

Responses: 200: The updated setting

• key (string, required)
• updated_at (string, date-time): When it was last changed; absent until first changed.
• updated_by_user_id (string, uuid): The admin who last changed it.
• value (object, required): The effective value. For placement: affinity_abs_slack (0.0 - 4.0), affinity_eps (0.0 - 2.0), kv_max (0.5 - 1.0), lane_load_tokens (4000 - 1000000), pin_hold_factor (0.5 - 2.0) and pin_ttl_ms (60000 - 3600000), and enabled (boolean, default true; false routes every request through legacy routing). 400: Invalid value 401: Unauthorized 403: Missing admin privileges (forbidden) or insufficient token permission (insufficient_permissions). 404: Unknown setting 500: Internal server error