---
title: "POST /v1/prompt/{promptId}/versions/query"
method: POST
path: "/v1/prompt/{promptId}/versions/query"
tags: ["Prompt"]
---

# POST /v1/prompt/{promptId}/versions/query

`POST /v1/prompt/{promptId}/versions/query`

## Path parameters

- `promptId` string, required

## Request body

- PromptVersionsQueryParams
  - `filter` union
    - FilterLeafSubsetPromptsVersions — From T, pick a set of properties whose keys are in the union K
      - `prompts_versions` PartialPromptVersionsToOperators — Make all properties in T optional
        - `minor_version` PartialNumberOperators — Make all properties in T optional
          - `not-equals` number, double
          - `equals` number, double
          - `gte` number, double
          - `lte` number, double
          - `lt` number, double
          - `gt` number, double
        - `major_version` PartialNumberOperators — Make all properties in T optional
          - `not-equals` number, double
          - `equals` number, double
          - `gte` number, double
          - `lte` number, double
          - `lt` number, double
          - `gt` number, double
        - `id` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
        - `prompt_v2` PartialTextOperators — Make all properties in T optional
          - `not-equals` string
          - `equals` string
          - `like` string
          - `ilike` string
          - `contains` string
          - `not-contains` string
    - PromptVersionsFilterBranch
      - `right` PromptVersionsFilterNode, required — recursive
      - `operator` 'or' | 'and', required
      - `left` PromptVersionsFilterNode, required — recursive
    - 'all'
  - `includeExperimentVersions` boolean

## Response `200`

Ok

- union
  - ResultSuccessPromptVersionResultArray
    - `data` PromptVersionResult[], required
      - `id` string, required
      - `minor_version` number, double, required
      - `major_version` number, double, required
      - `prompt_v2` string, required
      - `model` string, required
      - `helicone_template` string, required
      - `created_at` string, required
      - `metadata` RecordStringAny, required — Construct a type with a set of properties K of type T
      - `parent_prompt_version` string, nullable
      - `experiment_id` string, nullable
      - `updated_at` string
    - `error` null, nullable, required
  - ResultErrorString
    - `data` null, nullable, required
    - `error` string, required

---

[API](https://skmtc.net/helicone/apis/helicone-api.md) · [All operations](https://skmtc.net/helicone/apis/helicone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/helicone/helicone-api/revisions/b369e9e3e80c/schema)