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

# MCP Servers

API operations for mcp servers. Browse the routes below for parameters, request examples, and responses.

API version: Selected per operation

## List MCP servers

Returns every MCP server in the environment. An MCP server is a registered Model Context Protocol server whose tools an agent can call; header values read back as [redacted]. The call takes no paging parameters, so one request yields the whole set.

### Endpoint

```http
GET /v2/stable/mcp-server
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Responses

#### 200

Returns every MCP server connected to the project's environment, each with its URL, description, icon, and the MCP specification version it was registered against.

Schema:

```json
{
  "$ref": "#/components/schemas/StableMCPServerListResponseV2"
}
```

Example:

```json
{
  "mcpServers": [
    {
      "id": "<string>",
      "url": "<DefaultValueString>",
      "name": "<string>",
      "image": "<string>",
      "headers": [
        {
          "key": "<string>",
          "value": "[redacted]"
        }
      ],
      "createdAt": "2026-09-10T00:00:00.000Z",
      "updatedAt": "2026-09-10T00:00:00.000Z",
      "description": "<string>",
      "specification": "2025-03-26"
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request GET \
  --url 'https://realtime-api.voiceflow.com/v2/stable/mcp-server?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v2/stable/mcp-server?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.get(
    'https://realtime-api.voiceflow.com/v2/stable/mcp-server?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf mcp-server list --project-id <projectID> --environment-alias <environmentAlias>
```


## Create MCP server

Adds an MCP server to the environment, a registered Model Context Protocol server whose tools an agent can call. The URL and header values are plain strings that can reference a project secret as {secret_name}, and the response carries the ID that later calls address it by.

### Endpoint

```http
POST /v2/stable/mcp-server
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Request body

Required

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StableMCPServerCreateRequestV2"
      }
    }
  }
}
```

### Responses

#### 201

Creates the connection to the MCP server and returns it with its generated ID, URL, and specification version. The tools the server exposes are read through the MCP tool endpoints.

Schema:

```json
{
  "$ref": "#/components/schemas/StableMCPServerResponseV2"
}
```

Example:

```json
{
  "mcpServer": {
    "id": "<string>",
    "url": "<string>",
    "name": "<string>",
    "image": "<string>",
    "headers": [
      {
        "key": "<string>",
        "value": "[redacted]"
      }
    ],
    "createdAt": "2026-09-10T00:00:00.000Z",
    "updatedAt": "2026-09-10T00:00:00.000Z",
    "description": "<string>",
    "specification": "2025-03-26"
  },
  "unresolvedReferences": [
    {
      "path": "<string>",
      "token": "<string>",
      "reason": "unknown"
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v2/stable/mcp-server?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "description": null,
  "url": "<string>",
  "headers": [],
  "specification": "2025-06-18"
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v2/stable/mcp-server?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "<string>",
    "description": null,
    "url": "<string>",
    "headers": [],
    "specification": "2025-06-18"
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v2/stable/mcp-server?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "name": "<string>",
      "description": None,
      "url": "<string>",
      "headers": [],
      "specification": "2025-06-18"
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf mcp-server create --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "name": "<string>",
  "description": null,
  "url": "<string>",
  "headers": [],
  "specification": "2025-06-18"
}
JSON
```


## Delete MCP server

Deletes a single MCP server by ID. A MCP server is a registered Model Context Protocol server whose tools an agent can call. The response carries only a confirmation message, so refetch the MCP servers to see what is left.

### Endpoint

```http
DELETE /v1/stable/mcp-server/{serverID}
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `serverID`

Required · string

The ID of the MCP server to operate on.

```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Responses

#### 200

Confirms the MCP server connection was removed from the project. The body is a message only, so refetch the project's MCP servers and tools to see what is left.

Schema:

```json
{
  "$ref": "#/components/schemas/StableDeleteResponse"
}
```

Example:

```json
{
  "message": "<string>"
}
```

### Request examples

#### cURL

```bash
curl --request DELETE \
  --url 'https://realtime-api.voiceflow.com/v1/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'DELETE',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.delete(
    'https://realtime-api.voiceflow.com/v1/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf mcp-server delete --server-id <serverID> --project-id <projectID> --environment-alias <environmentAlias>
```


## Get MCP server

Returns a single MCP server by ID, with the fields that define it. An MCP server is a registered Model Context Protocol server whose tools an agent can call; its header values read back as [redacted].

### Endpoint

```http
GET /v2/stable/mcp-server/{serverID}
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `serverID`

Required · string

The ID of the MCP server to operate on.

```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Responses

#### 200

Returns one MCP server's stored configuration: its name, URL, description, icon, and specification version.

Schema:

```json
{
  "$ref": "#/components/schemas/StableMCPServerReadResponse"
}
```

Example:

```json
{
  "mcpServer": {
    "id": "<string>",
    "url": "<string>",
    "name": "<string>",
    "image": "<string>",
    "headers": [
      {
        "key": "<string>",
        "value": "[redacted]"
      }
    ],
    "createdAt": "2026-09-10T00:00:00.000Z",
    "updatedAt": "2026-09-10T00:00:00.000Z",
    "description": "<string>",
    "specification": "2025-03-26"
  }
}
```

### Request examples

#### cURL

```bash
curl --request GET \
  --url 'https://realtime-api.voiceflow.com/v2/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v2/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.get(
    'https://realtime-api.voiceflow.com/v2/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf mcp-server get --server-id <serverID> --project-id <projectID> --environment-alias <environmentAlias>
```


## Update MCP server

Changes an existing MCP server in place, taking URL and header values as plain strings that can reference a project secret as {secret_name}. The response lists any references that did not resolve; read the server again to see its new values.

### Endpoint

```http
PATCH /v2/stable/mcp-server/{serverID}
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `serverID`

Required · string

The ID of the MCP server to operate on.

```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Request body

Required

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "allOf": [
          {
            "$ref": "#/components/schemas/StableMCPServerUpdateRequestV2"
          }
        ]
      }
    }
  }
}
```

### Responses

#### 200

Confirms the server's connection details were updated. The body is a message only, so refetch the server to read its current URL, description, and specification version.

Schema:

```json
{
  "$ref": "#/components/schemas/StableTextUpdateResponse"
}
```

Example:

```json
{
  "message": "<string>",
  "unresolvedReferences": [
    {
      "path": "<string>",
      "token": "<string>",
      "reason": "unknown"
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request PATCH \
  --url 'https://realtime-api.voiceflow.com/v2/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "description": "<string>",
  "specification": "2025-03-26",
  "url": "<string>",
  "headers": [
    {
      "key": "<string>",
      "value": "<DefaultValueString>"
    }
  ]
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v2/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "<string>",
    "description": "<string>",
    "specification": "2025-03-26",
    "url": "<string>",
    "headers": [
      {
        "key": "<string>",
        "value": "<DefaultValueString>"
      }
    ]
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.patch(
    'https://realtime-api.voiceflow.com/v2/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "name": "<string>",
      "description": "<string>",
      "specification": "2025-03-26",
      "url": "<string>",
      "headers": [
        {
          "key": "<string>",
          "value": "<DefaultValueString>"
        }
      ]
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf mcp-server update --server-id <serverID> --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "name": "<string>",
  "description": "<string>",
  "specification": "2025-03-26",
  "url": "<string>",
  "headers": [
    {
      "key": "<string>",
      "value": "<DefaultValueString>"
    }
  ]
}
JSON
```


## Sync MCP server

Refreshes the stored list of tools an MCP server advertises, which is how MCP tools come to exist rather than being created by hand.

### Endpoint

```http
PUT /v1/stable/mcp-server/{serverID}/sync
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `serverID`

Required · string

The ID of the MCP server to operate on.

```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Responses

#### 200

Confirms the sync ran against the server. The body is a message and does not itemise what changed, so list the project's MCP tools to see the server's current set.

Schema:

```json
{
  "$ref": "#/components/schemas/StableUpdateResponse"
}
```

Example:

```json
{
  "message": "<string>"
}
```

### Request examples

#### cURL

```bash
curl --request PUT \
  --url 'https://realtime-api.voiceflow.com/v1/stable/mcp-server/<serverID>/sync?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/mcp-server/<serverID>/sync?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'PUT',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.put(
    'https://realtime-api.voiceflow.com/v1/stable/mcp-server/<serverID>/sync?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf mcp-server sync --server-id <serverID> --project-id <projectID> --environment-alias <environmentAlias>
```


## Schema definitions

### DefaultValueString

```json
{
  "type": "string",
  "description": "Plain text resolved at runtime and never shown to a model. {variable_name} inserts a variable or entity, {secret_name} a project secret, {variable_name.path} a field of a variable. Escape a literal { or \\ with a backslash. When a name is both a variable and a secret, the secret wins. A name matching none is stored as literal text and reported in unresolvedReferences. Where the field is sent to an upstream system, an unresolved placeholder may be sent as literal text; on an MCP server it is re-resolved by name at connect time, so a literal that matches a real secret binds."
}
```

### McpServerSpecification

```json
{
  "type": "string",
  "enum": [
    "2025-03-26",
    "2025-06-18"
  ],
  "x-enumNames": [
    "V_2025_03_26",
    "V_2025_06_18"
  ]
}
```

### StableDeleteResponse

```json
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "A human-readable message confirming the deletion."
    }
  },
  "required": [
    "message"
  ]
}
```

### StableMCPServerCreateRequestV2

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "description": {
      "default": null,
      "nullable": true,
      "description": "A human-readable description of what the MCP server provides.",
      "type": "string"
    },
    "url": {
      "$ref": "#/components/schemas/DefaultValueString"
    },
    "headers": {
      "default": [],
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "The name of the HTTP header sent to the MCP server."
          },
          "value": {
            "$ref": "#/components/schemas/DefaultValueString"
          }
        },
        "required": [
          "key",
          "value"
        ],
        "additionalProperties": false
      }
    },
    "specification": {
      "default": "2025-06-18",
      "allOf": [
        {
          "$ref": "#/components/schemas/McpServerSpecification"
        }
      ]
    }
  },
  "required": [
    "name",
    "url"
  ],
  "additionalProperties": false
}
```

### StableMCPServerListResponseV2

```json
{
  "type": "object",
  "properties": {
    "mcpServers": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableMCPServerV2"
      }
    }
  },
  "required": [
    "mcpServers"
  ]
}
```

### StableMCPServerReadResponse

```json
{
  "type": "object",
  "properties": {
    "mcpServer": {
      "$ref": "#/components/schemas/StableMCPServerV2"
    }
  },
  "required": [
    "mcpServer"
  ]
}
```

### StableMCPServerResponseV2

```json
{
  "type": "object",
  "properties": {
    "mcpServer": {
      "$ref": "#/components/schemas/StableMCPServerV2"
    },
    "unresolvedReferences": {
      "description": "References this write kept as literal text instead of binding, each with the reason. The write still succeeded.",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableUnresolvedReference"
      }
    }
  },
  "required": [
    "mcpServer"
  ]
}
```

### StableMCPServerUpdateRequestV2

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "description": {
      "nullable": true,
      "description": "A human-readable description of what the MCP server provides.",
      "type": "string"
    },
    "specification": {
      "allOf": [
        {
          "$ref": "#/components/schemas/McpServerSpecification"
        }
      ]
    },
    "url": {
      "allOf": [
        {
          "$ref": "#/components/schemas/DefaultValueString"
        }
      ]
    },
    "headers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "The name of the HTTP header sent to the MCP server."
          },
          "value": {
            "$ref": "#/components/schemas/DefaultValueString"
          }
        },
        "required": [
          "key",
          "value"
        ],
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

### StableMCPServerV2

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "url": {
      "nullable": true,
      "allOf": [
        {
          "$ref": "#/components/schemas/DefaultValueString"
        }
      ]
    },
    "name": {
      "type": "string"
    },
    "image": {
      "nullable": true,
      "description": "The URL of the MCP server icon image.",
      "type": "string"
    },
    "headers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "nullable": true,
            "type": "string"
          },
          "value": {
            "type": "string",
            "enum": [
              "[redacted]"
            ],
            "x-enumNames": [
              "REDACTED"
            ]
          }
        },
        "required": [
          "key",
          "value"
        ]
      }
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "description": {
      "nullable": true,
      "description": "A human-readable description of what the MCP server provides.",
      "type": "string"
    },
    "specification": {
      "$ref": "#/components/schemas/McpServerSpecification"
    }
  },
  "required": [
    "id",
    "url",
    "name",
    "image",
    "headers",
    "createdAt",
    "updatedAt",
    "description",
    "specification"
  ]
}
```

