Projects

get_project

Get the details of a specific project, including its members, documents, context items, and brief. Find project IDs with list_projects.

Parameters

Name	Type	Required	Default	Description
`project_id`	`string (uuid)`	Yes	—	The project's UUID, exactly as returned in the `project_id` field of list_projects or create_project. A numeric id or a project name will not resolve. You must be a member of the project's team, and if the project is private you must also be one of its members, or the call is rejected.

Input Schema

{
  "type": "object",
  "required": [
    "project_id"
  ],
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "description": "The project's UUID, exactly as returned in the `project_id` field of list_projects or create_project. A numeric id or a project name will not resolve. You must be a member of the project's team, and if the project is private you must also be one of its members, or the call is rejected."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "id",
    "name"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Project ID."
    },
    "name": {
      "type": "string",
      "description": "Project name."
    },
    "status": {
      "type": "string",
      "description": "Project status."
    },
    "members": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "user_id": {
            "type": "integer"
          }
        }
      },
      "description": "Project members."
    },
    "documents": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "stage": {
            "type": "string"
          },
          "purpose": {
            "type": "string",
            "description": "Role of content in project (e.g. supporting)."
          },
          "web_url": {
            "type": "string"
          },
          "category": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "integer"
              },
              "name": {
                "type": "string"
              }
            }
          },
          "is_ready": {
            "type": "boolean",
            "description": "Whether generation is complete."
          },
          "content_id": {
            "type": "string",
            "format": "uuid",
            "description": "Content UUID — pass to get_content or update_content."
          },
          "visibility": {
            "type": "string"
          },
          "in_project_context": {
            "type": "boolean",
            "description": "Whether included in project context for AI generation."
          }
        }
      },
      "description": "Documents in this project."
    },
    "created_at": {
      "type": "integer",
      "description": "Unix timestamp of creation."
    },
    "visibility": {
      "type": "string",
      "description": "Visibility setting."
    },
    "context_items": {
      "type": "array",
      "description": "Context items associated with this project."
    },
    "project_brief": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "content_id": {
          "type": "string",
          "format": "uuid"
        }
      },
      "description": "The project's pinned brief document, if set. {name, content_id} — same shape as create_project's project_brief field. Pass content_id to update_content / get_content to edit or read the brief. null if the project has no brief set."
    }
  }
}

Instructions

Returns details for a specific project including its members, documents, context items, and (when set) a top-level project_brief shortcut so the brief is directly addressable for follow-up edits via update_content.

Example prompts

"Show me the details of my product launch project"
"What documents are in this project?"
"Open the brief for the Acme project so I can edit it"