Bulk create tag assignments

Start a long-running operation that assigns a tag to every asset matching a CenQL query. The operation runs asynchronously; use the returned operation to track its progress.<br><br>A tag can hold a limited number of asset assignments, and the limit depends on your plan. If the operation reaches that limit before every matching asset is tagged, it finishes with status limit_reached.<br><br>This endpoint does not cost any credits to execute.

tag_idstring uuid required

The ID of the tag to assign.

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.

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

max_assetsinteger

Optional upper bound on the number of assets to tag in this operation. This is your own limit for this request, separate from your plan's tag asset limit: the effective cap is the smaller of this value, your plan's tag asset limit, and the number of matching results. Omit or set to 0 for no explicit cap.

querystring required

A CenQL query identifying the assets to tag.

Response

Bulk create operation started successfully

v1

Bulk create tag assignments

Path parameters

Query parameters

Headers

Request body

Response