Update an endpoint

PATCH

https://smartsim.telecom.li/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).

Telecom Liechtenstein 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> Telecom Liechtenstein 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_idintegerRequired

Numeric ID of an endpoint

Request

This endpoint expects an object.

service_profileobjectRequired

tariff_profileobjectRequired

statusobjectRequired

ip_address_spaceobjectRequired

simobjectRequired

namestringRequired

imeistringRequired

imei_lockbooleanRequired

ip_addressstringRequired

tag_assignmentslist of integersOptional

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.

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>

tagsstring or nullOptionalDeprecated

Comma-separated tag names 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.

Deprecated. Use tag_assignments instead.

Comma-separated tag names 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>

Response

Endpoint updated successfully

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error