Bulk update endpoints | emnify Documentation

curl -X PATCH https://cdn.emnify.net/api/v2/endpoint/multi \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "0": {
    "id": 123456,
    "name": "Test 1",
    "tags": "test1,test2",
    "imei": "1234567890",
    "imei_lock": false,
    "ip_address": "127.0.0.1",
    "ip_address_space": {
      "id": 1
    },
    "service_profile": {
      "id": 2
    },
    "tariff_profile": {
      "id": 3
    },
    "status": {
      "id": 0
    },
    "sim": {
      "id": 1234567,
      "status": {
        "id": 1
      }
    }
  },
  "1": {
    "id": 987654,
    "name": "Test 2",
    "tags": "test1,test2",
    "imei": "1234567891",
    "imei_lock": false,
    "ip_address": "127.0.0.2",
    "ip_address_space": {
      "id": 1
    },
    "service_profile": {
      "id": 2
    },
    "tariff_profile": {
      "id": 3
    },
    "status": {
      "id": 0
    },
    "sim": {
      "id": 98765,
      "status": {
        "id": 1
      }
    }
  },
  "service_profile": {
    "id": 1.1
  },
  "tariff_profile": {
    "id": 1.1
  },
  "status": {
    "id": 1.1
  },
  "ip_address_space": {
    "id": 1.1
  },
  "sim": {
    "id": 1.1,
    "status": {
      "id": 1.1
    }
  },
  "name": "string",
  "tags": "string",
  "imei": "string",
  "imei_lock": true,
  "ip_address": "string",
  "id": 1.1
}'

Updates details of a list of endpoints in bulk.

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).

Updates details of a list of endpoints in bulk. 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>

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 an object.

service_profileobjectRequired

tariff_profileobjectRequired

statusobjectRequired

ip_address_spaceobjectRequired

simobjectRequired

namestringRequired

tagsstringRequired

imeistringRequired

imei_lockbooleanRequired

ip_addressstringRequired

iddoubleRequired

Response

Endpoints updated successfully

Authentication

Request

Response

Errors