agent_studio_execute_agent_deprecated
Execute a GoHighLevel agent by sending messages, associating contacts, and preserving conversation context with executionId. Deprecated; use the current tool for new integrations.
Instructions
Execute Agent (Deprecated)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agentId": "<agentId>",
"message": "<message>"
},
"name": "agent_studio_execute_agent_deprecated"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | No | ||
| agentId | Yes | ||
| message | Yes | Message to send to the agent | |
| contactId | No | Contact ID to associate with this execution. When provided, contact data will be hydrated and made available to the agent. | |
| versionId | No | Published version ID to execute. If not provided, the latest published production version will be used. | |
| locationId | No | Location ID Defaults to GHL_LOCATION_ID when omitted. | |
| attachments | No | Attachments for the message | |
| executionId | No | Unique session identifier that maintains conversational context across multiple interactions within the same agent session. Omit this field for the first message in a new session. Include the executionId returned from the previous response to maintain context in subsequent messages. | |
| inputVariables | No | Input variables to pass to the agent. These should match the input variables defined in the agent configuration. |