---
title: "Update Action"
method: POST
path: "/v1/actions/update"
tags: ["actions"]
---

# Update Action

`POST /v1/actions/update`

## Query parameters

- `id` string, uuid, required

## Request body

- union
  - TransferCallActionUpdateParams
    - `type` 'action_transfer_call', required
    - `config` union
      - TransferCallConfig
        - `phone_number` string, required
      - Undefined
    - `action_trigger` union
      - union
        - FunctionCallActionTrigger
          - `type` 'action_trigger_function_call', required
          - `config` FunctionCallActionTriggerConfig
        - PhraseBasedActionTriggerInput
          - `type` 'action_trigger_phrase_based', required
          - `config` PhraseBasedActionTriggerConfig, required
            - `phrase_triggers` PhraseTrigger[], required
              - …
      - Undefined
  - EndConversationActionUpdateParams
    - `type` 'action_end_conversation', required
    - `config` union
      - EmptyActionConfig
      - Undefined
    - `action_trigger` union
      - union
        - FunctionCallActionTrigger
          - `type` 'action_trigger_function_call', required
          - `config` FunctionCallActionTriggerConfig
        - PhraseBasedActionTriggerInput
          - `type` 'action_trigger_phrase_based', required
          - `config` PhraseBasedActionTriggerConfig, required
            - `phrase_triggers` PhraseTrigger[], required
              - …
      - Undefined
  - DTMFActionUpdateParams
    - `type` 'action_dtmf', required
    - `config` union
      - EmptyActionConfig
      - Undefined
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - Undefined
  - AddToConferenceActionUpdateParams
    - `type` 'action_add_to_conference', required
    - `config` union
      - AddToConferenceConfig
        - `phone_number` string, required
        - `place_primary_on_hold` boolean
      - Undefined
    - `action_trigger` union
      - union
        - FunctionCallActionTrigger
          - `type` 'action_trigger_function_call', required
          - `config` FunctionCallActionTriggerConfig
        - PhraseBasedActionTriggerInput
          - `type` 'action_trigger_phrase_based', required
          - `config` PhraseBasedActionTriggerConfig, required
            - `phrase_triggers` PhraseTrigger[], required
              - …
      - Undefined
  - SetHoldActionUpdateParams
    - `type` 'action_set_hold', required
    - `config` union
      - EmptyActionConfig
      - Undefined
    - `action_trigger` union
      - union
        - FunctionCallActionTrigger
          - `type` 'action_trigger_function_call', required
          - `config` FunctionCallActionTriggerConfig
        - PhraseBasedActionTriggerInput
          - `type` 'action_trigger_phrase_based', required
          - `config` PhraseBasedActionTriggerConfig, required
            - `phrase_triggers` PhraseTrigger[], required
              - …
      - Undefined
  - ExternalActionUpdateParams
    - `type` 'action_external', required
    - `config` union
      - ExternalActionConfig
        - `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
      - Undefined
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - Undefined

## 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

---

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