Skip to main content

​
Revoke Artifact

Revoke an artifact to prevent any further retrieval. Once revoked, collectors can no longer access the artifact.

​
Endpoint

DELETE /ramp/artifacts/{artifact_id}

​
Path Parameters

ParameterTypeRequiredDescription
artifact_idstringYesThe artifact ID

​
Request

curl -X DELETE https://api.docyard.io/v1/ramp/artifacts/art-abc123 \
  -H "X-API-Key: dk_live_dist_aaaaaaaa"

​
Response

{
  "id": "art-abc123",
  "status": "revoked",
  "revoked_at": "2026-03-15T15:00:00Z",
  "message": "Artifact has been revoked. Collectors can no longer retrieve."
}