collection_create

Management

Create Collection

Create a new collection. (No description field — the API doesn't accept one.) Args: - name: required — name for the collection - team_id, project_id: required for OAuth callers Returns: the created collection record. Example: "Create a collection for hero assets" -> name="Hero Assets"

open-world

Parameters

Name	Type	Required	Description
name	string	✓	Name for the collection.
team_id	string	—	Team ID. Required if user belongs to multiple teams.
project_id	string	—	Project ID to scope the operation to.
response_format	enum(json \| markdown)	json	Output format: 'json' for structured data, 'markdown' for human-readable text.

Example Request

JSON

{
  "name": "Dragon Concept Art",
  "team_id": "team_abc123",
  "project_id": "proj_xyz789"
}

Example Response

JSON

{
  "collection": {
    "id": "col_dragons",
    "name": "Dragon Concept Art"
  }
}

Common Use Cases

Group related assets into a collection for a specific milestone or sprint
Create a named preset for reuse across generation runs