API Reference

Create a tag

post
https://api.platform.censys.io/v3/tags

Create a new tag in your organization. Tags can be used to label and organize assets.

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.

Tag names must be unique within your organization.

This endpoint does not cost any credits to execute.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
length ≤ 1000

A human-readable description of the tag.

string
required
length between 1 and 255

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

string
enum
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.

Allowed:
Query Params
uuid
required

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

Headers
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.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 3 hours ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated about 3 hours ago