# agent validate authoring-bundle

Validate an authoring bundle to ensure its Agent Script file compiles successfully and can be used to publish an agent.

## Description for agent validate authoring-bundle

An authoring bundle is a metadata type (named aiAuthoringBundle) that provides the blueprint for an agent. The metadata type contains two files: the standard metatada XML file and an Agent Script file (extension ".agent") that fully describes the agent using the Agent Script language.

This command validates that the Agent Script file in the authoring bundle compiles without errors so that you can later publish the bundle to your org. Use this command while you code the Agent Script file to ensure that it's valid. If the validation fails, the command outputs the list of syntax errors, a brief description of the error, and the location in the Agent Script file where the error occurred.

This command uses the API name of the authoring bundle. If you don't provide an API name with the --api-name flag, the command searches the current DX project and outputs a list of authoring bundles that it found for you to choose from.

## Flags

| Flag Name (Long) | Flag Name (Short) | Description                                                                                                                                           |
| ---------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--api-name`     | `-n`              | **Type:** Value<br><br>API name of the authoring bundle you want to validate; if not specified, the command provides a list that you can choose from. |
| `--api-version`  | N/A               | **Type:** Value<br><br>Override the api version used for api requests made by this command                                                            |
| `--flags-dir`    | N/A               | **Type:** Value<br><br>Import flag values from a directory.                                                                                           |
| `--json`         | N/A               | **Type:** Boolean<br><br>Format output as json.                                                                                                       |
| `--target-org`   | `-o`              | **Type:** Value<br>**Required**<br><br>Username or alias of the target org. Not required if the `target-org` configuration variable is already set.   |

## Examples for agent validate authoring-bundle

Validate an authoring bundle by being prompted for its API name; use your default org:

```shell
sf agent validate authoring-bundle
```

Validate an authoring bundle with API name MyAuthoringBundle; use the org with alias "my-dev-org":

```shell
sf agent validate authoring-bundle --api-name MyAuthoringBundle --target-org my-dev-org
```