Update an agent plugin
Updates a tenant agent plugin and records the normalized plugin definition snapshot.
curl --request PATCH \
--url https://api.revoengine.com/api/v1/agent/plugins/{agentPluginId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>"
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>'})
};
fetch('https://api.revoengine.com/api/v1/agent/plugins/{agentPluginId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/agent/plugins/{agentPluginId}"
payload = { "name": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)Authorizations
Bearer JWT token or API Key (sk-*).
Path Parameters
Body
Replacement plugin execution provider kind.
tools, mcp_server, skill, package Updated plugin name.
1Updated plugin description.
Canonical English capability metadata used for tool selection. Operator-facing content may remain localized.
Show child attributes
Show child attributes
Updated plugin category.
Replacement resource metadata. Values may use any JSON type. Maximum 16 KiB and 64 top-level keys. Top-level keys starting with "__" are reserved for backend use.
{ "costCenter": "platform" }
Updated upstream plugin identifier.
Optimistic version expected by the client.
x >= 0Replacement execution mode.
sync, background Replacement component id. Required when kind is explicitly set to tools, and forbidden for MCP server patches.
1Portable SHA-256 component revision digest. Omit to retain the current binding; use null to follow latest.
Replacement component version for tools patches. Omit to preserve the existing binding; set an exact integer only for an explicit compatibility-approved pin or migration. Forbidden for MCP server patches.
x >= 0Replacement component-backed toolset. Forbidden for MCP server and skill patches.
Show child attributes
Show child attributes
Replacement remote MCP server configuration. Required when kind is explicitly set to mcp_server, and forbidden for tools patches.
Show child attributes
Show child attributes
Replacement per-tool MCP governance and loading configuration for MCP server patches. Forbidden for tools patches.
Show child attributes
Show child attributes
Replacement Markdown skill configuration. Required when kind is explicitly set to skill.
Show child attributes
Show child attributes
Replacement Markdown package manifest. Required when kind is explicitly set to package.
Show child attributes
Show child attributes
Replacement provider source recorded for discovery, auditability, and telemetry.
tenant_plugin, community_plugin Replacement strict structured input schema for tools plugins. Forbidden for MCP server patches. Must be an object schema with additionalProperties=false and descriptions on every declared property.
Replacement structured output schema for tools plugins. Forbidden for MCP server patches.
Replacement approval contract.
Show child attributes
Show child attributes
Declared mutation intent used for governance and approval safety.
read, write, destructive, external Replacement reversibility declaration.
reversible, operator_reversible, irreversible, unknown Replacement target scope.
assistant_thread, agent, tenant, external Replacement side-effect declaration.
Normalized side-effect categories used for governance and operator review.
Replacement execution timeout in milliseconds.
x >= 100030000
Replacement maximum serialized result size in bytes.
x >= 512Whether the plugin should be surfaced as summary-only discovery context for agents and assistant threads before explicit attachment.
Updated active flag used to gate runtime attachment.
Response
curl --request PATCH \
--url https://api.revoengine.com/api/v1/agent/plugins/{agentPluginId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>"
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>'})
};
fetch('https://api.revoengine.com/api/v1/agent/plugins/{agentPluginId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/agent/plugins/{agentPluginId}"
payload = { "name": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)