Bulk delete tag assignments

post

https://api.platform.censys.io/v3/tags/{tag_id}/assignments/bulk-delete

Start a long-running operation that removes a tag from its assigned assets, optionally restricted to a creation-time window. The operation runs asynchronously; use the returned operation to track its progress.

This endpoint does not cost any credits to execute.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

tag_id

uuid

required

The ID of the tag whose assignments to delete.

Body Params

created_after

date-time

RFC3339 timestamp. Only delete assignments created after this time.

created_before

date-time

RFC3339 timestamp. Only delete assignments created before this time.

Query Params

organization_id

uuid

required

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

Headers

X-Organization-ID

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

202Bulk delete operation started successfully

401Request does not contain a valid Authorization token

403User does not have permission to access this data

404Tag not found

409Feature not enabled

422Invalid input

500Internal server error