Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

emnify subpackage_tagManagement API

The subpackage_tagManagement API from emnify — 8 operation(s) for subpackage_tagmanagement.

emnify subpackage_tagManagement API is one of 29 APIs that emnify publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 5 JSON Schema definitions.

Tagged areas include subpackage_tagManagement. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 5 JSON Schemas.

This API exposes 11 operations across 8 paths, and defines 41 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://cdn.emnify.net.

11 operations 8 paths 41 schemas 2 DELETE3 GET1 PATCH5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Server
https://cdn.emnify.net
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

emnify subpackage_tagManagement API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — Retrieve a JWT via POST /api/v1/authenticate using an applicationtoken or user credentials, then send it as Authorization: Bearer .

Paths & Operations 11

Across 8 paths, the API surfaces 11 operations — 2 DELETE, 3 GET, 1 PATCH, 5 POST. Each is listed below with its method, path, parameters, and response codes.

subpackage_tagManagement 11
POST
/api/v2/bulk-operations/endpoint/add-tags
Bulk assign tags
assign-tag-to-endpoints-in-bulk 1 param body → 200400403409422
POST
/api/v2/bulk-operations/endpoint/remove-tags
Bulk unassign tags
unassign-tags-from-endpoints-in-bulk 1 param body → 200400403422
POST
/api/v2/bulk-operations/tag/delete-tags
Bulk delete tags
delete-tags-in-bulk 1 param body → 200400403422
GET
/api/v2/endpoint/{endpoint_id}/tags
List endpoint tags
list-endpoint-tags 2 params → 200400403
POST
/api/v2/endpoint/{endpoint_id}/tags
Assign a tag to an endpoint
assign-tag-to-endpoint 2 params body → 201400403409422
DELETE
/api/v2/endpoint/{endpoint_id}/tags/{tag_id}
Unassign a tag from an endpoint
unassign-endpoint-tag 3 params → 200400403404422
GET
/api/v2/tag-colors
Returns the list of available tag colors
list-tag-colors 1 param → 200
GET
/api/v2/tags
List tags
list-tags 4 params → 200400403
POST
/api/v2/tags
Create a tag
create-tag 1 param body → 201400403409422
DELETE
/api/v2/tags/{tag_id}
Delete a tag
delete-tag 2 params → 204403404
PATCH
/api/v2/tags/{tag_id}
Update a tag
update-tag 2 params body → 204400403404422

Schemas 41

The contract defines 41 schemas that model the data the API accepts and returns. The most detailed are Tag Management_ListTags_Response_200 (5 properties), ApiV2EndpointEndpointIdTagsGetResponsesContentApplicationJsonSchemaItems (4 properties), ApiV2TagsGetResponsesContentApplicationJsonSchemaDataItems (4 properties), AssignTagToEndpointRequestUnprocessableEntityError (3 properties). Each schema is shown below with its type and property counts.

ApiV2BulkOperationsEndpointRemoveTagsPostRequestBodyContentApplicationJsonSchemaItemsItemsEndpoint
object
1 property
UnassignTagsFromEndpointsInBulkRequestUnprocessableEntityError
object
3 properties
ApiV2BulkOperationsEndpointRemoveTagsPostRequestBodyContentApplicationJsonSchemaItemsItemsTagsItems
object
1 property
ApiV2BulkOperationsTagDeleteTagsPostRequestBodyContentApplicationJsonSchemaTagsItems
object
1 property
ApiV2TagsPostResponsesContentApplicationJsonSchemaTagColor
object
1 property 1 required
UnassignTagsFromEndpointsInBulkRequestBadRequestError
object
3 properties
Tag Management_CreateTag_Response_201
object
3 properties
ApiV2TagsGetResponsesContentApplicationJsonSchemaDataItems
object
4 properties
ApiV2BulkOperationsEndpointAddTagsPostRequestBodyContentApplicationJsonSchemaItemsItemsTagsItems
object
1 property
CreateTagRequestUnprocessableEntityError
object
3 properties
ApiV2EndpointEndpointIdTagsGetResponsesContentApplicationJsonSchemaItems
object
4 properties
AssignTagToEndpointRequestBadRequestError
object
3 properties
ApiV2TagsPostRequestBodyContentApplicationJsonSchemaColor
object
1 property 1 required
Tag Management_UnassignTagsFromEndpointsInBulk_Response_200
object
Empty response body
ApiV2BulkOperationsEndpointAddTagsPostRequestBodyContentApplicationJsonSchemaItemsItems
object
2 properties
UpdateTagRequestUnprocessableEntityError
object
3 properties
DeleteTagsInBulkRequestUnprocessableEntityError
object
3 properties
ApiV2BulkOperationsEndpointRemoveTagsPostRequestBodyContentApplicationJsonSchemaItemsItems
object
2 properties
AssignTagToEndpointsInBulkRequestConflictError
object
3 properties
AssignTagToEndpointsInBulkRequestUnprocessableEntityError
object
3 properties
ApiV2BulkOperationsEndpointAddTagsPostRequestBodyContentApplicationJsonSchemaItemsItemsEndpoint
object
1 property
Tag Management_UnassignEndpointTag_Response_200
object
Empty response body
UnassignEndpointTagRequestUnprocessableEntityError
object
3 properties
ListTagsRequestBadRequestError
object
3 properties
ApiV2TagsGetResponsesContentApplicationJsonSchemaDataItemsTagColor
object
1 property
UpdateTagRequestBadRequestError
object
3 properties
ApiV2EndpointEndpointIdTagsGetResponsesContentApplicationJsonSchemaItemsTagColor
object
1 property
ListEndpointTagsRequestBadRequestError
object
3 properties
UnassignEndpointTagRequestBadRequestError
object
3 properties
Tag Management_ListTags_Response_200
object
5 properties
DeleteTagsInBulkRequestBadRequestError
object
3 properties
AssignTagToEndpointRequestConflictError
object
3 properties
Tag Management_AssignTagToEndpoint_Response_201
object
Empty response body
CreateTagRequestConflictError
object
3 properties
ApiV2TagsTagIdPatchRequestBodyContentApplicationJsonSchemaColor
object
1 property 1 required
CreateTagRequestBadRequestError
object
3 properties
AssignTagToEndpointsInBulkRequestBadRequestError
object
3 properties
ApiV2TagColorsGetResponsesContentApplicationJsonSchemaItems
object
3 properties
AssignTagToEndpointRequestUnprocessableEntityError
object
3 properties
Tag Management_DeleteTagsInBulk_Response_200
object
Empty response body
Tag Management_AssignTagToEndpointsInBulk_Response_200
object
Empty response body

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

emnify-subpackage-tagmanagement-api-openapi.yml Raw ↑

Other APIs emnify publishes across the network.

emnify GraphQL API
emnify Data Streamer
emnify Documentation MCP Server
emnify subpackage_applicationTokens API
emnify subpackage_authentication API
emnify subpackage_automations API
emnify subpackage_cloudConnect API
emnify subpackage_customEvents API
emnify subpackage_endpoint API
emnify subpackage_euicc API
emnify subpackage_euiccOperation API
emnify subpackage_events API