Artifacts
Unpublish Artifact
Ends the active publication: no version is shared any more and every access grant (people, teams, workspace and the public link) is deleted, so nobody but the owner and Artifacts Manager holders can open it. Sharing again starts fresh. The owner may publish again later; an unpublish by a manager (artifacts:manage) cannot be undone by the owner.
DELETE
Unpublish an artifact
Authenticate with a Tess API token in the
Authorization: Bearer header. See the Artifacts API guide for the full flow, permissions and ownership rules.
Code Examples
Path Parameters
The artifact ID (
universal_id), for example artifact_5d1f0c2e-8a3b-4c6d-9e7f-1a2b3c4d5e6f.Headers
Workspace ID. Required as of 2026-09-01. Until then, if omitted, the user’s selected workspace is used (deprecated). After the cutoff, a missing header returns 422.
Response
200Response fields
null: nothing is shared.Errors
Authorizations
Response
Unpublished (or nothing was published)

