FurniOpsDocs
API referenceOrganisation

Read the caller's organisation

The organisation the credential belongs to: its ID, name and slug, and its plan with the features it switches on. A rename or a plan change reaches it within seconds.

  • Scopesnone
  • Rate classread
GET/v1/org

The organisation the credential belongs to: its ID, name and slug, and its plan with the features it switches on. A rename or a plan change reaches it within seconds.

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-None-Match?string

ETag of a cached representation; a match returns 304

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/org"
{  "object": "organisation",  "id": "string",  "name": "string",  "slug": "string",  "kind": "retailer",  "plan": {    "code": "string",    "features": [      "sso"    ]  }}

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.

List the user's organisations GET

Every organisation the signed-in user belongs to, with their role in it, by name; one page (at most 100). A user's token only: an API key, a machine client or a support session answers 403 `permission_denied`. Switching organisation means a new token for it.