Kumiho Action icon

Kumiho Action

Create, read, update, or delete Kumiho resources.

Actions28

Revision → Update

AI-generated

Summary

Update a revision's metadata, deprecation state, or tag

Inputs

  • updateModeRevision (required) — Select the update mode for the revision. Options: revisionUpdateMetadata (update metadata), revisionDeprecate (mark as deprecated), revisionSetTag (set a tag), revisionRemoveTag (remove a tag). Default: revisionUpdateMetadata. Determines which of the remaining parameters appear.
  • revisionKrefUpdateMetadata — Kref of the revision to update (e.g., kref://project/space/item.kind?r=1). Shown when updateModeRevision is revisionUpdateMetadata. If omitted, the legacy krefRevisionUpdate or global kref parameter is used as fallback.
  • krefRevisionUpdate — Legacy Kref parameter. Shown when updateModeRevision is __legacy. If provided, takes priority over the global kref parameter.
  • revisionNumberUpdateDelete — Optional revision number. Non-negative integer. Shown when updateModeRevision is __legacy. If provided, appended as r query parameter to the API request.
  • revisionMetadataUpdate — Metadata to apply to the revision. JSON object. Shown when updateModeRevision is revisionUpdateMetadata. If empty, falls back to the legacy 'metadata' field value. Normalized via kumihoApi.normalizeMetadata (strings converted to string values, null/undefined keys dropped).
  • deprecatedRevision — Whether to mark the revision as deprecated. Boolean. Shown when updateModeRevision is revisionDeprecate. Defaults to true. Passed as deprecated query parameter.
  • revisionKrefTagUpdate — Kref of the revision to tag or untag. Shown when updateModeRevision is revisionSetTag or revisionRemoveTag. If omitted, falls back to the global kref parameter.
  • tagUpdate — Tag name to set or remove. String. Shown when updateModeRevision is revisionSetTag or revisionRemoveTag. Defaults to 'latest'. Passed as tag query/post body parameter.

Output shape

The Kumiho API response body as a JSON object, output as a single item on the main 'main' output. The returned data reflects whatever the specific Kumiho API endpoint returns for the selected update mode.

The node always pushes one item per input via out.push({ json: data }). If the API call fails, a NodeApiError is thrown with kumiho error details (code, message, correlation_id, status_code, retryable flag).

Examples

Example 1: Update revision metadata

Set updateModeRevision to 'revisionUpdateMetadata', provide a valid revision Kref via revisionKrefUpdateMetadata, and supply a metadata JSON object via revisionMetadataUpdate.

Example 2: Deprecate a revision

Set updateModeRevision to 'revisionDeprecate', provide a revision Kref, and optionally toggle deprecatedRevision (defaults to true).

Example 3: Set a tag on a revision

Set updateModeRevision to 'revisionSetTag', provide a revision Kref, and set tagUpdate to the desired tag name (defaults to 'latest').

Links

Discussion