Get a prompt
Retrieves a prompt by its ID, including the active template. Pass version to get a specific version’s template. Pass variables as a JSON-encoded map to render the template with substitutions.
Authorizations
Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.
Headers
Optional external end-user identifier forwarded by the API gateway.
Path Parameters
Prompt identifier
Query Parameters
Version to retrieve — defaults to active version
-9007199254740991 <= x <= 9007199254740991JSON-encoded key-value map to render into the template, e.g. {"name":"Alice"}
Response
OK
Unique prompt identifier
Object type
Human-readable prompt name
Currently active version number
-9007199254740991 <= x <= 9007199254740991Most recent version number
-9007199254740991 <= x <= 9007199254740991Custom metadata key-value pairs
Timestamp when the prompt was created
Timestamp when the prompt was last updated
The template text for the requested version
Detailed description of the prompt
The template with variables substituted — only present when variables are provided