FurniOpsDocs
API referenceAssistant

Update Ask AI for the organisation

Turns Ask AI on (naming the data-handling disclosure accepted in accept_disclosure) or off, and sets the roles allowed, the most autonomy, the daily budgets (a member's at most the organisation's plus its daily FurniOps AI credit limit) and the MCP and memory switches. Not in the plan answers 403 feature_unavailable. Recorded in the audit log (assistant_settings.updated).

PATCH/v1/assistant/settings

Turns Ask AI on (naming the data-handling disclosure accepted in accept_disclosure) or off, and sets the roles allowed, the most autonomy, the daily budgets (a member's at most the organisation's plus its daily FurniOps AI credit limit) and the MCP and memory switches. Not in the plan answers 403 feature_unavailable. Recorded in the audit log (assistant_settings.updated).

Authorization

apiKey
AuthorizationBearer <token>

An API key (fo_live_… / fo_test_…) as a bearer token

In: header

Header Parameters

FurniOps-Version?string

Dated API version; pinned per organisation on first use and overridable per request

Value in

  • "2026-10-01"
  • "2026-10-04"
FurniOps-Mode?string

The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused

Value in

  • "live"
  • "test"
If-Match?string

ETag of the representation being changed

FurniOps-Dry-Run?string

Preview the write and change nothing: true answers the would-be response, explain a Preview (application/vnd.furniops.preview+json)

Value in

  • "true"
  • "explain"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Changes to Ask AI for the organisation

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X PATCH "https://example.com/v1/assistant/settings" \  -H "Content-Type: application/json" \  -d '{}'
{  "object": "assistant_org_settings",  "entitled": true,  "enabled": true,  "enabled_at": "2019-08-24T14:15:22Z",  "enabled_by": "string",  "disclosure_version": "string",  "allowed_roles": [    "owner"  ],  "autonomy_max": "ask",  "plan_daily_micros": 0,  "org_daily_budget_micros": 0,  "person_daily_budget_micros": 0,  "spent_today_micros": 0,  "credit_daily_limit_micros": null,  "assistant_mcp_enabled": true,  "memory_enabled": true,  "provider": {    "name": "string",    "trains_on_data": false,    "retention": "string"  },  "retention_days": 90}

Update a memory PATCH

Rewrites a memory, or keeps it another 365 days (`renew`). An organisation's memory needs `assistant_memories:write`.

Update Ask AI for you PATCH

Turns FurniOps AI off or on for you, sets your autonomy (at most the organisation's `autonomy_max`, else 422) or whether your memories load. Takes effect from your next turn.