Zum Hauptinhalt springen
PUT
/
api
/
user
/
phone-numbers
/
{id}
Telefonnummer aktualisieren
curl --request PUT \
  --url https://app.famulor.de/api/user/phone-numbers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "nickname": "<string>"
}
'
{
  "message": "Phone number updated successfully.",
  "data": {
    "id": 1,
    "phone_number": "+14155551234",
    "nickname": "Vertrieb",
    "country_code": "US",
    "type": "normal"
  }
}
Dieser Endpunkt aktualisiert die bearbeitbaren Attribute einer Telefonnummer, die Ihnen 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 Ihnen geteilte Nummern (granted) zeigen den Spitznamen an, können aber von Ihnen 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. Senden Sie null oder einen leeren String, um es zu löschen.

​
Antwort

​
message
string
Erfolgsmeldung
​
data
object
Die aktualisierte Telefonnummer
{
  "message": "Phone number updated successfully.",
  "data": {
    "id": 1,
    "phone_number": "+14155551234",
    "nickname": "Vertrieb",
    "country_code": "US",
    "type": "normal"
  }
}
Der Spitzname ist dasselbe Label, das Sie im Dashboard setzen können. 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.