Kumiho Action icon

Kumiho Action

Create, read, update, or delete Kumiho resources.

Actions28

Revision → Read

AI-generated

Summary

Retrieve revision data, artifacts, tags, or graph structures by Kref, tag, or graph traversal mode.

Inputs

  • resource (required) — Revision (fixed for this operation)
  • operation (required) — Read (fixed for this operation)
  • readModeRevision (required) — Select read mode: Analyze Impact, Find Path, Get Dependencies, Get Revision (by Kref), Get Revision (by Tag), Has Tag, List Edges, List Revision Artifacts, List Revision Tags, Was Tagged
  • revisionKrefReadGetByKref — Revision Kref (e.g., kref://project/space/item.kind?r=1)
  • itemKrefRevisionGetByTag — Item Kref for tag-based revision lookup
  • itemKrefRevisionHasTag — Item Kref for tag existence check (e.g., kref://project/space/item.kind)
  • revisionKrefRevision — Revision Kref for artifact/tag listing
  • kref — Revision Kref for tag history/listing
  • tagRead — Tag name; defaults to 'latest'
  • revisionNumberRead — Optional non-negative integer revision number
  • sourceKref — Source Kref for graph path/impact modes
  • targetKref — Target Kref for graph path/impact modes
  • edgeTypeFilter — Optional single edge type filter
  • direction — Outgoing (0), Incoming (1), Both (2) for graph list edges
  • maxDepth — Optional non-negative integer; default 5 for graph modes
  • edgeTypes — Optional comma-separated list of edge types (e.g., DEPENDS_ON,DERIVED_FROM)
  • outputFormatRevision — Split Into Items or Single Item (Array)
  • returnAllRevision — Whether to return all results or limit the result size; default true
  • limitRevision — Maximum number of results; default 100; ignored if returnAllRevision is true

Output shape

Depends on read mode: single revision object, artifact/list array, tag list, {has_tag, tag} status, or graph data (edges/dependencies/path/impact). All list modes support 'split' (one item per entry) or 'singleArray' (one array item) via outputFormatRevision. ReturnAll and Limit parameters control result volume.

Modes returning lists (revisionListArtifacts, revisionListTags, graphListEdges) emit array items per the chosen outputFormat. Single-get modes (revisionGetByKref, revisionGetByTag, revisionHasTag, revisionWasTagged) return one item. Graph modes call the Kumiho API under /api/v1/graph/... with query parameters as specified in the source.

Examples

Example 1: Get a specific revision by Kref

readModeRevision=revisionGetByKref, revisionKrefReadGetByKref=kref://project/space/item.kind?r=1

Example 2: List all artifacts for a revision

readModeRevision=revisionListArtifacts, revisionKrefRevision=kref://project/space/item.kind

Example 3: Check if a revision has a specific tag

readModeRevision=revisionHasTag, itemKrefRevisionHasTag=kref://project/space/item.kind, tagRead=production

Links

Discussion