Update a settings namespace | Ara Documentation

Replaces the value object for a single settings namespace. Only validated namespaces are writable; an unknown namespace returns a 400.

_{Scope: org:write}

Authentication

AuthorizationBearer

Your ara_ API key from Settings > Ara API. Keys are capability-scoped: run, plugins:read, secrets:read, secrets:write, sessions:read, knowledge:read, repos:read, repos:write, reviews:read, reviews:write, analytics:read, org:read, org:write, attachments:read, attachments:write, plugins:write, guardrails:read, guardrails:write.

Path parameters

orgIdstringRequired

Organization id or slug. Resolve it with GET /v3/self.

namespacestringRequired

The settings namespace.

Request

This endpoint expects an object.

Response

The updated settings namespace value.

namespacestring

valueobject

Errors

400

Bad Request Error

403

Forbidden Error

$	curl -X PUT https://api.ara.so/v3/organizations/orgId/settings/namespace \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'