iai routines update

Update a routine (creates a new version)

Synopsis

Update a routine by creating a new version with updated content.

This creates a new version of the routine using the content from the provided file. The previous versions are preserved and can still be accessed by version number.

Run iai routines schema to see the current field definitions.

Example

# routine.yaml
title: My Routine
conditions: When user needs help
description: Handles user support requests
steps:
  - id: greet
    description: Welcome the user
    chat_state: Say hello
  - id: lookup
    source: greet
    tools: crm:get_user
    tool_instruction: Fetch user data

Examples

  iai routines update onboarding-flow --file routine.yaml
  iai routines update onboarding-flow --file routine.yaml -m "add identity check before refund step"
  iai routines update onboarding-flow --file routine.yaml --schema-version 2.1.0
  iai routines update onboarding-flow --file routine.yaml --labels staging,qa

Options

      --file string             Path to the file containing the updated prompt content
  -h, --help                    help for update
      --labels strings          Labels for the new prompt version (comma-separated)
  -m, --message string          Commit message describing the change (stored on the new version)
  -o, --organization string     Organization name that owns the project
  -p, --project string          Project name that owns the prompts
      --schema-version string   Schema version to validate against (defaults to latest stable)
      --tags strings            Tags for the prompt (comma-separated)

Options inherited from parent commands

      --api-key string               API key for authentication
      --cfg-file string              Path to YAML config file with organization, project, and optional service definitions
      --deployment-hostname string   Hostname for the deployment API (default "https://deployment.interactive.ai")
      --hostname string              Hostname for the API (default "https://app.interactive.ai")

SEE ALSO

• iai routines - Multi-step behavioral processes for agents