Bulk update endpoints

PATCH

https://cdn.emnify.net/api/v2/endpoint/multi

Updates details of a list of endpoints in bulk. The request body must be an array of endpoint objects. Each object requires an `id` field to identify the endpoint, and you only need to include the fields you want to update. Unlike [`PATCH /api/v1/endpoint/{endpoint_id}`](/developers/api/endpoint/endpoint-by-id-patch), this bulk endpoint handles multiple endpoints safely in a single request without sequential execution constraints between individual endpoints. <Note> Execute bulk operations sequentially - wait for each bulk request to complete before starting the next. </Note> <Warning> 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`). </Warning>

Updates details of a list of endpoints in bulk.

The request body must be an array of endpoint objects. Each object requires an id field to identify the endpoint, and you only need to include the fields you want to update.

Unlike PATCH /api/v1/endpoint/{endpoint_id}, this bulk endpoint handles multiple endpoints safely in a single request without sequential execution constraints between individual endpoints.

Execute bulk operations sequentially - wait for each bulk request to complete before starting the next.

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

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Request

This endpoint expects a list of objects.

idintegerRequired

The endpoint ID to update

namestringOptional

The endpoint name

tagsstringOptional

Comma-separated tags

imeistringOptional

The IMEI number

imei_lockbooleanOptional

Whether to lock the endpoint to this IMEI

ip_addressstringOptional

The IP address to assign

ip_address_spaceobjectOptional

Required when setting ip_address

service_profileobjectOptional

tariff_profileobjectOptional

statusobjectOptional

Endpoint status: 0 (Enabled) or 1 (Disabled)

simobjectOptional

Response

Endpoints updated successfully

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

$	curl -X PATCH https://cdn.emnify.net/api/v2/endpoint/multi \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '[
>	{
>	"id": 123456,
>	"name": "Updated endpoint name"
>	},
>	{
>	"id": 987654,
>	"tags": "new,tags"
>	}
>	]'

$	curl -X PATCH https://cdn.emnify.net/api/v2/endpoint/multi \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '[
>	{
>	"id": 123456,
>	"name": "Updated endpoint name"
>	},
>	{
>	"id": 987654,
>	"tags": "new,tags"
>	}
>	]'