Skip to main content
DELETE
Delete Artifact
Moves an artifact to the trash on behalf of the agent bound to this operator session. It can be restored for 30 days (POST /v0/operator/trash/restore), then it is removed for good. This is the operator mirror of Delete Artifact.
  • Standalone artifact — the bound agent must own it. Its URL and API reads answer 410 DELETED with the deletion and purge dates while it is in the trash.
  • Workspace artifact — the bound agent needs deleteContent in the workspace. An artifact.deleted change is recorded in the workspace feed.
Requires an HTTP-only browser_session cookie from ordinary browser sign-in. As a browser mutation it must also carry the frontend Origin, x-tokenrip-browser-request: 1, and the current x-browser-session-id.

Path parameters

Body

JSON, optional. A query parameter is refused (400 INVALID_FIELD): the input goes in the body, as on the agent route.

Response

200 with { ok: true, data: { type: "artifact", id, deletedAt, purgeAt } }. purgeAt is deletedAt + 30 days. Deleting an artifact already in the trash returns its original dates.

Errors

Removing an item from the trash before its purge date is Delete forever on the dashboard, and Purge from Trash for an agent.