llama-stack-mirror/docs/docs/api/list-all-versions-of-a-specific-prompt.api.mdx
Alexey Rybak 0b6725ac7a api docs
2025-09-23 10:00:13 -07:00

68 lines
7.7 KiB
Text

---
id: list-all-versions-of-a-specific-prompt
title: "List all versions of a specific prompt."
description: "List all versions of a specific prompt."
sidebar_label: "List all versions of a specific prompt."
hide_title: true
hide_table_of_contents: true
api: eJztWF1vEzkU/SvWvFCktmkrEFCtVgosu1sJRFVapFWpkDNzkzF47MH2pI2i/HfO9XiSSROWsNoXpPLCNHPnfhyfc23feebI19Z48tnpPDs5OuL/CvK5U3VQ1mSn2VC8UT6cO1vVwV8kc5FbE6QyykyE1FpMyXmYe2HHIpQk6mh+mO1nbEgmsF9Z11rlkv0OPnt2Ps98XlIl+SnMakI4O/pMecCHcFGTC6pNrZChbyWdkzMYqUCV//HXbTo9Ox8cUofdeq2XSN3PPJymCkSguyBuVSjFVDolRxq1aZlTaXWBmg/Fh/SzF9KRsEbPhG/q2rpAhbgtyYjGM0qMSoeeF8Pzs8NssZ8l3HqZKcA1IbeR2ofWUuwlA+GDRH2MfxDH+0KZ3FEFpBEWZl5O6TFHaOv4pIofV39l1NeGhCrgRY0VYoytq2Rgl9KLRzU7+u3J84NCTVQ4KKUvf38Uq+gw2GGFUuzF/eBMMmZPwn2JtpEV8AolqsylESMCnshHmR7PsEoVViUQu1X+U0Fj2ej+eo+s1SRNLDm9G0vt6X4WL1s7uC8iUwEv1hCRHMIp3/FcKB/DJ2fLn4FXa5cIt0A+sigUe5f6vMfJFN3R10Y5wuJcL7nQX7M+tmul3exnQQXNtbXS3FjNYQcOJG4blxMeajzz4jJrQCCLyOJdTWZ4Jl7BFgVHgq+Dyli/0bKS4n2Q+Rfw9qfKisrtpbulm2zkvmwzlS1Ii2CFZnq0ifmYAVJ4sq1dsYQ5PMH+FqxVZiq1giacqKRmQlPx/7UliDA0fgf5/n15eS5aa/TOIjI1IfIjWb52jmnFxvu8bCV6C3pMVUk36/otRZvbUuUlc5OLBm1MiIwEn9v3MU5UHnq33jVya82htTXcecqmkubAkSyiQnvfrKUTxWhQs8l3qHLvXd3S6bEYiquLN6mYvuZBA0f4mqZMDMfEbBsUR5Yj24QY3NeUo33lwuZ54xwh/L28foa+aYW71VqC12N0hOk74HX7qxiDuzEHbv3iwjaTElvF2Gptb724+POVePb86FncFOhOQnnU5xeovor3UhbYSiLFV/nsyPyknJMX25WTawVVCLR2wY0CkFt8bGadY/YKIkzUFBubrGxjYtMOqqIHUT2I6hcT1cmLVbxLMP0tMz0py/el9Y9toAkgRHc5UcGwsdh4c9SqUuFQnOPYgIQC2CMnOBgL3jldt1M9/d5O5clh2xeAk6VEvB9jbRpDd8Cbz12UYHiQ1oO0fiFpPe3vV2fMbGQu3rdsX8VP8hpuUr4DozgU7xowgWQVd6URYeMxNt5Pik5evfP+vTPwvzh+ENWDqH4tUR1ti7aDhKJKmGpy4rmadPvi7Lfcwe+Pc+QKy9VUp5YO93LImh3OM76k4/v+vVWxQ9woy61Dlt6MYW1itLzqLTPA4nLA1WoE12B1NrTZzRUWqAqZlRam2YSiWjmL02wwPR6kG+Rgvkx1MehCwbLdjtuaGse4liHUp4MBDgYHpfXA9kDzVfjAx6twbquMA3oC0irM4od/dN3o+obfMT9jnt39d3WVFu8TspG9WW8clE2Pt+DGovZr9JZ9wfU9x4EJipwCaf/RiHv/sKgUT+5kitqiX3k0iHiqUQ6tybWMLXhQwM3MjWXeTWGko488+9NxehDspvMR30A0BOrkpMvqLV/kfWR2DRzROxiTxJvdebeGyHzVwH/CReILD/YGtcZRjXOKiz1PTLlu0U9cwdPp2kCmowvWlinB9vP5CKe/K6cXC/4ZB0jHXLhZjW8iMwrl+bnYPnzql7N3kfj+WPwnuWwtspvMmVmcK+mG/8LjF5qtiXdxA+MSnR1bGKfdvh/mOcUxU/flxpa5Jr2/Xl9CjN8AanfbTA==
sidebar_class_name: "get api-method"
info_path: docs/api/llama-stack-specification
custom_edit_url: null
---
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";
<Heading
as={"h1"}
className={"openapi__heading"}
children={"List all versions of a specific prompt."}
>
</Heading>
<MethodEndpoint
method={"get"}
path={"/v1/prompts/{prompt_id}/versions"}
context={"endpoint"}
>
</MethodEndpoint>
List all versions of a specific prompt.
<Heading
id={"request"}
as={"h2"}
className={"openapi-tabs__heading"}
children={"Request"}
>
</Heading>
<ParamsDetails
parameters={[{"name":"prompt_id","in":"path","description":"The identifier of the prompt to list versions for.","required":true,"schema":{"type":"string"}}]}
>
</ParamsDetails>
<RequestSchema
title={"Body"}
body={undefined}
>
</RequestSchema>
<StatusCodes
id={undefined}
label={undefined}
responses={{"200":{"description":"A ListPromptsResponse containing all versions of the prompt.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"prompt":{"type":"string","description":"The system prompt text with variable placeholders. Variables are only supported when using the Responses API."},"version":{"type":"integer","description":"Version (integer starting at 1, incremented on save)"},"prompt_id":{"type":"string","description":"Unique identifier formatted as 'pmpt_<48-digit-hash>'"},"variables":{"type":"array","items":{"type":"string"},"description":"List of prompt variable names that can be used in the prompt template"},"is_default":{"type":"boolean","default":false,"description":"Boolean indicating whether this version is the default version for this prompt"}},"additionalProperties":false,"required":["version","prompt_id","variables","is_default"],"title":"Prompt","description":"A prompt resource representing a stored OpenAI Compatible prompt template in Llama Stack."}}},"additionalProperties":false,"required":["data"],"title":"ListPromptsResponse","description":"Response model to list prompts."}}}},"400":{"description":"The request was invalid or malformed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"integer","description":"HTTP status code"},"title":{"type":"string","description":"Error title, a short summary of the error which is invariant for an error type"},"detail":{"type":"string","description":"Error detail, a longer human-readable description of the error"},"instance":{"type":"string","description":"(Optional) A URL which can be used to retrieve more information about the specific occurrence of the error"}},"additionalProperties":false,"required":["status","title","detail"],"title":"Error","description":"Error response from the API. Roughly follows RFC 7807."},"example":{"status":400,"title":"Bad Request","detail":"The request was invalid or malformed"}}}},"429":{"description":"The client has sent too many requests in a given amount of time","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"integer","description":"HTTP status code"},"title":{"type":"string","description":"Error title, a short summary of the error which is invariant for an error type"},"detail":{"type":"string","description":"Error detail, a longer human-readable description of the error"},"instance":{"type":"string","description":"(Optional) A URL which can be used to retrieve more information about the specific occurrence of the error"}},"additionalProperties":false,"required":["status","title","detail"],"title":"Error","description":"Error response from the API. Roughly follows RFC 7807."},"example":{"status":429,"title":"Too Many Requests","detail":"You have exceeded the rate limit. Please try again later."}}}},"500":{"description":"The server encountered an unexpected error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"integer","description":"HTTP status code"},"title":{"type":"string","description":"Error title, a short summary of the error which is invariant for an error type"},"detail":{"type":"string","description":"Error detail, a longer human-readable description of the error"},"instance":{"type":"string","description":"(Optional) A URL which can be used to retrieve more information about the specific occurrence of the error"}},"additionalProperties":false,"required":["status","title","detail"],"title":"Error","description":"Error response from the API. Roughly follows RFC 7807."},"example":{"status":500,"title":"Internal Server Error","detail":"An unexpected error occurred. Our team has been notified."}}}},"default":{"description":"An unexpected error occurred","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"integer","description":"HTTP status code"},"title":{"type":"string","description":"Error title, a short summary of the error which is invariant for an error type"},"detail":{"type":"string","description":"Error detail, a longer human-readable description of the error"},"instance":{"type":"string","description":"(Optional) A URL which can be used to retrieve more information about the specific occurrence of the error"}},"additionalProperties":false,"required":["status","title","detail"],"title":"Error","description":"Error response from the API. Roughly follows RFC 7807."},"example":{"status":0,"title":"Error","detail":"An unexpected error occurred"}}}}}}
>
</StatusCodes>