Delete a single immutable artifact version without affecting other versions or the original environment file.
Endpoint
DELETE /agents/sessions/{session_id}/artifacts/{artifact_id}
Deletes the specified artifact version. A successful call returns 200 and a delete envelope.
Path parameterssession_idstring (required)Session that owns the artifactartifact_id string (required)Artifact version ID to deleteNo request body. | Request example |
Response fieldsidstringDeleted artifact version IDobject stringArtifact deletion result object type, fixed as agent.session.artifact.deleteddeleted booleanWhether deletion succeeded, true on successDelete removes only the specified artifact version. After deletion, retrieve, download, and repeated delete return 404, and the version no longer appears in lists. Deleting an artifact does not delete the original file in the sandbox or the uploaded source file. | Response example |
Error codes
| HTTP status | Error type / code | Solution |
|---|---|---|
404 | not_found_error / not_found_error | Use an artifact ID that exists and has not been deleted in the current workspace |
{"error":{"type","code","message","param"}}. Gateway errors can use a different structure.