HighLevel: List Actions for an Agent

← Conversation AI operations · Get started

Operation gohighlevel.list_actions

Provider route: GET /conversation-ai/agents/{agentId}/actions/list. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/gohighlevel with npm, or alter-sdk-gohighlevel with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { HighLevelIntegration } from "@alter-ai/gohighlevel";

async function execute(input: Parameters<HighLevelIntegration["conversationAi"]["listActions"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new HighLevelIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.conversationAi.listActions(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_gohighlevel import HighLevelIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = HighLevelIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.conversation_ai.list_actions(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: not allowed
path	object	Required within parent	Additional keys: not allowed
path.agentId	string	Required within parent

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
$	Model	Root	Expand List Actions for an Agent — response body

Referenced models: List Actions for an Agent — response body

Schemas

7 more schemas are linked from the tables above, on the schema pages.

List Actions for an Agent — response body

Field	Type	Presence	Description and constraints
$	object	Root
data	array	Required within parent	Grouped actions by type
data[]	Model	Each item	Expand List Actions for an Agent — response body — data item
success	boolean	Required within parent	Success status of the request

Referenced models: List Actions for an Agent — response body — data item

List Actions for an Agent — response body — data item

Field	Type	Presence	Description and constraints
$	object	Root
agentId	string	Optional	Agent ID where the action belongs
details	JSON	Required within parent	Action-specific details. The structure depends on the action type. For TRIGGER_WORKFLOW use triggerWorkflowDto, for UPDATE_CONTACT_FIELD use updateContactFieldDto, for APPOINTMENT_BOOKING use appointmentBookingDto, for STOP_BOT use stopBotDto, for HUMAN_HAND_OVER use humanHandOverDto, for ADVANCED_FOLLOWUP use advancedFollowupDto, and for TRANSFER_BOT use transferBotDto.
details (anyOf 1)	Model	Alternative	Expand Update Action — request body — body details trigger Condition, trigger Message, workflow Ids
details (anyOf 2)	Model	Alternative	Expand Update Action — request body — body details contact Field Id, contact Update Examples, description
details (anyOf 3)	Model	Alternative	Expand List Actions for an Agent — response body — data / item / details / sleepTimeUnit: days, hours, minutes
details (anyOf 4)	Model	Alternative	Expand List Actions for an Agent — response body — data / item / details / sleepTimeUnit: days, hours, minutes, stop Bot Detection Type: Goodbye, Custom
details (anyOf 5)	Model	Alternative	Expand List Actions for an Agent — response body — data / item / details / handoverType: contact Request, lack Of Information, failed To Resolve Issue, custom, sleep Time Unit: days, hours, minutes
details (anyOf 6)	Model	Alternative	Expand List Actions for an Agent — response body — data / item / details / scenarioId: contact Stopped Replying, contact Is Busy, contact Requested
details (anyOf 7)	Model	Alternative	Expand List Actions for an Agent — response body — data / item / details / transferBotType: Default, Custom
id	string	Required within parent	Unique identifier for the action
name	string	Required within parent	Name of the action
type	string	Required within parent	Type of the action Known values: triggerWorkflow, updateContactField, appointmentBooking, stopBot, humanHandOver, advancedFollowup, transferBot

Referenced models: List Actions for an Agent — response body — data / item / details / scenarioId: contact Stopped Replying, contact Is Busy, contact Requested, List Actions for an Agent — response body — data / item / details / sleepTimeUnit: days, hours, minutes, List Actions for an Agent — response body — data / item / details / handoverType: contact Request, lack Of Information, failed To Resolve Issue, custom, sleep Time Unit: days, hours, minutes, List Actions for an Agent — response body — data / item / details / sleepTimeUnit: days, hours, minutes, stop Bot Detection Type: Goodbye, Custom, List Actions for an Agent — response body — data / item / details / transferBotType: Default, Custom, Update Action — request body — body details trigger Condition, trigger Message, workflow Ids, Update Action — request body — body details contact Field Id, contact Update Examples, description

List Actions for an Agent — response body — data / item / details / scenarioId: contact Stopped Replying, contact Is Busy, contact Requested

Field	Type	Presence	Description and constraints
$	object	Root
enabled	boolean	Required within parent	Whether advanced followup is enabled
followupSequence	array	Required within parent	Sequence of followup actions to perform
followupSequence[]	Model	Each item	Expand List Actions for an Agent — response body — data / item / details / scenarioId: contact Stopped Replying, contact Is Busy, contact Requested followup Sequence item
followupSettings	JSON	Optional	Additional settings for followup behavior
followupSettings (allOf 1)	Model	All variants apply	Expand List Actions for an Agent — response body — data / item / details / scenarioId: contact Stopped Replying, contact Is Busy, contact Requested followup Settings timezone To Use: contact, business
scenarioId	string	Required within parent	ID of the followup scenario Known values: contactStoppedReplying, contactIsBusy, contactRequested

Referenced models: List Actions for an Agent — response body — data / item / details / scenarioId: contact Stopped Replying, contact Is Busy, contact Requested followup Sequence item, List Actions for an Agent — response body — data / item / details / scenarioId: contact Stopped Replying, contact Is Busy, contact Requested followup Settings timezone To Use: contact, business

List Actions for an Agent — response body — data / item / details / sleepTimeUnit: days, hours, minutes

Field	Type	Presence	Description and constraints
$	object	Root
actionId	string	Optional	Optional action ID reference
calendarId	string	Required within parent	Calendar ID for appointment booking
cancelEnabled	boolean	Required within parent	Whether to allow appointment cancellation (cannot be true when onlySendLink is true) Default: false
onlySendLink	boolean	Required within parent	If true, only sends the appointment link without booking
rescheduleEnabled	boolean	Required within parent	Whether to allow appointment rescheduling (cannot be true when onlySendLink is true) Default: false
sleepAfterBooking	boolean	Required within parent	Whether to put the agent to sleep after booking (cannot be true when onlySendLink is true)
sleepTime	JSON	Optional
sleepTime (anyOf 1)	number	Alternative	Sleep duration (required when sleepAfterBooking is true)
sleepTime (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
sleepTimeUnit	string	Optional	Unit for sleep time (required when sleepAfterBooking is true) Known values: days, hours, minutes
transferAgent	string	Optional	Agent ID to transfer to (required when transferBot is true)
transferBot	boolean	Required within parent	Whether to transfer to another agent after booking (cannot be true when onlySendLink is true)
triggerWorkflow	boolean	Required within parent	Whether to trigger a workflow after booking (cannot be true when onlySendLink is true)
workflowIds	array	Optional	Workflow IDs to trigger after booking (required when triggerWorkflow is true)
workflowIds[]	string	Each item

List Actions for an Agent — response body — data / item / details / handoverType: contact Request, lack Of Information, failed To Resolve Issue, custom, sleep Time Unit: days, hours, minutes

Field	Type	Presence	Description and constraints
$	object	Root
assignToUserId	string	Optional	ID of the user to assign the conversation to
createTask	boolean	Optional	Whether to create a task when handing over
enabled	boolean	Required within parent	Whether human handover action is enabled
examples	array	Optional	Example phrases that trigger human handover (required when handoverType is custom or contactRequest)
examples[]	string	Each item
finalMessage	string	Required within parent	Final message sent when handing over to human
handoverType	string	Required within parent	Type of human handover detection Known values: contactRequest, lackOfInformation, failedToResolveIssue, custom
reactivateEnabled	boolean	Required within parent	Whether the agent can be reactivated after handover
skipAssignToUser	boolean	Optional	Whether to skip assigning to a specific user
sleepTime	JSON	Optional
sleepTime (anyOf 1)	number	Alternative	Time duration before reactivation (required when reactivateEnabled is true)
sleepTime (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
sleepTimeUnit	string	Optional	Time unit for reactivation delay (required when reactivateEnabled is true) Known values: days, hours, minutes
tags	array	Optional	Tags to apply during handover
tags[]	string	Each item
triggerCondition	string	Required within parent	Condition that triggers human handover

List Actions for an Agent — response body — data / item / details / transferBotType: Default, Custom

Field	Type	Presence	Description and constraints
$	object	Root
enabled	boolean	Required within parent	Whether this transfer action is enabled
transferBotExamples	array	Optional	Example phrases that trigger transfer (required for Custom type, minimum 2)
transferBotExamples[]	string	Each item
transferBotTriggerCondition	string	Optional	Condition that triggers the transfer (required for Custom type)
transferBotType	string	Required within parent	Type of transfer - Default or Custom Known values: Default, Custom
transferToBot	string	Required within parent	ID of the bot/agent to transfer to

Policy, approvals and errors

SDK function policy ID: gohighlevel.list_actions. Catalog operation: list-actions. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Required provider scopes: ["conversation-ai.readonly"]

Pinned headers: {"Version": "v3"}

Official provider source