Skip to navigation
API ReferenceContainer Registry

Delete artifact

Permanently deletes one image and every tag that points to it. Requires confirm=true. Requires scope: container-registry.write.

# Example request with curl (set IBEE_API_TOKEN to a platform API token and WORKSPACE_ID to the workspace first).
# REGISTRY_ID: Registry ID
# REFERENCE: Image digest (`sha256:
curl -X DELETE "https://api.ibee.ai/v1/container-registry/registries/$REGISTRY_ID/artifacts/$REFERENCE?workspace_id=$WORKSPACE_ID&repository_name=<repository_name>&confirm=True" \
  -H "Authorization: Bearer $IBEE_API_TOKEN"

Authentication

AuthorizationBearer

IBEE platform API token. Production tokens start with ibee_prod_key_; development tokens start with ibee_dev_key_. Use a token only with its matching gateway environment.

Path parameters

registry_idstringRequiredformat: "uuid"
Registry ID.
referencestringRequired>=1 character

Image digest (sha256:...) or tag.

Query parameters

workspace_idstringRequiredformat: "^[1-9][0-9]*$">=1 character

The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.

repository_namestringRequired1-255 characters

Repository name inside the registry, for example api or team/api.

confirmbooleanRequired

Must be true to confirm permanent deletion.

Response

Artifact deleted.
detailstring

Human-readable result.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
503
Service Unavailable Error