Projects

update_project

Update mutable fields on an existing project (name, visibility, status, project brief).

Input Schema

{
  "type": "object",
  "required": [
    "project_id"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "New project name. Must be non-empty when provided. Omit to leave unchanged."
    },
    "status": {
      "enum": [
        "active",
        "archived"
      ],
      "type": "string",
      "description": "New project status. active for ongoing work; archived to hide from the active list while preserving content. Setting to active requires available active-project usage. Omit to leave unchanged."
    },
    "project_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of the project to update. Get from list_projects or get_project."
    },
    "visibility": {
      "enum": [
        "team",
        "private"
      ],
      "type": "string",
      "description": "New visibility setting. team makes it visible to all team members; private restricts to the creator and explicit project members. Omit to leave unchanged."
    },
    "project_brief_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of an existing content item to set as this project's brief. If the content isn't already attached to the project, this tool will attach it AND set it as the brief in one call."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "success",
    "message"
  ],
  "properties": {
    "message": {
      "type": "string",
      "description": "Human-readable status message."
    },
    "project": {
      "type": [
        "object",
        "null"
      ],
      "description": "The updated project record."
    },
    "success": {
      "type": "boolean",
      "description": "True if the update applied successfully."
    }
  }
}

Instructions

Use this tool to update mutable fields on an existing MarketCore project.

To set or change the project's brief, pass an existing content UUID as project_brief_id - the tool resolves it to the appropriate document wrapper internally. If the content isn't already attached to the project, this tool will attach it for you AND set it as the brief in one call — you don't need to add the content separately first.

Important notes:

Only fields you pass are updated (PATCH semantics). Omit a field to leave it unchanged.
visibility must be exactly team or private.
status must be exactly active or archived.
name must be non-empty when provided.

Common use cases:

"Set the brief on the Acme Launch project to " -> call with project_id and project_brief_id (works whether or not the content is already in the project).
"Rename the project" -> call with project_id and name.
"Make the project private" -> call with project_id and visibility="private".
"Archive the project" -> call with project_id and status="archived".