Actions28
Revision → Create
AI-generatedSummary
Create a revision for an existing item or a graph edge between items.
Inputs
- createModeRevision (required) — Determines the creation mode: Create Revision for an item revision, or Create Edge for a graph edge.
- itemKrefRevisionCreate (required) — Kref of the item to create a revision for (e.g., kref://project/space/item.kind). Required in revisionCreate mode.
- revisionNumberCreate — Optional non-negative integer for the revision number.
- sourceKref — Source item Kref for graph edge creation (must start with kref://). Required in graphCreateEdge mode.
- targetKref — Target item Kref for graph edge creation (must start with kref://). Required in graphCreateEdge mode.
- edgeType — Type of graph edge to create. Options: BELONGS_TO, CONTAINS, CREATED_FROM, DEPENDS_ON, DERIVED_FROM, REFERENCED. Default: DEPENDS_ON. Required in graphCreateEdge mode.
Output shape
object
Returns the API response from the Kumiho service. For revisionCreate: includes kref, number, metadata, and timestamps. For graphCreateEdge: includes source_kref, target_kref, edge_type, and metadata.
Examples
Example 1: Create a revision on an item
set createModeRevision to revisionCreate, itemKrefRevisionCreate to a valid item kref, optionally set revisionNumberCreate to a non-negative integer
Example 2: Create a graph edge between two items
set createModeRevision to graphCreateEdge, sourceKref and targetKref to valid item krefs, set edgeType to desired relationship type