Sign in

v1

latestOpenAPI 3.1.02026-07-2481742657.4 KB
Tags and Comments

Update a tag

Update an existing tag in your organization. Only the fields provided in the request body will be updated; omitted fields are left unchanged.<br><br>Only the tag's creator or an organization admin can update a private tag. Tags with the shared setting can be updated by any organization member.<br><br>This endpoint does not cost any credits to execute.

put/v3/tags/{tag_id}

Path parameters

tag_idstring uuid required

The ID of the tag to update.

The ID of the tag to update.

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

New description.

namestring

New display name. Must be unique within the organization.

privacy'private' | 'shared'

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 updated successfully