Blueprint Metadata

Retrieve the inputs and outputs of a specific blueprint to understand what data it expects before running it.

GET/api/v1/blueprints/{blueprintId}/metadata

Path Parameters

blueprintId -- The ID of the blueprint to inspect.

Response

Returns the blueprint's inputs (each with a reference ID, target field, and current value) and outputs.

Response shape

{
  "inputs": [
    {
      "blueprintStepId": "step_uuid",
      "nodeType": "inferenceNode",
      "targetField": "prompt",
      "referenceId": "step_abc",
      "name": "Main Prompt",
      "stepType": "image",
      "currentValue": "A cinematic product shot"
    },
    {
      "blueprintStepId": "step_uuid",
      "nodeType": "inputNode",
      "targetField": "mediaId",
      "referenceId": "step_def",
      "name": "Product Image",
      "stepType": "input",
      "currentValue": null,
      "inputMediaKind": "image",
      "mediaUrl": "https://storage.example.com/image.webp"
    }
  ],
  "outputs": [
    {
      "blueprintStepId": "step_uuid",
      "nodeType": "outputNode",
      "stepType": "publish",
      "referenceId": "step_xyz",
      "name": "Final Video"
    }
  ]
}

Example

GET/api/v1/blueprints/{blueprintId}/metadata

curl -X GET https://api.wondercat.ai/api/v1/blueprints/bp_abc123/metadata \
  -H "Authorization: Bearer YOUR_API_KEY"