Sign in
Esims

Update a physical eSIM's self-reported MSISDN and/or display name

Updates the eSIM's self-reported msisdn and/or display name. Both fields are optional, but the request body itself is required. Omitting a field leaves it unchanged; setting it to null or an empty string clears it. name is capped at 15 characters. Available regardless of the eSIM's current status.

patch/numbers/esims/{id}

Path parameters

idstring uuid required
Example:550e8400-e29b-41d4-a716-446655440000

Request body

msisdnstring nullable

Self-reported E.164 MSISDN for this eSIM's line. Omit to leave unchanged; null/empty clears it. An unverified label — never used for routing.

namestring nullable

User-defined display label — NFC-normalized, up to 15 GRAPHEMES (not UTF-16 code units; an emoji/flag may span several). Omit to leave unchanged; null/empty/whitespace-only clears it.

Example request

{
  "msisdn": "+33612345678",
  "name": "Mom's phone"
}

Response

eSIM updated

Changes