--- 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 ## Changes - **2024-08-14** `63991d99e2e1` — 21 breaking, 37 info - removed `subschema #1` from the `oneOf[subschema #3: DTMFActionUpdateParams]/action_trigger` request property `anyOf` list - removed `subschema #1` from the `oneOf[subschema #6: ExternalActionUpdateParams]/action_trigger` request property `anyOf` list - the `processing_mode` request property const value `muted` was added - the `type` request property const value `action_add_to_conference` was added - …54 more - **2024-04-15** `47ab17602d64` — 1 breaking, 3 info - added `#/components/schemas/ExternalAction` to the response body `oneOf` list for the response status `200` - added `action_external` mapping keys to the request discriminator - added `#/components/schemas/ExternalActionUpdateParams` to the request body `oneOf` list - added `action_external` mapping keys to the response discriminator for the response status `200` - **2024-01-03** `5086814bf16a` — 1 breaking, 9 info - added `#/components/schemas/AddToConferenceAction, #/components/schemas/SetHoldAction` to the response body `oneOf` list for the response status `200` - added the new optional request property `oneOf[subschema #1: TransferCallActionUpdateParams]/action_trigger` - added the new optional request property `oneOf[subschema #2: EndConversationActionUpdateParams]/action_trigger` - added the new optional request property `oneOf[subschema #3: DTMFActionUpdateParams]/action_trigger` - …6 more [Change history](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/changes/v1/actions/update/post.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)