Skip to main content

Delete an artifact

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 parameters

session_id string (required)Session that owns the artifactartifact_id string (required)Artifact version ID to deleteNo request body.

Request example

curl -sS -X DELETE \
  "$BASE_URL/agents/sessions/sess_xxx/artifacts/artifact_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "OpenAI-Beta: agents=v1"

Response fields

id stringDeleted 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

{
  "id": "artifact_xxx",
  "object": "agent.session.artifact.deleted",
  "deleted": true
}

Error codes

HTTP statusError type / codeSolution
404not_found_error / not_found_errorUse an artifact ID that exists and has not been deleted in the current workspace
The error body has the shape {"error":{"type","code","message","param"}}. Gateway errors can use a different structure.