Kumiho Action icon

Kumiho Action

Create, read, update, or delete Kumiho resources.

Actions28

Artifact → Update

AI-generated

Summary

Update artifact metadata or deprecate an artifact.

Inputs

  • updateModeArtifact (required) — Selects the update mode: 'Update Metadata' or 'Deprecate'. Defaults to 'Update Metadata'.
  • artifactKref (required) — Kref of the artifact to update or deprecate (e.g., kref://project/space/item.kind?r=1). Shown for update and delete operations.
  • artifactMetadataUpdate — Metadata to apply when Update Mode is 'Update Metadata'. Type: JSON object. Merged with legacy metadata field; this field takes precedence if non-empty. Defaults to '{}'.
  • deprecatedArtifact — Whether to mark the artifact as deprecated. Boolean, defaults to true. Only used when Update Mode is 'Deprecate'.

Output shape

The Kumiho API response body reflecting the update or deprecation status.

Both modes require artifactKref as a query parameter (kref) in the API request. The 'Update Metadata' mode uses PATCH /api/v1/artifacts/by-kref?kref= with a merged metadata body. The 'Deprecate' mode uses POST /api/v1/artifacts/deprecate?kref= with body { deprecated: }.

Examples

Example 1: Update artifact metadata

Set updateModeArtifact to 'Update Metadata', provide artifactKref, and optionally set artifactMetadataUpdate.

Example 2: Deprecate an artifact

Set updateModeArtifact to 'Deprecate', provide artifactKref, and optionally adjust deprecatedArtifact (default true).

Links

Discussion