Update Configuration

Rename a configuration or rotate its credentials

1 min read

put/api/v1/organizations/telephony-configs/{config_id}

Request example

curl --request PUT \
  --url https://voice.menaceui.com/api/v1/organizations/telephony-configs/{config_id} \
  --header 'authorization: <string>' \
  --header 'X-API-Key: <string>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "config": {
    "provider": "ari",
    "ari_endpoint": "<string>",
    "app_name": "<string>",
    "app_password": "<string>",
    "ws_client_name": "",
    "external_pbx": {
      "type": "vicidial",
      "agent_api": {
        "url": "<string>",
        "username": "<string>",
        "password": "<string>",
        "source": "dograh"
      },
      "non_agent_api": {
        "url": "<string>",
        "username": "<string>",
        "password": "<string>",
        "source": "dograh"
      },
      "timeout_seconds": 8
    }
  }
}'

Response

{
  "id": 1,
  "name": "<string>",
  "provider": "<string>",
  "connectivity": "api",
  "is_default_outbound": true,
  "inactive": false,
  "inactive_since": "2026-08-10T12:00:00Z",
  "inactive_reason": "<string>",
  "credentials": {},
  "sip_connectivity": {
    "provider_display_name": "<string>",
    "regions": [
      {
        "region": "<string>",
        "inbound_transports": [
          {
            "transport": "<string>",
            "hostname": "<string>",
            "port": 1,
            "uri": "<string>"
          }
        ],
        "outbound_origin_ip": "<string>"
      }
    ]
  },
  "setup_checklist": {
    "ready_for_outbound": true,
    "outbound_blocked_reason": "<string>",
    "steps": [
      {
        "key": "<string>",
        "title": "<string>",
        "description": "<string>",
        "complete": true,
        "blocks_outbound": false
      }
    ],
    "docs_url": "<string>"
  },
  "supports_trunks": false,
  "trunks": [
    {
      "id": 1,
      "name": "<string>",
      "enabled": true,
      "settings": {},
      "phone_number_count": 0,
      "created_at": "2026-08-10T12:00:00Z",
      "updated_at": "2026-08-10T12:00:00Z"
    }
  ],
  "created_at": "2026-08-10T12:00:00Z",
  "updated_at": "2026-08-10T12:00:00Z"
}

put/api/v1/organizations/telephony-configs/{config_id}

The provider cannot be changed once a configuration exists — create a new configuration if you need to switch providers.

When rotating credentials, you only need to send the fields you're changing. Re-submitting a masked sensitive value preserves the original secret, so it's safe to round-trip a GET response back to a PUT.

Path parameters

config_idintegerrequired#

Headers

authorizationstring · null#

X-API-Keystring · null#

Body

application/json

namestring · null#

Show child attributes

Any of

configobject · null#

Show child attributes

Any of

Responses

application/json

Successful Response

idintegerrequired#

namestringrequired#

providerstringrequired#

connectivityenum<string>#

Default: "api"

Options:apisip

is_default_outboundbooleanrequired#

inactiveboolean#

Default: false

inactive_sincestring · null#

Show child attributes

Any of

inactive_reasonstring · null#

Show child attributes

Any of

credentialsobjectrequired#

sip_connectivityobject · null#

Show child attributes

Any of

provider_display_namestringrequired#

regionsobject[]required#

Show child attributes

regionstringrequired#

inbound_transportsobject[]required#

Show child attributes

transportstringrequired#

hostnamestringrequired#

portintegerrequired#

uristringrequired#

outbound_origin_ipstringrequired#

setup_checklistobject · null#

Show child attributes

Any of

ready_for_outboundbooleanrequired#

outbound_blocked_reasonstring · nullrequired#

Show child attributes

stepsobject[]required#

Show child attributes

keystringrequired#

titlestringrequired#

descriptionstringrequired#

completebooleanrequired#

blocks_outboundboolean#

Default: false

docs_urlstring · null#

Show child attributes

supports_trunksboolean#

Default: false

trunksobject[]#

Show child attributes

idintegerrequired#

namestringrequired#

enabledbooleanrequired#

settingsobjectrequired#

phone_number_countinteger#

Default: 0

created_atstringrequired#

updated_atstringrequired#

created_atstringrequired#

updated_atstringrequired#

Get Configuration Delete Configuration