Skip to main content
Helicone OSS LLM Observability

Get Request Inputs

Retrieve the prompt template inputs (variables) used for a specific request made through AI Gateway prompt management.
1 min read
get/v1/request/{requestId}/inputs
Request example
Response
get/v1/request/{requestId}/inputs
Warning

For users in the European Union: Please use eu.api.helicone.ai instead of api.helicone.ai.

Overview#

When you use Prompt Management through the AI Gateway, template variables (inputs) are stored automatically. This endpoint lets you retrieve those inputs by request ID — useful for building testing pipelines that replay past requests against new prompt versions.

Use Cases#

  • Regression testing: Pull a past request's inputs and replay them against a new prompt version to validate behavior.
  • Prompt comparison: Compare outputs across prompt versions using the same inputs, without storing inputs separately on your end.
  • Debugging: Inspect the exact variables that were injected into a prompt template at runtime.
Note
Request data is retained for 90 days. Plan your testing workflows accordingly.

Response#

Returns null for data if the request has no associated inputs (e.g., the request was not made through prompt management, or the request ID doesn't exist).

Example Response#

No Inputs Found#

Authorization

Authorizationstringheaderrequired#
Bearer token authentication. Format: 'Bearer YOUR_API_KEY'

Path parameters

requestIdstringrequired#

Responses

application/json
200
Ok