---
title: "Get Action"
method: GET
path: "/v1/actions"
tags: ["actions"]
---

# Get Action

`GET /v1/actions`

## Query parameters

- `id` string, uuid, required

## Response `200`

Successful Response

- union
  - TransferCallAction
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'action_transfer_call', required
    - `config` TransferCallConfig, required
      - `phone_number` string, required
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - PhraseBasedActionTriggerOutput
        - `type` 'action_trigger_phrase_based', required
        - `config` PhraseBasedActionTriggerConfig, required
          - `phrase_triggers` PhraseTrigger[], required
            - `phrase` string, required
            - `conditions` string[], required
  - EndConversationAction
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'action_end_conversation', required
    - `config` EmptyActionConfig
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - PhraseBasedActionTriggerOutput
        - `type` 'action_trigger_phrase_based', required
        - `config` PhraseBasedActionTriggerConfig, required
          - `phrase_triggers` PhraseTrigger[], required
            - `phrase` string, required
            - `conditions` string[], required
  - DTMFAction
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'action_dtmf', required
    - `config` EmptyActionConfig
    - `action_trigger` FunctionCallActionTrigger
      - `type` 'action_trigger_function_call', required
      - `config` FunctionCallActionTriggerConfig
  - AddToConferenceAction
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'action_add_to_conference', required
    - `config` AddToConferenceConfig, required
      - `phone_number` string, required
      - `place_primary_on_hold` boolean
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - PhraseBasedActionTriggerOutput
        - `type` 'action_trigger_phrase_based', required
        - `config` PhraseBasedActionTriggerConfig, required
          - `phrase_triggers` PhraseTrigger[], required
            - `phrase` string, required
            - `conditions` string[], required
  - SetHoldAction
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'action_set_hold', required
    - `config` EmptyActionConfig
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - PhraseBasedActionTriggerOutput
        - `type` 'action_trigger_phrase_based', required
        - `config` PhraseBasedActionTriggerConfig, required
          - `phrase_triggers` PhraseTrigger[], required
            - `phrase` string, required
            - `conditions` string[], required
  - ExternalAction
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'action_external', required
    - `config` ExternalActionConfig, required
      - `processing_mode` 'muted'
      - `name` string, required
      - `description` string, required
      - `url` string, required
      - `input_schema` object, required
      - `speak_on_send` boolean, required
      - `speak_on_receive` boolean, required
      - `signature_secret` string
    - `action_trigger` FunctionCallActionTrigger
      - `type` 'action_trigger_function_call', required
      - `config` FunctionCallActionTriggerConfig

## Other responses

- `422` — Validation Error

## Changes

- **2024-08-14** `63991d99e2e1` — 4 breaking, 26 info
  - added `#/components/schemas/PhraseBasedActionTrigger-Output` to the `oneOf[subschema #1: TransferCallAction]/action_trigger` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PhraseBasedActionTrigger-Output` to the `oneOf[subschema #2: EndConversationAction]/action_trigger` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PhraseBasedActionTrigger-Output` to the `oneOf[subschema #4: AddToConferenceAction]/action_trigger` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PhraseBasedActionTrigger-Output` to the `oneOf[subschema #5: SetHoldAction]/action_trigger` response property `oneOf` list for the response status `200`
  - …26 more
- **2024-04-15** `47ab17602d64` — 1 breaking, 1 info
  - added `#/components/schemas/ExternalAction` to the response body `oneOf` list for the response status `200`
  - added `action_external` mapping keys to the response discriminator for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/changes/v1/actions/get.md)

---

[API](https://skmtc.dev/vocodedev/apis/vocode-hosted-api.md) · [All operations](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vocodedev/vocode-hosted-api/revisions/ffca17c004e2/schema)