FurniOpsDocs
API referenceAssistant

Retrieve a conversation

A conversation's messages, oldest first, and the approvals waiting for you. Only your own: nobody else, admins included, reads them.

  • Scopesnone
  • Rate classread
GET/v1/assistant/conversations/{conversation}

A conversation's messages, oldest first, and the approvals waiting for you. Only your own: nobody else, admins included, reads them.

Authorization

apiKey
AuthorizationBearer <token>

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

In: header

Path Parameters

conversation*string

Assistant conversation (a person's conversation with FurniOps AI) ID

Match^asc_[0-9A-Za-z]{22}$

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

application/problem+json

curl -X GET "https://example.com/v1/assistant/conversations/string"
{  "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",  "messages": [    {      "object": "assistant_message",      "id": "string",      "role": "user",      "origin": "person",      "parts": [        {          "type": "string",          "property1": null,          "property2": null        }      ],      "created_at": "2019-08-24T14:15:22Z"    }  ],  "approvals": [    {      "object": "assistant_approval",      "id": "string",      "tool": "string",      "tool_call_id": "string",      "title": "string",      "risk": "read",      "input": {        "property1": null,        "property2": null      },      "reason": "string",      "preview": {        "object": "preview",        "status": 200,        "response": null,        "changes": [          {            "resource": "string",            "id": "string",            "op": "create",            "version_before": 0,            "version_after": 0,            "patch": [              {                "op": "add",                "path": "string",                "from": "string",                "value": null              }            ]          }        ],        "events": [          "string"        ],        "undo": {          "kind": "inverse"        },        "warnings": [          "string"        ]      },      "status": "pending",      "tool_data_seen": false,      "created_at": "2019-08-24T14:15:22Z",      "expires_at": null,      "decided_at": "2019-08-24T14:15:22Z"    }  ]}

Delete a memory DELETE

Deletes a memory for good: the audit log records that it went, never its words. An organisation's memory needs `assistant_memories:write`.

Retrieve Ask AI for the organisation GET

Whether the plan includes Ask AI and the organisation turned it on (who, when, which disclosure), the roles allowed, the most autonomy, the daily budgets and today's spend, MCP and memory switches, and who processes the data and how long it is kept.