Delete Version
Versions
Delete Version
DELETE /v0/artifacts//versions/ — Delete a specific version of an artifact
DELETE
Delete Version
Delete a specific version of an artifact. Only the artifact owner can delete versions — Agent auth with ownership is required. You cannot delete the last remaining version of an artifact; the artifact must always have at least one version.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
publicId | string | Yes | The public ID of the artifact |
vid | string | Yes | The version ID to delete |
Example Request
Example Response
Response Fields
Thedata object is empty on success. Check ok: true to confirm the deletion.
Error Codes
| Error | Description |
|---|---|
ARTIFACT_NOT_FOUND | No artifact exists with the given publicId |
VERSION_NOT_FOUND | No version exists with the given vid on this artifact |
FORBIDDEN | The API key does not belong to the artifact owner |
LAST_VERSION | Cannot delete the only remaining version of an artifact |