MCPBundler Docs
MCPBundler Docs
Back to marketplaceGetting StartedAuthenticationTutorial - Bundle to Connected Agent
API Reference
Agent A2A Tools
Agent Channels
Agent Configuration (Staging)
Create Agent Custom ToolCreate Agent GuardrailRemove Agent System ToolDelete Agent Custom ToolDelete Agent GuardrailDiscard Staged ChangesDiff Stage Against Latest PublishedGet Stage WorkflowList Agent System ToolsList Agent Custom ToolsList Agent GuardrailsUpdate Staged Voice SettingsUpdate Staged Agent SettingsPatch Stage WorkflowRegenerate Widget Embed KeyUpdate Agent Custom ToolEnable or Configure Agent System Tool
Agent Configuration (Versions)
Agent Tools
agents
Agents
Attachments
Auth
Billing
bundler
Bundler
Bundler Tool
Bundles
Call Campaigns
Catalog
Conversations
Credentials
Deployments
Discover
Fleet
Genesys
Insights
internal
Knowledge Base Website Sources
Knowledge Bases
MCP Listings
Media
OAuth Clients
OAuth2
Observability
Organisation roles
Organisations
Providers
Reviews
Roadmap
SCIM
Simulation Tests
Suppression
Triggers
TTS
Users
Utils
Visitors
Voices
Webhooks
Workflows
API ReferenceAgent Configuration (Staging)

Update Agent Custom Tool

PATCH
/v1/agents/{agent_id}/stage/custom-tools/{tool_id}

Reflects unpublished staged state - see GET /agents/{agent_id}/versions/latest for what's actually live.

Authorization

OAuth2AuthorizationCodeBearer
AuthorizationBearer <token>

In: header

Path Parameters

agent_id*Agent Id
Formatuuid
tool_id*Tool Id
Formatuuid

Query Parameters

verify_locally?Verify Locally
Defaulttrue

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

PATCH body for an existing custom tool - every field optional, and only the ones actually present in the request are applied (see AgentCustomToolProvider.update). webhook_secret follows create's write-only convention: accepted here, never echoed back by any route.

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/stage/custom-tools/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "description": "string",  "json_schema": {},  "webhook_url": "string",  "timeout_ms": 0,  "method": "GET",  "headers": [    {      "name": "string",      "value": "string"    }  ],  "query_params": [    {      "name": "string",      "source": "string"    }  ],  "path_params": [    {      "name": "string",      "source": "string"    }  ],  "body_source": "arguments",  "credential_id": "13c40afa-2996-4a0c-b2e9-68fba9462242",  "auth_placement": "bearer",  "auth_param_name": "string",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z"}
{  "detail": "string",  "code": "string"}
{  "detail": "string",  "code": "string"}
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string"    }  ]}

Regenerate Widget Embed Key

Previous Page

Enable or Configure Agent System Tool

Next Page

name?|null
description?|null
json_schema?|null
webhook_url?string|null
webhook_secret?|null
timeout_ms?|null
method?|null
headers?array<>|null
query_params?array<>|null
path_params?array<>|null
body_source?|null
credential_id?|null
auth_placement?|null
auth_param_name?|null