---
title: "Update"
method: PATCH
path: "/api/v1/artifacts/{id}"
tags: ["Artifact"]
---

# Update

`PATCH /api/v1/artifacts/{id}`

## Request

- Base URL: `https://example.conductor.one`
- URL: `https://example.conductor.one/api/v1/artifacts/{id}`
- Auth: HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `/auth/v1/token`

Update changes selected catalog name, description or tags for a current Owner.
 It does not publish content or change the current publication pointer.

## Path parameters

- `id` string, required: Unique opaque identifier for this Artifact.

## Request body

- C1ApiArtifactV1ArtifactServiceUpdateRequestInput: ArtifactServiceUpdateRequest changes only selected audience-visible metadata. Consumers must require a nonempty unique mask relative to Artifact, drawn exactly from display_name, description and tags. Wildcards, nested paths, unknown paths and output-only fields (including the publication pointer) are rejected; only selected fields are applied. Recursive Artifact validation is skipped so description-only or tags-only updates do not require a name. Consumers must manually validate artifact.id and selected fields after normal hooks: ID shape, field byte bounds, tag grammar, count and uniqueness, and a nonempty, non-Unicode-whitespace-only display_name when selected. Names must not be automatically trimmed. Generated validation checks only artifact and update_mask message presence; it does not enforce mask semantics or selected-field validation.
  - `artifact` C1ApiArtifactV1Artifact: Artifact is audience-visible catalog metadata, not an authoring package. It contains no source identities, storage references, cells or arguments.
    - `createdAt` string, date-time, nullable
    - `description` string: Optional audience-visible description; never guarded draft text.
    - `displayName` string: Current Owner-managed catalog name, independent of pinned-version source text. Consumers reject Unicode-whitespace-only names without trimming valid names.
    - `id` string: Unique opaque identifier for this Artifact.
    - `publishedVersionNumericId` string, int64: Exact current publication number; zero means unpublished. Never infer the current publication from the largest version number. JS clients use strings.
    - `tags` string[], nullable: Optional unique lowercase ASCII topic tokens, not permissions or classifications.
    - `updatedAt` string, date-time, nullable
    - `viewerUrl` string: Server-generated viewer link when published; empty when unpublished. This is not a download capability and every open checks current grants.
  - `updateMask` string, nullable

## Response `200`

ArtifactServiceUpdateResponse contains the updated catalog metadata.

- C1ApiArtifactV1ArtifactServiceUpdateResponse: ArtifactServiceUpdateResponse contains the updated catalog metadata.
  - `artifact` C1ApiArtifactV1Artifact: Artifact is audience-visible catalog metadata, not an authoring package. It contains no source identities, storage references, cells or arguments.
    - `createdAt` string, date-time, nullable
    - `description` string: Optional audience-visible description; never guarded draft text.
    - `displayName` string: Current Owner-managed catalog name, independent of pinned-version source text. Consumers reject Unicode-whitespace-only names without trimming valid names.
    - `id` string: Unique opaque identifier for this Artifact.
    - `publishedVersionNumericId` string, int64: Exact current publication number; zero means unpublished. Never infer the current publication from the largest version number. JS clients use strings.
    - `tags` string[], nullable: Optional unique lowercase ASCII topic tokens, not permissions or classifications.
    - `updatedAt` string, date-time, nullable
    - `viewerUrl` string: Server-generated viewer link when published; empty when unpublished. This is not a download capability and every open checks current grants.

## Changes

- **2026-10-06** `918a4e749f56`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/artifacts/:id/patch.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) - [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conductorone/apis/c1-api/revisions/fe943bedf41b?raw)