---
title: "Update action url"
method: POST
path: "/ivrs/{id}/action_urls/{url_id}"
tags: ["Virtual Receptionist"]
---

# Update action url

`POST /ivrs/{id}/action_urls/{url_id}`

## Request

- Base URL: `https://HOSTNAME:8887/api`
- URL: `https://HOSTNAME:8887/api/ivrs/{id}/action_urls/{url_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/docs/ivrs/:id/action_urls/:url_id/post.ts> (a function with typed inputs; its response is checked against the schema)

Set action url of virtual receptionist.

## Path parameters

- `id` string, required: The unique ID of the resource.
- `url_id` string, required: The unique ID of the resource.

## Request body

- object
  - `name` string: The name of action url.
  - `enabled` boolean: Enabled this event or not.
  - `type` 'DTMF' | 'CALLER': The action url type. Can be either: - `DTMF`: - `CALLER`
  - `caller_mask` string: The caller mask of action url.
  - `dtmf_mask` string: The DTMF mask of action url. A semicolon-separated list of DTMF number or DTMF number range. For example: 1000;2000;3000-4000.
  - `method` 'GET' | 'POST': The action url request method. Can be either: - `GET` - `POST`:
  - `headers` string: The request headers of action url.
  - `connection_timeout` integer: The connection timeout in seconds.
  - `request_timeout` integer: The request timeout in seconds.
  - `auth` 'DISABLE' | 'BASIC' | 'DIGEST' | 'BEARER': The authentication method of event URL: Can be either: - `DISABLE`: Disable authentication. - `BASIC`: Use basic authentication. - `DIGEST`: Use digest authentication. - `BEARER`: Use bearer authentication.
  - `username` string: The username for authentication, when auth is `BASIC` or `DIGEST`.
  - `password` string: The password for authentication, when auth is `BASIC` or `DIGEST`.
  - `token` string: The token for authentication, when auth is `BEARER`.
  - `url` string: The event url.

## Response `200`

OK

## Other responses

- `4XX`: Error

---

[API](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api.md) - [All operations](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/revisions/577415d4a3d5?raw)