Skip to main content
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

string
required
The artifact ID (universal_id), for example artifact_5d1f0c2e-8a3b-4c6d-9e7f-1a2b3c4d5e6f.

Headers

integer
required
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

200

Response fields

string
disabled after unpublishing.
boolean
true when a publication was ended.
string
owner or manager.
array
The access grants that were removed.
integer
Latest version number.
integer | null
null: nothing is shared.

Errors

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-workspace-id
integer

Workspace id. If not provided, the user's selected workspace is used.

Path Parameters

universal_id
string
required

Response

Unpublished (or nothing was published)

universal_id
string
title
string
status
string
unpublished
boolean

Whether a version was being shared until this call

revoked_reason
enum<string> | null

Who ended the publication; null when nothing was being shared

Available options:
owner,
manager
revoked_targets
string[]

Access grants this call deleted: user:<id>, team:<id>, workspace:<id> or public

head_version
integer
shared_version
integer | null
latest_version_is_shared
boolean
summary
string