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

NinjaOne Asset Tags API

The Asset Tags API from NinjaOne — 6 operation(s) for asset tags.

NinjaOne Asset Tags API is one of 22 APIs that NinjaOne publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Asset Tags. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

This API exposes 8 operations across 6 paths, and defines 9 schemas. It is described by OpenAPI 3.0.1, at version 2.0.9-draft.

Requests are made against the base URL https://app.ninjarmm.com/v2.

8 operations 6 paths 9 schemas 1 DELETE1 GET4 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2.0.9-draft
Base URL
https://app.ninjarmm.com/v2
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

NinjaOne Asset Tags API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearer) (oauth2). An API key is passed in the cookie as sessionKey (sessionKey). By default, every request must be authenticated.

Paths & Operations 8

Across 6 paths, the API surfaces 8 operations — 1 DELETE, 1 GET, 4 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Asset Tags 8
POST
/v2/tag/{assetType}
Batch tag assets
batchUpdateTags 1 param body → default
GET
/v2/tag
Get Asset Tags
getTags → 200
POST
/v2/tag
Create an Asset Tag
createTag body → 200
PUT
/v2/tag/{tagId}
Update an Asset Tag
updateTag 1 param body → 200
DELETE
/v2/tag/{tagId}
Delete an Asset Tag
deleteTag 1 param → default
POST
/v2/tag/delete
Delete several Asset Tags
deleteTags body → default
POST
/v2/tag/merge
Merge existing tags
mergeTags body → default
PUT
/v2/tag/{assetType}/{assetId}
Set the tags for an asset to exactly the supplied values
setTagsForAsset 2 params body → default

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are ItamTagDTO (10 properties), ItamTagPublicApiDTO (7 properties), MergeItamTagsPublicApiRequest (5 properties), UserBasicInfo (3 properties). Each schema is shown below with its type and property counts.

ItamTagPublicApiDTO
object
7 properties
UpdateItamTagRequest
object
2 properties
ItamManageAssetRequestPublicApiDTO
object
3 properties
UserBasicInfo
object
3 properties
MergeItamTagsPublicApiRequest
object
5 properties
ItamTagDTO
object
10 properties
GetItamTagsResponse
object
1 property
CreateItamTagRequest
object
2 properties
ItamSetAssetTagsRequestPublicApiDTO
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ninjaone-asset-tags-api-openapi.yml Raw ↑

Other APIs NinjaOne publishes across the network.

NinjaOne Backup API
NinjaOne Checklist Templates API
NinjaOne Custom Fields API
NinjaOne Custom Tabs API
NinjaOne devices API
NinjaOne Document Templates API
NinjaOne groups API
NinjaOne Knowledge Base Articles API
NinjaOne Location API
NinjaOne management API
NinjaOne organization API
NinjaOne Organization Checklists API