ghl_agent_studio_get_by_id
Retrieve a specific agent by ID and location to get complete metadata and all non-deleted versions (draft, staging, production) for an active sub-account agent.
Instructions
Get Agent Gets a specific agent by its ID for the specified location with all its versions. Returns complete agent metadata and all non-deleted versions (draft, staging, production). locationId is required parameter. The agent must have active status. Endpoint: GET /agent-studio/agent/{agentId} (Version header: v3; source: v3/agent-studio-v3.json) Requires a Sub-Account (location) token. OAuth scopes: agent-studio.readonly
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>",
"locationId": "<locationId>"
},
"name": "ghl_agent_studio_get_by_id"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | No | Origin channel attributed to this read for auditing (e.g. public_api, internal) | |
| agentId | Yes | Agent ID to retrieve (returns metadata and all non-deleted versions) | |
| locationId | Yes | Location (sub-account) ID that owns the agent |