GET https://api.zatomic.ai/v1/prompts/{promptId}/versions
POST https://api.zatomic.ai/v1/prompts/{promptId}/versions
GET https://api.zatomic.ai/v1/prompts/{promptId}/versions/{versionId}
PATCH https://api.zatomic.ai/v1/prompts/{promptId}/versions/{versionId}
DELETE https://api.zatomic.ai/v1/prompts/{promptId}/versions/{versionId}
GET https://api.zatomic.ai/v1/prompts/{promptId}/versions/{versionId}/scoring
POST https://api.zatomic.ai/v1/prompts/{promptId}/versions/{versionId}/scoring
GET https://api.zatomic.ai/v1/prompts/{promptId}/versions/{versionId}/risk
POST https://api.zatomic.ai/v1/prompts/{promptId}/versions/{versionId}/risk
GET https://api.zatomic.ai/v1/prompts/{promptId}/versions/{versionId}/balance
POST https://api.zatomic.ai/v1/prompts/{promptId}/versions/{versionId}/balance
GET https://api.zatomic.ai/v1/prompts/{promptId}/versions/{versionId}/heatmap
POST https://api.zatomic.ai/v1/prompts/{promptId}/versions/{versionId}/heatmap
POST https://api.zatomic.ai/v1/prompts/{promptId}/versions/{versionId}/improve
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
Versions
Prompt versions, or just versions, are where the actual prompt content is stored, maintained, and analyzed. All versions belong to a parent prompt in a specific workspace. New prompt versions can be auto-generated from a use case.
Versions can be expanded to include all of their scoring, balance, and heatmap data. You can also retrieve and create scoring, risk, balance, and heatmap objects for a version with their specific endpoints.
| Expands | |
|---|---|
| scoring | Retrieves the scoring object for the version. |
| risk | Retrieves the risk object for the version. |
| balance | Retrieves the balance object for the version. |
| heatmap | Retrieves the heatmap object for the version. |
Endpoints