GET https://api.zatomic.ai/v1/prompts
// Examples
GET https://api.zatomic.ai/v1/prompts?expand=versions
GET https://api.zatomic.ai/v1/prompts?expand=scoring
GET https://api.zatomic.ai/v1/prompts?expand=heatmap
GET https://api.zatomic.ai/v1/prompts?expand=balance
GET https://api.zatomic.ai/v1/prompts?expand=risk
Zatomic API
- Overview
- Versioning
- Authentication
- Workspaces
- Status Codes and Errors
- Token Usage
- Expanding Objects
- OpenAPI Spec
- Changelog
- Projects
- The Project Object
- Create Project
- Update Project
- Delete Project
- Retrieve Project
- Retrieve All Projects
- Prompts
- The Prompt Object
- Create Prompt
- Update Prompt
- Delete Prompt
- Retrieve Prompt
- Retrieve All Prompts
- Generate Prompt
- Versions
- The Version Object
- Create Version
- Update Version
- Delete Version
- Retrieve Version
- Retrieve All Versions
- Calculate Version Score
- Retrieve Version Score
- Generate Version Heatmap
- Retrieve Version Heatmap
- Analyze Version Balance
- Retrieve Version Balance
- Analyze Version Risk
- Retrieve Version Risk
- Improve Version
- Scoring Criteria
- The Scoring Criteria Object
- The Scoring Criterion Object
- Create Scoring Criteria
- Update Scoring Criteria
- Delete Scoring Criteria
- Retrieve Scoring Criteria
- Retrieve All Scoring Criteria
- Generate Scoring Criteria
- Create Scoring Criterion
- Update Scoring Criterion
- Delete Scoring Criterion
- Retrieve Scoring Criterion
- Scoring Criteria Results
- The Scoring Criteria Results Object
- Scoring
- The Scoring Object
- Calculate Prompt Score
- Heatmaps
- The Heatmap Object
- Generate Prompt Heatmap
- Balance
- The Balance Object
- Analyze Prompt Balance
- Risk
- The Risk Object
- Analyze Prompt Risk
Retrieve All Prompts
Returns the list of all prompts in a given workspace, sorted alphabetically by prompt name.
| Expands | |
|---|---|
| versions | Retrieves all versions of each prompt in the list. |
| scoring | Retrieves the scoring object for each version of each prompt in the list. |
| heatmap | Retrieves the heatmap object for each version of each prompt in the list. |
| balance | Retrieves the balance object for each version of each prompt in the list. |
| risk | Retrieves the risk object for each version of each prompt in the list. |
Endpoint
Endpoint Response
A successful call returns a response that contains a list of prompt objects.
| HTTP Status Codes | ||
|---|---|---|
| 200 | OK | The prompts were retrieved, or an empty list was returned. |
| 500 | Internal Server Error | Something went wrong on Zatomic's end. |
Response Body
[
{
"prompt_id": "prm_2qJhUNbuEg3J8dvw39jgL3UEJKS",
"workspace_id": "wrk_2nKxr84BuEQIpUl3evP3XYyTxdo",
"created": "2024-12-16T22:03:19.30308Z",
"created_by": "Han Solo",
"updated": "2024-12-16T22:03:19.568618Z",
"updated_by": "Han Solo",
"name": "Prompt name",
"use_case": "Use case description.",
"versions": []
}
]