culvii rename
Rename an agent or workbook while preserving its UUID and execution history.
Synopsis
culvii rename `<old-slug>` `<new-slug>` --resource-type <agent|workbook> [--workspace `<slug>`] [--env `<env>`]
Description
Renames a resource by updating its slug field. The UUID (immutable ID) is never changed, so all execution history, versions, and references remain intact. The rename is atomic — both the deployed row and any active draft row with the old slug are updated in the same transaction.
Requires an OAuth session.
Arguments
| Argument | Description |
|---|---|
<old-slug> | Current slug of the resource. |
<new-slug> | New slug to assign. |
Flags
| Flag | Required | Description |
|---|---|---|
--resource-type | ✓ | agent or workbook. |
--workspace | — | Workspace slug. Defaults to workspace_id in active context. |
--env | — | Target environment. Defaults to environment in active context. |
Examples
# Rename using workspace from config
culvii rename payment-processor payments-agent --resource-type agent
# Rename in a specific workspace and environment
culvii rename old-flow new-flow --resource-type workbook --workspace payments --env sandbox
Error behaviour
| Condition | Message | Exit |
|---|---|---|
| No workspace configured | "Error: No workspace configured. Run culvii dev first, or provide --workspace <slug>." | 1 |
| Resource not found | "Failed to rename resource. Server responded with 404" | 1 |
| New slug already taken | "Failed to rename resource. Server responded with 409" | 1 |
Related commands
culvii deploy, culvii workspace list