Update an External MCP link (active / requiresApproval / instanceMode)

PATCH

public

api

agents

{agentPublicId}

external-mcps

{externalMcpPublicId}

Update an External MCP link (active / requiresApproval / instanceMode)

curl --request PATCH \
  --url https://api.gennia.ai/public/api/v1/agents/{agentPublicId}/external-mcps/{externalMcpPublicId} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "active": true,
  "instanceMode": "STATIC",
  "requiresApproval": false
}
'

{
  "active": true,
  "externalMcpPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresApproval": true,
  "serverName": "<string>",
  "serverUrl": "<string>"
}

Autorizações

X-Api-Key

string

header

obrigatório

Parâmetros de caminho

agentPublicId

string<uuid>

obrigatório

externalMcpPublicId

string<uuid>

obrigatório

Corpo

application/json

Body for updating the link between an agent and an external MCP. Fields are tri-state: omit to leave unchanged, set to a value to update, or send null to clear.

active

object

Whether the MCP is currently active for this agent.

Show child attributes

Exemplo:

true

instanceMode

object

Instance mode controlling whether the MCP is shared across calls (STATIC) or instantiated per call (DYNAMIC).

Show child attributes

Exemplo:

"STATIC"

requiresApproval

object

Whether invocations of this MCP require human approval before execution.

Show child attributes

Exemplo:

false

Resposta

External MCP server linked to an agent.

active

boolean

externalMcpPublicId

string<uuid>

instanceMode

enum<string>

Opções disponíveis:

STATIC,

DYNAMIC

requiresApproval

boolean

serverName

string

serverUrl

string

List External MCP servers

Update an External MCP link (active / requiresApproval / instanceMode)

curl --request PATCH \
  --url https://api.gennia.ai/public/api/v1/agents/{agentPublicId}/external-mcps/{externalMcpPublicId} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "active": true,
  "instanceMode": "STATIC",
  "requiresApproval": false
}
'

{
  "active": true,
  "externalMcpPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresApproval": true,
  "serverName": "<string>",
  "serverUrl": "<string>"
}