Replace a RoutingConfig

PUT

https://api.sudonum.com.com/v2/routing-configs/{uuid}

Updates the routing config, with name required.

A writable field you leave out keeps its stored value; it is not reset to its default. PUT and PATCH therefore behave the same way, except that PUT rejects a body with no name. Use PUT when you send the whole config, and PATCH when you send part of it.

routes is replaced whole, not merged.

Request

Path Params

Body Params application/jsonRequired

Example

{
    "name": "Replaced",
    "timezone": "UTC",
    "country": "",
    "routes": [],
    "default_destination": null
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.sudonum.com.com/v2/routing-configs/' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Replaced",
    "timezone": "UTC",
    "country": "",
    "routes": [],
    "default_destination": null
}'

Responses

🟢200OK

application/json

The routing config was replaced.

Bodyapplication/json

Example

{
    "uuid": "3f1c8a20-0000-4c00-8a00-2d3e4f5a6b7c",
    "name": "Cape Town office hours",
    "timezone": "Africa/Johannesburg",
    "country": "ZA",
    "routes": [
        {
            "priority": 1,
            "conditions": {
                "time_of_day": {
                    "days": [
                        "mon",
                        "tue",
                        "wed",
                        "thu",
                        "fri"
                    ],
                    "start": "08:00",
                    "end": "17:00"
                },
                "public_holiday": true
            },
            "destination": {
                "type": "phone",
                "number": "27821234567"
            },
            "fallback": {
                "on": [
                    "busy",
                    "no_answer"
                ],
                "timeout_seconds": 30,
                "destination": {
                    "type": "phone",
                    "number": "27821234567"
                }
            }
        }
    ],
    "default_destination": {
        "type": "phone",
        "number": "27821234567"
    },
    "created": "2026-08-20T09:14:52.418000Z",
    "modified": "2026-08-20T09:14:52.418000Z"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠429Too Many Requests

Modified at 2026-08-31 10:06:33

Retrieve a RoutingConfig

Update a RoutingConfig