Sign in

v1

latestOpenAPI 3.1.02026-07-2481742657.4 KB
Tags and Comments

Create a tag

Create a new tag in your organization. Tags can be used to label and organize assets.<br><br>Specify a privacy setting to control visibility: private tags are only visible to you and organization admins, while shared tags are visible and manageable by all organization members.<br><br>Tag names must be unique within your organization.<br><br>This endpoint does not cost any credits to execute.

post/v3/tags

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

descriptionstring

A human-readable description of the tag.

namestring required

The display name of the tag. Must be unique within the organization.

privacy'private' | 'shared' required

Tag visibility and management settings. private tags are only visible to and editable by organization admins. shared tags are visible to and editable by all organization members.

Response

Tag created successfully