Nurama Developers

create_ai_chat_topic

Create a new (empty) AI chat topic — one of Nu's LLM-assistant conversations.

Mutating tool: it changes data in Nurama. Available only when the key carries the matching scope.

Create a new (empty) AI chat topic — one of Nu's LLM-assistant conversations. After this resolves, post the first user message via send_message against the returned topic.chatId; Nurama recognises the chat as an AI chat and routes the message to the assistant. Pre-flight: workspace needs the AI add-on and aiChatEnabled resolved true; AI calls also charge credits from the workspace pool.

Input

PropertyTypeRequiredDescription
workspaceIdstringyesUUID of the workspace. Required for every scope.
scopeType"workspace" | "project" | "social"yesTopic scope. workspace = cross-project; project = bound to one project; social = personal.
scopeIdstringnoUUID of the workspace or project. Required when scopeType is workspace or project; omit for social.
titlestringnoOptional title. Auto-named from first user message when omitted.

JSON Schema

{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "description": "UUID of the workspace. Required for every scope."
    },
    "scopeType": {
      "type": "string",
      "enum": [
        "workspace",
        "project",
        "social"
      ],
      "description": "Topic scope. `workspace` = cross-project; `project` = bound to one project; `social` = personal."
    },
    "scopeId": {
      "type": "string",
      "description": "UUID of the workspace or project. Required when `scopeType` is `workspace` or `project`; omit for `social`."
    },
    "title": {
      "type": "string",
      "description": "Optional title. Auto-named from first user message when omitted."
    }
  },
  "required": [
    "workspaceId",
    "scopeType"
  ],
  "additionalProperties": false
}

On this page