### StableTextUpdateResponse

```json
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "A human-readable message confirming the update."
    },
    "unresolvedReferences": {
      "description": "References this write kept as literal text instead of binding, each with the reason. The write still succeeded.",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableUnresolvedReference"
      }
    }
  },
  "required": [
    "message"
  ]
}
```

### StableUnresolvedReference

```json
{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Dotted path of the field that carried it, e.g. `knowledgeBaseTool.filters[0].defaultValue`."
    },
    "token": {
      "type": "string",
      "description": "The reference as written, without braces."
    },
    "reason": {
      "type": "string",
      "enum": [
        "unknown",
        "secret-not-allowed",
        "path-on-non-variable",
        "resource-id",
        "invalid-name",
        "dangling"
      ],
      "description": "`unknown`: no variable or entity of that name. `secret-not-allowed`: the name is a project secret and this field does not accept one. `path-on-non-variable`: only a variable has fields. `resource-id`: a bare resource id, not a name. `invalid-name`: outside the `^\\w{1,64}$` name grammar. `dangling`: the reference rendered as a bare id, because its row is gone or its name is outside the name grammar.",
      "x-enumNames": [
        "UNKNOWN",
        "SECRET_NOT_ALLOWED",
        "PATH_ON_NON_VARIABLE",
        "RESOURCE_ID",
        "INVALID_NAME",
        "DANGLING"
      ]
    }
  },
  "required": [
    "path",
    "token",
    "reason"
  ]
}
```

### StableUpdateResponse

```json
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "A human-readable message confirming the update."
    }
  },
  "required": [
    "message"
  ]
}
```
