All tools
ToolWrite

Update Project overview

update_project_overview

Use only when the user asks the agent to revise or clear an AI-managed Project overview, AI overview is enabled, and the Project has no user-written overview.

When to use it

Use only when the user asks the agent to revise or clear an AI-managed Project overview, AI overview is enabled, and the Project has no user-written overview.

Typical workflow

Find candidate library objects before reading full evidence.

What it returns

Metadata lists, ids, snippets, activity, and discovery hints.

Avoid using it when

Do not use when AI overview is disabled or descriptionEditedAt is set. Never replace user-written overview text.

Advanced input contract

Agent hosts use this JSON Schema to validate the exact input shape.

View full registry notes

Revise or clear the AI-managed overview shown at the top of an active private Prism Project. Read get_prism_workspace_context first and pass the Project's latest updatedAt. The Project must have AI overview enabled and no user-written overview. This cannot rename, move, archive, or delete the Project. Use when: Use only when the user asks the agent to revise or clear an AI-managed Project overview, AI overview is enabled, and the Project has no user-written overview. Avoid when: Do not use when AI overview is disabled or descriptionEditedAt is set. Never replace user-written overview text.

View JSON Schema
{
  "type": "object",
  "properties": {
    "folderId": {
      "type": "string",
      "format": "uuid"
    },
    "overview": {
      "type": "string",
      "maxLength": 3000,
      "description": "The complete replacement Project overview. Pass an empty string to clear it."
    },
    "expectedUpdatedAt": {
      "type": "string",
      "format": "date-time",
      "description": "The latest Project updatedAt returned by get_prism_workspace_context."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Required for mode=preview."
    },
    "operationId": {
      "type": "string",
      "format": "uuid"
    },
    "commitToken": {
      "type": "string",
      "minLength": 1
    },
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "commit"
      ],
      "default": "preview"
    }
  },
  "required": [
    "folderId",
    "overview",
    "expectedUpdatedAt"
  ],
  "additionalProperties": false
}

Useful next tools