v1

latestOpenAPI 3.1.02026-07-2687120159.0 KB

Reserve a DNI (Dynamic Number Insertion) for an incoming call.

Reserves a DNI, associating a temporary set of attributes to a specific virtual agent.

post/v1/conversations/dni-reservation

Request body

attributesobject required

Attributes that will be consumed by the virtual agent. Flexible mapping of key → value.

Example request

{
  "attributes": {
    "shared_id": "1234",
    "customer": {
      "address": "test lane",
      "age": 25
    },
    "previous_calls": [
      "call_id_1",
      "call_id_2"
    ]
  }
}

Response

Successfully reserved a DNI.

dnistring

The reserved DNI identifier.