Context & Resources

update_context

Update an existing context item — change its name, content, or move it between collections / projects. If the item has a linked editing canvas open in the MarketCore sidebar, its title and content stay in sync automatically.

Input Schema

{
  "type": "object",
  "required": [
    "context_item_id",
    "collection_id",
    "project_id"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "If provided, updates the name. Omit to leave unchanged."
    },
    "content": {
      "type": "string",
      "description": "If provided, updates the content. Omit to leave unchanged. Triggers RAG re-embedding."
    },
    "project_id": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid",
      "description": "Full replace. Pass the current ID to keep the project association, pass a different ID to move it, or pass null to disassociate it."
    },
    "collection_id": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Full replace. Pass the current ID to keep the item in its collection, pass a different ID to move it, or pass null to remove it from any collection."
    },
    "context_item_id": {
      "type": "string",
      "format": "uuid",
      "description": "The context item to update."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Context item ID."
    },
    "name": {
      "type": "string",
      "description": "Updated context item name."
    },
    "content": {
      "type": "string",
      "description": "Updated reference content."
    },
    "link_url": {
      "type": "string",
      "description": "Direct URL to view this context item in the MarketCore app."
    },
    "project_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Project this item is associated with (null if none)."
    },
    "updated_at": {
      "type": "integer",
      "description": "Unix timestamp of last update."
    },
    "word_count": {
      "type": "integer",
      "description": "Word count of updated content."
    },
    "collection_id": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Collection this item belongs to (null if none)."
    },
    "content_intro": {
      "type": "string",
      "description": "Truncated content intro used in listings."
    },
    "relevancy_processed_status": {
      "type": "string",
      "description": "RAG re-processing status (unprocessed, provisional, complete). Flips to unprocessed whenever name or content changes."
    }
  }
}

Instructions

Use this tool to update an existing context item in your reference library.

What you can update:

name: rename the context item (omit to leave unchanged)
content: replace the stored reference content (omit to leave unchanged; triggers RAG re-embedding)
collection_id: move to a different collection, or pass null to remove from all collections
project_id: change the project association, or pass null to disassociate

Important — full-replace semantics for collection_id and project_id: Unlike name and content, you MUST pass collection_id and project_id on every call. Omitting them is NOT the same as keeping them unchanged — include the current values to preserve them. If you do not know the current values, call get_context_item first or use the web app to check before updating.

Workflow:

Get the context_item_id (UUID) — use list_context_items, list_context_collections, get_project, or get_relevant_context to find IDs.
Pass collection_id and project_id (required, nullable) — include current values to preserve, or null to clear.
Optionally pass name and/or content to update those fields.