> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agents.labs.bandwidth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Validate an agent

> MCP reference for validate_workflow.

Tool: `validate_workflow`. Requires **Viewer or higher** in the applicable workspace and a connected [OAuth session](https://docs.agents.labs.bandwidth.com/mcp/authentication.md).

Checks the current draft or published definition without saving it. `is_valid` reports graph/schema validation; `readiness_status` is a separate configuration check that can be `not_checked`. Neither proves a model, provider, or phone route works.

Read every error and validate again after corrections. Missing versioned definitions return `version_not_found`. URL safety checks may resolve hostnames, but the tool does not invoke configured endpoints or place calls.

## Arguments

| Name | Type | Required | Defaults and limits |
| - | - | - | - |
| `workflow_id` | integer | Yes | See full schema |

## Example arguments

Replace sample resource IDs with IDs returned in your selected workspace.

```json theme={null}
{
  "workflow_id": 42
}
```

## Result and errors

The schema below describes MCP `structuredContent`, including the `result` wrapper where present. Your client may also display a text representation. Read success flags and structured errors before continuing; transport success alone does not prove the operation succeeded. Authentication, missing membership, and insufficient role can fail before a tool result is produced. See [troubleshooting](https://docs.agents.labs.bandwidth.com/mcp/troubleshooting.md).

**Effect:** Reads data. **Retry:** Declared idempotent. Discovery annotations describe behavior; they do not grant permission or replace confirmation for consequential actions.

> [accordion] Input schema
>
> ```json theme={null}
> {
>   "additionalProperties": false,
>   "properties": {
>     "workflow_id": {
>       "type": "integer"
>     }
>   },
>   "required": [
>     "workflow_id"
>   ],
>   "type": "object"
> }
> ```

> [accordion] Result schema
>
> ```json theme={null}
> {
>   "properties": {
>     "errors": {
>       "items": {
>         "properties": {
>           "field": {
>             "anyOf": [
>               {
>                 "type": "string"
>               },
>               {
>                 "type": "null"
>               }
>             ]
>           },
>           "id": {
>             "anyOf": [
>               {
>                 "type": "string"
>               },
>               {
>                 "type": "integer"
>               },
>               {
>                 "type": "null"
>               }
>             ]
>           },
>           "kind": {
>             "type": "string"
>           },
>           "message": {
>             "type": "string"
>           }
>         },
>         "required": [
>           "kind",
>           "id",
>           "field",
>           "message"
>         ],
>         "type": "object"
>       },
>       "type": "array"
>     },
>     "is_valid": {
>       "type": "boolean"
>     },
>     "lifecycle_status": {
>       "enum": [
>         "draft",
>         "active",
>         "paused",
>         "archived"
>       ],
>       "type": "string"
>     },
>     "readiness_message": {
>       "anyOf": [
>         {
>           "type": "string"
>         },
>         {
>           "type": "null"
>         }
>       ]
>     },
>     "readiness_status": {
>       "enum": [
>         "ready",
>         "not_ready",
>         "not_checked"
>       ],
>       "type": "string"
>     },
>     "version_number": {
>       "type": "integer"
>     },
>     "version_status": {
>       "enum": [
>         "draft",
>         "published"
>       ],
>       "type": "string"
>     },
>     "workflow_id": {
>       "type": "integer"
>     }
>   },
>   "required": [
>     "workflow_id",
>     "is_valid",
>     "errors",
>     "readiness_status",
>     "readiness_message",
>     "lifecycle_status",
>     "version_status",
>     "version_number"
>   ],
>   "type": "object"
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.