Chat

Type object

Shape

Field	Type	Description
idrequired	ChatId	ChatId - a client-minted UUID v4, never derived from content or location.
titlerequired	string
private	boolean	Default `false`
current_modelrequired	ModelSelection
branched_from	BranchOrigin or null
agent_working_folder	string or null	The folder a local agent works in for this chat, absolute; `None` is the person's home folder. Only an `agent-*` chat sets it, before its first message, and a branch copies it.
agent_mode	string or null	The approval mode a local agent runs this chat's next message in (koru-ai D7): the agent's own id, `None` for the agent's default. Chosen at any time; a choice made during a reply applies to the next message. A branch starts with none.
agent_fast	boolean or null	Whether a local agent runs this chat's next message in its model's Fast mode (koru-ai D11); `None` is the model's own default. Like the mode, chosen at any time and applied from the next message.
pinned_at	Timestamp or null	When the person pinned this chat (AI schema 12); `None` when it is not pinned. The pinned chats are listed oldest pin first. Pinning is not activity: the chat keeps its place among the others.
profile_id	ProfileId or null	The profile the chat belongs to (AI schema 13, koru-ai D120): the profile of the window it was started in, its source's for a branch. Its list, its search hits and the workspaces it may read are that profile's. `None` only for a chat written before schema 13 that the service has not yet placed (it places each one as soon as the Store answers: [`crate::place_chat`]), and on an older server's answer.
created_atrequired	Timestamp	Epoch milliseconds, UTC. Signed, so instants before 1970 are representable.
updated_atrequired	Timestamp	Epoch milliseconds, UTC. Signed, so instants before 1970 are representable.

Example

{
  "id": "00000000-0000-4000-8000-000000000000",
  "title": "string",
  "private": false,
  "current_model": {
    "provider": "string",
    "requested_model": "string",
    "default_reasoning": "default"
  },
  "branched_from": {
    "chat_id": "00000000-0000-4000-8000-000000000000",
    "through_message_id": "00000000-0000-4000-8000-000000000000"
  },
  "agent_working_folder": "string",
  "agent_mode": "string",
  "agent_fast": false,
  "pinned_at": 0,
  "profile_id": "00000000-0000-4000-8000-000000000000",
  "created_at": 0,
  "updated_at": 0
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Generated from contract version 1. Last updated November 12, 2026.