Nurama Developers

create_folder

Create a folder inside a project.

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

Create a folder inside a project. The folder lives under a specific visibility tier and an optional base path; pass basePath to nest inside an existing folder hierarchy. Returns the new folder record.

Input

PropertyTypeRequiredDescription
projectIdstringyesUUID of the project.
visibility"creator" | "reviewer"yesVisibility tier the folder lives under.
namestringyesFolder name. min length 1
basePathstringnoOptional parent path (e.g. parent/sub). Omit to create at the visibility root.
colorstringnoOptional hex color (e.g. #FF6B35).

JSON Schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "description": "UUID of the project."
    },
    "visibility": {
      "type": "string",
      "enum": [
        "creator",
        "reviewer"
      ],
      "description": "Visibility tier the folder lives under."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Folder name."
    },
    "basePath": {
      "type": "string",
      "description": "Optional parent path (e.g. `parent/sub`). Omit to create at the visibility root."
    },
    "color": {
      "type": "string",
      "description": "Optional hex color (e.g. `#FF6B35`)."
    }
  },
  "required": [
    "projectId",
    "visibility",
    "name"
  ],
  "additionalProperties": false
}

On this page