artifacts

Update an artifact (add a new version)

patch/artifacts/{id}

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

idstring uuid required

The UUID of the artifact

Request body

contentstring

Updated HTML content of the document. When omitted, no new version is created.

authorType'USER' | 'ASSISTANT'

Who authored this version. Required when content is provided.

letterheadIdstring uuid nullable

Optional letterhead to apply to this artifact (null to remove)

Example request

{
  "content": "<p>Updated meeting notes...</p>",
  "authorType": "USER",
  "letterheadId": "123e4567-e89b-12d3-a456-426614174000"
}

Response

The new version has been created

idstring required

Unique identifier of the version

artifactIdstring required

The artifact this version belongs to

versionNumbernumber required

Sequential version number

contentstring required

HTML content of this version

authorType'USER' | 'ASSISTANT' required

Who authored this version

authorIdobject nullable

ID of the author (user ID if authored by user, null if AI)

createdAtstring required

When this version was created

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "artifactId": "123e4567-e89b-12d3-a456-426614174000",
  "versionNumber": 1,
  "content": "<p>Document content...</p>",
  "authorType": "ASSISTANT",
  "createdAt": "2026-01-15T10:30:00.000Z"
}

Changes

No recorded changes to this operation across all 51 revisions of this API.