execute_pica_action

Execute actions on third-party platforms like Gmail, HubSpot, or Asana by specifying the platform, action, and connection key. Requires confirmation of intent and parameters for secure and accurate execution.

Instructions

Execute a Pica action to perform actual operations on third-party platforms. CRITICAL: Only call this when the user's intent is to EXECUTE an action (e.g., 'read my last Gmail email', 'fetch 5 contacts from HubSpot', 'create a task in Asana'). DO NOT call this when the user wants to BUILD or CREATE code/forms/applications - in those cases, stop after get_pica_action_knowledge and provide implementation guidance instead. REQUIRED WORKFLOW: Must call get_pica_action_knowledge first. If uncertain about execution intent or parameters, ask for confirmation before proceeding.

Input Schema

Name	Required	Description
`action`	Yes	Action object with ID, path, and method
`connectionKey`	Yes	Key of the connection to use
`data`	No	Request data (for POST, PUT, etc.)
`headers`	No	Additional headers
`isFormData`	No	Whether to send data as multipart/form-data
`isFormUrlEncoded`	No	Whether to send data as application/x-www-form-urlencoded
`pathVariables`	No	Variables to replace in the path
`platform`	Yes	Platform name
`queryParams`	No	Query parameters

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "action": {
      "additionalProperties": false,
      "description": "Action object with ID, path, and method",
      "properties": {
        "_id": {
          "description": "Action ID",
          "type": "string"
        },
        "method": {
          "description": "HTTP method (GET, POST, PUT, DELETE, etc.)",
          "type": "string"
        },
        "path": {
          "description": "Action path template with variables",
          "type": "string"
        }
      },
      "required": [
        "_id",
        "path",
        "method"
      ],
      "type": "object"
    },
    "connectionKey": {
      "description": "Key of the connection to use",
      "type": "string"
    },
    "data": {
      "description": "Request data (for POST, PUT, etc.)"
    },
    "headers": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "Additional headers",
      "type": "object"
    },
    "isFormData": {
      "description": "Whether to send data as multipart/form-data",
      "type": "boolean"
    },
    "isFormUrlEncoded": {
      "description": "Whether to send data as application/x-www-form-urlencoded",
      "type": "boolean"
    },
    "pathVariables": {
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "Variables to replace in the path",
      "type": "object"
    },
    "platform": {
      "description": "Platform name",
      "type": "string"
    },
    "queryParams": {
      "additionalProperties": {},
      "description": "Query parameters",
      "type": "object"
    }
  },
  "required": [
    "platform",
    "action",
    "connectionKey"
  ],
  "type": "object"
}

pica