Sign in

v1

latestOpenAPI 3.1.02026-07-2481742657.4 KB
Tags and Comments

Create a tag assignment

Assign a tag to an asset. Tag assignments are only visible to members of your organization, depending on the tag's privacy settings. You must have access to the tag to assign it to an asset.<br><br>This endpoint does not cost any credits to execute.

post/v3/tags/{tag_id}/assignments

Path parameters

tag_idstring uuid required

The ID of the tag to assign.

The ID of the tag to assign.

Query parameters

organization_idstring uuid required

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information.

Example:11111111-2222-3333-4444-555555555555

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information.

Headers

X-Organization-IDstring uuid

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

Example:11111111-2222-3333-4444-555555555555

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

Request body

asset_idstring required

The identifier of the asset (host IP, certificate SHA-256 fingerprint, or web property hostname:port).

Example request

{
  "asset_id": "8.8.8.8"
}

Response

Tag assignment created successfully