Update an endpoint

PATCH

https://cdn.emnify.net/api/v1/endpoint/:endpoint_id

Updates the details of an endpoint. <Note> Execute this operation sequentially - wait for each request to complete before starting the next. For bulk updates, use [`PATCH /api/v2/endpoint/multi`](/developers/api/endpoint/bulk-update-endpoint) instead (supports up to 2,000 endpoints). </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>

Update an endpoint

PATCH

https://cdn.emnify.net/api/v1/endpoint/:endpoint_id

Updates the details of an endpoint.

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

Updates the details of an endpoint. <Note> Execute this operation sequentially - wait for each request to complete before starting the next. For bulk updates, use [`PATCH /api/v2/endpoint/multi`](/developers/api/endpoint/bulk-update-endpoint) instead (supports up to 2,000 endpoints). </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.

Path parameters

endpoint_idstringRequired

Request

This endpoint expects an object.

service_profileobjectRequired

tariff_profileobjectRequired

statusobjectRequired

ip_address_spaceobjectRequired

simobjectRequired

namestringRequired

tagsstringRequired

imeistringRequired

imei_lockbooleanRequired

ip_addressstringRequired

Response

Endpoint 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/v1/endpoint/endpoint_id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"service_profile": {
>	"id": 2
>	},
>	"tariff_profile": {
>	"id": 3
>	},
>	"status": {
>	"id": 0
>	},
>	"ip_address_space": {
>	"id": 1
>	},
>	"sim": {
>	"id": 1234567,
>	"status": {
>	"id": 1
>	}
>	},
>	"name": "test",
>	"tags": "test1,test2",
>	"imei": "1234567890",
>	"imei_lock": false,
>	"ip_address": "127.0.0.1"
>	}'

$	curl -X PATCH https://cdn.emnify.net/api/v1/endpoint/endpoint_id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"service_profile": {
>	"id": 2
>	},
>	"tariff_profile": {
>	"id": 3
>	},
>	"status": {
>	"id": 0
>	},
>	"ip_address_space": {
>	"id": 1
>	},
>	"sim": {
>	"id": 1234567,
>	"status": {
>	"id": 1
>	}
>	},
>	"name": "test",
>	"tags": "test1,test2",
>	"imei": "1234567890",
>	"imei_lock": false,
>	"ip_address": "127.0.0.1"
>	}'