API Reference

Bulk create tag assignments

post
https://api.platform.censys.io/v3/tags//assignments/bulk-create

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.

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.

This endpoint does not cost any credits to execute.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

The ID of the tag to assign.

Body Params
int64
≥ 0

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.

string
required

A CenQL query identifying the assets to tag.

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 2 months ago

Did this page help you?
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 2 months ago

Did this page help you?