ts.art.update

Update artifact attributes (partial update).

Requires authentication

Description

Updates one or more fields of an existing artifact. Only provided fields are changed; omitted fields remain unchanged.

To archive an artifact, set status to “archived”. To unlink from an endeavour or task, pass an empty string.

Name	Type	Required	Description
`id`	string	Yes	Artifact ID
`title`	string		New title
`kind`	string		New kind
`url`	string		New URL
`summary`	string		New summary
`tags`	array		New tags (replaces existing)
`status`	string		New status: active, archived
`endeavour_id`	string		New endeavour (empty string to unlink)
`task_id`	string		New task (empty string to unlink)
`metadata`	object		Metadata to set (replaces existing)

Returns the artifact ID and list of fields that were updated.

{
  "id": "art_d4e5f6a1b2c3...",
  "updated_at": "2026-02-09T12:00:00Z",
  "updated_fields": [
    "status"
  ]
}

Code	Description
`not_authenticated`	No active login for this session
`not_found`	Artifact with this ID does not exist
`invalid_input`	No fields to update

Mark an artifact as archived.

Request:

{
  "id": "art_d4e5f6a1b2c3...",
  "status": "archived"
}

Response:

{
  "id": "art_d4e5f6a1b2c3...",
  "updated_at": "2026-02-09T12:00:00Z",
  "updated_fields": [
    "status"
  ]
}

Replace the tag set on an artifact.

Request:

{
  "id": "art_d4e5f6a1b2c3...",
  "tags": [
    "architecture",
    "decision-record",
    "approved"
  ]
}

Response:

{
  "id": "art_d4e5f6a1b2c3...",
  "updated_at": "2026-02-09T12:00:00Z",
  "updated_fields": [
    "tags"
  ]
}