# 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

```yaml
# 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
```

## 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)
  -o, --organization string   Organization name that owns the project
  -p, --project string        Project name that owns the prompts
      --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](https://docs.interactive.ai/cli/iai_routines) - Manage routines