Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt

Use this file to discover all available pages before exploring further.

OTA (Over-The-Air) updates let Telnyx push configuration changes to your SIMs remotely. No physical access needed — updates are delivered to the SIM’s on-card applet the next time the device connects.

​
What Gets Updated

OTA updates handle SIM-level configuration: IMSI profile switches, network preference changes, and applet settings. These are not firmware updates for the device itself — they modify the SIM card’s internal state. The type field on each update indicates the operation source and what changed.

​
Tracking Updates

List updates for your fleet: 
GET /ota_updates
Or check a specific update: 
GET /ota_updates/{id}
Each update includes:
FieldDescription
sim_card_idTarget SIM
typeOperation type — relates to the source of the request
statusCurrent state of the update
settingsJSON object with the specific changes applied
created_atWhen the update was initiated

​
How It Works

  1. Telnyx queues the update for the target SIM.
  2. The next time the device attaches to the network, the SIM’s applet receives the update.
  3. The update applies automatically. Status transitions from pending to complete (or failed).
There’s no way to force immediate delivery — it depends on when the device next connects. For always-on devices this is near-instant. For devices that sleep or power cycle, it happens on next wake.

​
Multi-IMSI Context

The most common OTA operation is IMSI profile switching. Telnyx SIMs carry multiple IMSIs, and the on-card applet auto-selects the best one per location. OTA updates can override this selection or push updated IMSI profiles when Telnyx adds new carrier partnerships.