FurniOpsDocs
API referenceAssistant

Start a conversation

Starts an empty conversation in this organisation and mode, which it keeps for good; its first turn names it when no title is given.

  • Scopesnone
  • Rate classwrite
POST/v1/assistant/conversations

Starts an empty conversation in this organisation and mode, which it keeps for good; its first turn names it when no title is given.

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"
FurniOps-Dry-Run?string

This operation cannot be previewed (It changes only your own conversations): 422 preview_unsupported, nothing changes

Value in

  • "true"
  • "explain"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

A new conversation in this organisation and mode

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

curl -X POST "https://example.com/v1/assistant/conversations" \  -H "Content-Type: application/json" \  -d '{}'
{  "object": "assistant_conversation",  "id": "string",  "title": "string",  "surface": "console",  "context": "platform",  "org": null,  "acting_for": null,  "livemode": null,  "created_at": "2019-08-24T14:15:22Z",  "last_message_at": "2019-08-24T14:15:22Z"}

Update an agent's settings PATCH

Changes the settings given; the rest stay. `autonomy: off` stops the agent; proposals it made stay as they are.

Save a memory POST

Saves a note FurniOps AI reads at the start of every turn: plain words, one paragraph, at most 400 characters, no links, addresses, Markdown or code. `scope: org` shares it with every member's FurniOps AI and needs `assistant_memories:write` (403 otherwise). At most 25 per person and 25 per organisation (409 `memory_limit`). Proposed by FurniOps AI, it waits for you to approve the exact words. Expires 365 days after its last edit.