Skip to main content
POST
Publish an artifact version
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.

Request Body

integer
Version to share (minimum 1). Defaults to the latest version.

Response

200

Response fields

string
active while a version is shared.
integer
Latest version number.
integer | null
Version people with access see.
boolean
Whether the shared version is the latest one.
string
Readable summary of what is shared.
string
Link that opens the artifact in Tess.

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

Body

application/json
version
integer | null
Required range: x >= 1

Response

Published

universal_id
string
title
string
status
string
head_version
integer
shared_version
integer
viewer_url
string