Zum Hauptinhalt springen
PUT
Telefonnummer aktualisieren
Dieser Endpunkt aktualisiert die bearbeitbaren Attribute einer Telefonnummer, die dir gehört. Derzeit ist dies der Spitzname — ein kurzes, menschenlesbares Label (z. B. „Vertrieb“, „Support — US“), das neben der Nummer im Dashboard angezeigt wird. Nur der Eigentümer der Nummer kann sie aktualisieren. Mit dir geteilte Nummern (granted) zeigen den Spitznamen an, können aber von dir nicht geändert werden.

Pfad-Parameter

id
integer
erforderlich
Die eindeutige Kennung der zu aktualisierenden Telefonnummer

Body-Parameter

nickname
string
Ein kurzes Label für die Telefonnummer. Maximal 50 Zeichen. Sende null oder einen leeren String, um es zu löschen.

Antwort

message
string
Erfolgsmeldung
data
object
Die aktualisierte Telefonnummer
Der Spitzname ist dasselbe Label, das du im Dashboard setzen kannst. Er wird von den Auflistungs-Endpunkten (GET /user/phone-numbers/all, GET /user/phone-numbers/sip-trunks) zurückgegeben, sodass andere Ressourcen, die eine Nummer per phone_number_id referenzieren, den Spitznamen dort auflösen können.