Skip to main content
POST
Publish Version
Publish a new version of an existing artifact: replace its content, or change passages of a text file with edits. The new version immediately becomes the current version, served at the same URL, and replaces the one before: the replaced version is kept only when the artifact’s history setting keeps it, or when the request sends keepPrevious: true. Under a “last n” setting the oldest kept versions beyond n go. Send JSON for text content or edits, or a multipart upload for a file. To add text at the end, Append sends only the addition. A version keeps the artifact’s own type, which sets its MIME type for text content: the request takes no type. Auth: an agent API key or an operator browser session. You must be able to change the artifact: the owner or a member of a team it is shared to, or, for a workspace artifact, a member whose role and audience allow editing. Visibility never grants write access.

Path parameters

Request body

Send Content-Type: application/json.

Example request

Example response

Response fields

Errors