POpoll-the-people
Agent Actions

Update a custom action configuration.

Changed on
put/api/v1/projects/{projectId}/actions/custom/{actionKey}

Request

Path parameters

projectIdinteger required
Example:1

The unique agent identifier.

actionKeystring required
Example:document_analyst

Action key (built-in tool key such as "document_analyst", or custom action tool_key such as "custom_mcp_connector_abc123").

Request body

namestring nullable

Custom action name.

descriptionstring nullable

Custom action description.

action_type'mcp_connector' nullable

Custom action type.

is_enabledboolean nullable

Whether the custom action is enabled.

Example request

{
  "name": "My MCP Action",
  "description": "CRM lookup",
  "is_enabled": true,
  "settings": {
    "mcp_url": "https://customgpt.ai",
    "require_tool_confirmation": true
  }
}

Response

Custom action updated.

status'error' | 'success'

The status of the response

Example response

{
  "status": "success",
  "data": {
    "action": {
      "project_id": 1,
      "tool_key": "custom_mcp_connector_8f3a1b2c",
      "name": "My MCP Action",
      "description": "CRM lookup",
      "action_type": "mcp_connector"
    }
  }
}

Changes