GET https://api.zatomic.ai/v1/prompts/{promptId}/versions
// Examples
GET https://api.zatomic.ai/v1/prompts/{promptId}/versions
GET https://api.zatomic.ai/v1/prompts/{promptId}/versions?expand=scoring
GET https://api.zatomic.ai/v1/prompts/{promptId}/versions?expand=risk
GET https://api.zatomic.ai/v1/prompts/{promptId}/versions?expand=balance
GET https://api.zatomic.ai/v1/prompts/{promptId}/versions?expand=heatmap
Zatomic API
- Introduction
- Versioning
- Authentication
- Workspaces
- Status codes and errors
- Token usage
- Expanding objects
- OpenAPI spec
- Prompts
- The Prompt object
- Creating a prompt
- Updating a prompt
- Deleting a prompt
- Retrieving a prompt
- Retrieving all prompts
- Generating a prompt
- Versions
- The Version object
- Creating a version
- Updating a version
- Deleting a version
- Retrieving a version
- Retrieving all versions
- Retrieving a version score
- Calculating a version score
- Retrieving a version risk
- Analyzing a version risk
- Retrieving a version balance
- Analyzing a version balance
- Retrieving a version heatmap
- Generating a version heatmap
- Improving a version
- Scoring Criteria
- The Scoring Criteria object
- The Scoring Criterion object
- Creating scoring criteria
- Updating a scoring criteria
- Deleting a scoring criteria
- Retrieving a scoring criteria
- Retrieving all scoring criteria
- Generating scoring criteria
- Creating a scoring criterion
- Updating a scoring criterion
- Deleting a scoring criterion
- Retrieving a scoring criterion
- Scoring Criteria Results
- The Scoring Criteria Results object
- Scoring
- The Scoring object
- Calculating a prompt score
- Risk
- The Risk object
- Analyzing prompt risk
- Balance
- The Balance object
- Analyzing prompt balance
- Heatmaps
- The Heatmap object
- Generating a prompt heatmap
Retrieving all versions
Returns the list of all versions for prompt, sorted by version updated date in descending order.
A successful call returns a response that contains a list of version objects.
| Expands | |
|---|---|
| scoring | Retrieves the scoring object for each version in the list. |
| risk | Retrieves the risk object for each version in the list. |
| balance | Retrieves the balance object for each version in the list. |
| heatmap | Retrieves the heatmap object for each version in the list. |
Endpoint
Response Body
[
{
"version_id": "ver_2qRzu8qzlNOMhTrini2EKCDh5r6",
"prompt_id": "prm_2qRzu8geIvfudcJTwP0pur4TbMJ",
"created": "2024-12-19T20:33:16.076891Z",
"created_by": "Han Solo",
"updated": "2024-12-19T20:39:13.026997Z",
"updated_by": "Han Solo",
"name": null,
"is_primary": true,
"content": "You are a knowledgeable and friendly assistant...",
"variables": [
"{{variable1}}",
"[[variable2]]"
],
"token_info": {
"model": "gpt-4.1",
"token_count": 0,
"cost_per_use": 0.0,
"cost_per_1k": 0.0,
"cost_per_1m": 0.0
},
"scoring": null,
"risk": null,
"balance": null,
"heatmap": null
}
]