Request parameters for v2/prompt

Use the POST /api/v2/prompt endpoint to invoke a published public prompt template from the Prompt Catalog by name.

The endpoint resolves the saved template, substitutes any variables, applies the stored model configuration, and returns the LLM response. This method provides programmatic access to Prompt Catalog templates through the LLM Passthrough APIs. It removes the need to copy prompt text into API requests.

Note: You can invoke only published Public templates through this endpoint. You cannot access private or draft templates.

This table shows the list of api/v2/prompt endpoint parameters with other details for further model configuration:

Parameter Type Required Description
promptName string true The name of the published public prompt template to invoke
parameters object false Key-value pairs of variable substitutions.
config ModelConfig false Override the model configuration stored in the template. If not provided, the template’s stored configuration is used automatically.

Request example for v2/prompt

{
  "promptName": "ProcurementSummary",
  "parameters": {
    "supplierId": "SUP-4821",
    "region": "EMEA",
    "fiscalYear": "2026"
  },
  "config": {
    "max_response": 512,
    "temperature": 0.3
  }
}[