Update an endpoint
Updates the details of an endpoint.
Changing any of these fields resets the device’s connectivity: service_profile, tariff_profile, status, ip_address, ip_address_space, imei, imei_lock, or sim.
The network sends a Cancel Location, which ends the device’s active data session, and the device must reconnect.
Other fields, such as name, tags, and tag_assignments, don’t reset connectivity.
The reset happens only when a value changes.
For example, setting service_profile to the service policy the device already uses doesn’t reset it.
If you assign a SIM that belongs to another device, that device’s connectivity resets too.
To reset a device’s connectivity without changing its details, use PATCH /api/v1/endpoint/{endpoint_id}/connectivity.
Execute this operation sequentially - wait for each request to complete before starting the next.
For bulk updates, use PATCH /api/v2/endpoint/multi instead (supports up to 2,000 endpoints).
emnify charges for activated SIMs, even if the endpoint status is set to Disabled.
To avoid accruing unexpected charges, update the SIM status to Suspended ("id": 2).
Authentication
An auth_token should be provided to authenticate a session.
To obtain an auth_token, see the /api/v1/authenticate POST request.
Path parameters
Request
IDs of existing tags replacing the tags currently assigned to the endpoint. An empty array removes all tags.
Mutually exclusive with tags. Provide at most one of the two.