---
title: "domain-dialin-config/:id"
method: PUT
path: "/domain-dialin-config/{id}"
tags: ["domain-dialin-config"]
---

# domain-dialin-config/:id

`PUT /domain-dialin-config/{id}`

update an existing pinless_dialin or pin_dialin config

## Path parameters

- `id` string, required

## Request body

- DomainDialinConfigUpdateReq — the configuration object passed to update an existing pinless or pin dialin.
  - `phone_number` string — The phone number to update to the existing dialin config, in E.164 format (e.g. "+18058700061"). If the same number is used by any other config then the API will fail.
  - `name_prefix` string — Update the name_prefix of an existing config.
  - `hmac` string — The [HMAC signature](/guides/products/dial-in-dial-out/dialin-pinless#hmac) used to verify the webhook called to "room_creation_api". (only for pinless_dialin type).
  - `room_creation_api` string — The URL to call when a call is received on configured phoneNumber or sip_uri. (only for pinless_dialin type). flow is described [here](/guides/products/dial-in-dial-out/dialin-pinless#quick-overview)
  - `hold_music_url` string — The URL to the hold music to play when the call is received, (only for pinless_dialin type). The hold music must be a publicly accessible URL in MP3 format. The hold music must be less than 10MB in size and less than 60 seconds in duration. In pinless_dialin, the hold music will be played twice.
  - `timeout_config` object — The timeout configuration for the dialin config.
    - `message` string — If room_creation_api does not respond within the timeout period, this message will be played to the caller.
  - `ivr_greeting` object — configuration when the call is received on phone number (only for pin_dialin).
    - `message` string — The message to play when call first connects.

## Response `200`

200

- DomainDialinConfigInfoRes
  - `id` string — A unique, opaque ID for this object. You can use this ID in API calls, and in paginated list operations.
  - `type` 'pinless_dialin' | 'pin_dialin' — describes the type of configuration. It can be pinless_dialin or pin_dialin.
  - `config` DomainDialinConfigCreateReq — the configuration object passed to the POST API that creates the dialin config.
    - `type` 'pin_dialin' | 'pinless_dialin', required — The type of dial-in configuration to create.
    - `phone_number` string, required — The phone number to configure for pinless_dialin or pin_dialin, in E.164 format (e.g. "+18058700061"). If the same number is used by any other config then the API will fail. Required for pinless_dialin, optional for pin_dialin.
    - `name_prefix` string — friendly name for the configuration.
    - `hmac` string — The [HMAC signature](/guides/products/dial-in-dial-out/dialin-pinless#hmac) used to verify the webhook called to "room_creation_api". (only for pinless_dialin type)
    - `room_creation_api` string — The API to request when a call is received on configured phoneNumber or sip_uri. (only for pinless_dialin type). flow is described [here](/guides/products/dial-in-dial-out/dialin-pinless#quick-overview)
    - `hold_music_url` string — The URL to the hold music to play when the call is received, (only for pinless_dialin type). The hold music must be a publicly accessible URL in MP3 format. The hold music must be less than 10MB in size and less than 60 seconds in duration. In pinless_dialin, the hold music will be played twice.
    - `timeout_config` object — The timeout configuration for the dialin config.
      - `message` string — If room_creation_api does not respond within the timeout period, this message will be played to the caller.
    - `ivr_greeting` object — configuration when the call is received on phone number (only for pin_dialin).
      - `message` string — The message to play when call first connects.

## Other responses

- `400` — 400

---

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