endpoint

Bulk update endpoints

<Info icon="fa-light fa-lock" className="permission-callout"> <div className="permission-callout__header"><span className="permission-callout__title"><span className="permission-callout__label">Required permissions</span> <span className="fern-docs-badge small blue subtle rounded-full permission-callout__beta">Beta</span></span> <span className="permission-callout__learn-more">[Learn more](/developers/api-guidelines/permissions#how-permissions-work)</span></div>

Endpoint + Update <span className="permission-callout__also">+1 endpoint</span>

<div className="permission-callout__roles"><span className="permission-callout__roles-label">Roles:</span> <Badge intent="info">Administrator</Badge> <Badge intent="info">User</Badge></div> </Info>

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.

<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>
patch/api/v2/endpoint/multi

Request

  • Base URL: https://cdn.emnify.net
  • URL: https://cdn.emnify.net/api/v2/endpoint/multi
  • Auth: HTTP bearer

Request body

idinteger required

The endpoint ID to update

namestring

The endpoint name

tagsstring nullable

Comma-separated tags replacing the tags currently assigned to the endpoint. Tags that don't exist yet are created, an empty string removes all tags. Sending null leaves the current tags unchanged, the same as omitting the field.

<Warning> Deprecated. Use `tag_assignments` instead. </Warning>
tag_assignmentsinteger[]

IDs of existing tags replacing the tags currently assigned to the endpoint. An empty array removes all tags.

<Info> Mutually exclusive with `tags`. Provide at most one of the two. </Info>
imeistring

The IMEI number

imei_lockboolean

Whether to lock the endpoint to this IMEI

ip_addressstring

The IP address to assign

Response

Endpoints updated successfully

object required

Changes

No recorded changes to this operation across all 1 revision of this API.