Not yet available
This command is planned for a future release.
culvii run
Invoke a deployed workflow or agent with sample input.
Synopsis
culvii run <agent-or-workbook-slug> [--input <json>]
Description
Invokes a deployed workflow or agent with sample input. Used for testing after a deploy. This is an execution trigger — it starts a running workflow. It is entirely separate from culvii deploy, which promotes a definition.
Accepts either an OAuth session or an API key with runner scope minimum.
Arguments
| Argument | Description |
|---|---|
<agent-or-workbook-slug> | Slug of the deployed agent or workbook to invoke. |
Flags
| Flag | Type | Description |
|---|---|---|
--input | string | JSON-encoded input payload. |
--env | string | Environment to target. Defaults to active context. |
--workspace | string | Workspace slug. Defaults to active context. |
Examples
culvii run payment-classifier --input '{"amount": 150, "currency": "USD"}'
Error behaviour
| Condition | Message | Exit |
|---|---|---|
| Agent/workbook not found | "Resource 'payment-classifier' not found in workspace." | 1 |
| Insufficient key scope | "Run requires runner scope or higher." | 1 |
Related commands
culvii deploy, culvii logs