Plans

get_plan

Fetch a single plan by UUID with linked references, context collections, targeting dimensions, and metadata.

Input Schema

{
  "type": "object",
  "required": [
    "plan_uuid"
  ],
  "properties": {
    "plan_uuid": {
      "type": "string",
      "format": "uuid",
      "description": "The UUID of the plan to fetch. Use plan_uuid, not the integer id."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "plan": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer"
        },
        "stage": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "prompt": {
          "type": "string"
        },
        "source": {
          "type": "string"
        },
        "team_id": {
          "type": "integer"
        },
        "due_date": {
          "type": "string"
        },
        "plan_uuid": {
          "type": "string"
        },
        "created_at": {
          "type": "string"
        },
        "created_by": {
          "type": "integer"
        },
        "project_id": {
          "type": "string"
        },
        "updated_at": {
          "type": "string"
        },
        "assigned_to": {
          "type": "integer"
        },
        "category_id": {
          "type": "integer"
        },
        "description": {
          "type": "string"
        },
        "blueprint_id": {
          "type": "string"
        },
        "_produced_content": {
          "type": "object",
          "description": "The linked content object or null. When non-null contains at minimum: content_id, name, stage, visibility."
        },
        "context_collections": {
          "type": "array"
        },
        "produced_content_id": {
          "type": "string"
        },
        "reference_documents": {
          "type": "array",
          "description": "Content UUIDs accessible to the current user."
        },
        "targeting_dimensions": {
          "type": "array"
        },
        "_source_metadata_resolved": {
          "type": "object"
        }
      }
    }
  }
}

Instructions

Fetches a single plan by its UUID, including all associated data.

Use plan_uuid (not the integer id) — always use the UUID form when working with plans.

The response includes:

All core plan fields (stage, title, source, dates, etc.)
reference_documents — content UUIDs accessible to the current user
context_collections — context collections pre-attached to the plan
targeting_dimensions — targeting dimension options pre-attached
_produced_content — the content item produced from this plan (or null if not yet created)
_source_metadata_resolved — resolved source metadata object (or null)