--- title: Censys Platform slug: connectors/censys-platform docTags: createdAt: 2026-06-18T04:21:08.861Z --- Censys Platform provides visibility into internet-connected devices and services, aiding in security analysis and risk management. Censys Platform is a comprehensive search engine for internet-connected devices and services, providing detailed insights into global internet infrastructure. This connector allows Swimlane Turbine users to automate asset management and security workflows by integrating Censys Platform capabilities. Users can efficiently manage and organize assets, retrieve detailed host information, and execute search queries, enhancing their security operations with actionable intelligence and streamlined processes. Censys Platform empowers users with the most comprehensive, accurate, and up-to-date map of the Internet for proactive and reactive security analysis at scale. ## Prerequisites Before you can use the Censys Platform connector for Turbine, you'll need access to the Censys API. This requires the following: - HTTP Basic authentication using the following parameters: - URL: The endpoint for accessing Censys API services. - API ID: Your unique identifier for API access. - API Secret: A secret key associated with your API ID for secure access. - HTTP Bearer authentication using the following parameters: - URL: The endpoint for accessing Censys API services. - Token: A bearer token such as a JWT for authenticating requests. ## Capabilities The Censys Platform Connector provides the following capabilities: - Add Comments about a Given Host - Create a Tag V3 - Get a Host - Get Metadata from host - Retrieve Tags for a Host - Returns Comments about a Given Host - Run a Search Query - Search Host - Search Host by IP - Update a Tag V3 ### Limitations Only Search and Metadata actions are available for free users. To access Tags and Comments actions, a commercial account is required. ## API Documentation For more information on Censys Platform : [Censys Platform API](https://docs.censys.com/reference/get-started) ## Note V2 (Censys Search) is being deprecated as of September 2026 and will no longer be supported. # Configurations ## Censys Platform HTTP Basic Authentication Authenticates using username and password. ### Configuration Parameters | **Parameter** | **Description** | **Type** | **Required** | | ------------- | ---------------------------------- | -------- | ------------ | | url | A URL to the target host. | string | Required | | username | API ID. | string | Required | | password | API Secret. | string | Required | | verify\_ssl | Verify SSL certificate. | boolean | Optional | | http\_proxy | A proxy to route requests through. | string | Optional | ## Censys Platform HTTP Bearer Authentication Censys Platform Authenticates using bearer token such as a JWT. ### Configuration Parameters | **Parameter** | **Description** | **Type** | **Required** | | ------------- | ---------------------------------- | -------- | ------------ | | url | A URL to the target host. | string | Required | | token | Bearer token for Censys Platform. | string | Required | | verify\_ssl | Verify SSL certificate | boolean | Optional | | http\_proxy | A proxy to route requests through. | string | Optional | # Actions ## Add Comments about a Given Host Add a user-defined comment to a host in Censys using the IP address and specified content. ### Endpoint - **URL:** `/api/v2/hosts/{{ip}}/comments` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | -------------------- | -------- | ------------ | ------------------------------------- | | `path_parameters.ip` | string | Required | The IP Address of the requested host. | | `contents` | string | Optional | Response content | ### Input Example `{"json_body":{"contents":"**This is a comment.**"},"path_parameters":{"ip":"1.1.1.1"}}` ### Output | **Parameter** | **Type** | **Description** | | ------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `code` | number | Output field: code | | `status` | string | Status value | | `result` | object | Result of the operation | | `result.id` | string | Unique identifier | | `result.ip` | string | Result of the operation | | `result.author_id` | string | Unique identifier | | `result.contents` | string | Response content | | `result.created_at` | string | Result of the operation | ### Output Example `{"status_code":200,"response_headers":{"Date":"Thu, 22 Aug 2024 05:23:22 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","access-control-allow-origin":"*","x-content-type-options":"nosniff","strict-transport-security":"max-age=31536000; includeSubDomains; preload","access-control-allow-credentials":"true","access-control-allow-methods":"PUT, GET, POST, OPTIONS","access-control-allow-headers":"DNT,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Si...` ## Create a Tag V3 Create a new tag in your Censys Platform organization to label and organize assets. Requires organization ID, name, and privacy settings. ### Endpoint - **URL:** `v3/tags` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ---------------------------- | -------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `parameters.organization_id` | string | Required | The ID of a Censys organization to associate the request with. | | `headers` | object | Optional | HTTP headers for the request | | `headers.X-Organization-ID` | string | Optional | The ID of a Censys organization to associate the request with. | | `headers.accept` | string | Optional | Generated from available response content types. | | `description` | string | Optional | A human-readable description of the tag. | | `name` | string | Optional | The display name of the tag. Must be unique within the organization. | | `privacy` | string | Optional | 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. | ### Input Example `{"parameters":{"organization_id":"11111111-2222-3333-4444-555555555555"},"json_body":{"description":"This is a test tag","name":"test-tag","privacy":"private"},"headers":{"X-Organization-ID":"11111111-2222-3333-4444-555555555555","accept":"application/json"}}` ### Output | **Parameter** | **Type** | **Description** | | -------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `result` | object | Result of the operation | | `result.created_at` | string | Result of the operation | | `result.created_by` | string | Result of the operation | | `result.description` | string | Result of the operation | | `result.id` | string | Unique identifier | | `result.name` | string | Name of the resource | | `result.privacy` | string | Result of the operation | | `result.updated_at` | string | Result of the operation | ### Output Example `{"status_code":201,"response_headers":{},"reason":"Created","json_body":{"result":{"created_at":"2026-05-12T16:51:58.609Z","created_by":"3fa85f64-5717-4562-b3fc-2c963f66afa6","description":"string","id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","name":"string","privacy":"private","updated_at":"2026-05-12T16:51:58.609Z"}}}` ## Get a Host Retrieve detailed information about a single host using its IP address as the host ID in Censys Platform. ### Endpoint - **URL:** `v3/global/asset/host/{{host_id}}` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ---------------------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `parameters.organization_id` | string | Optional | The ID of a Censys organization to associate the request with. | | `parameters.at_time` | string | Optional | RFC3339 Timestamp to view a host at a specific point in time. Must be a valid RFC3339 string. Ensure that you suffix the date with "T00:00:00Z" or a specific time. | | `path_parameters.host_id` | string | Required | The IP address of the host to retrieve. | | `headers` | object | Optional | HTTP headers for the request | | `headers.X-Organization-ID` | string | Optional | The ID of a Censys organization to associate the request with. | | `headers.accept` | string | Optional | Generated from available response content types. | ### Input Example `{"parameters":{"organization_id":"test_123456","at_time":"2026-05-12T00:00:00Z"},"path_parameters":{"host_id":"8.8.8.8"},"headers":{"accept":"application/json"}}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------------------------------ | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `result` | object | Result of the operation | | `result.resource` | object | Result of the operation | | `result.resource.ip` | string | Result of the operation | | `result.resource.location` | object | Result of the operation | | `result.resource.location.continent` | string | Result of the operation | | `result.resource.location.country` | string | Result of the operation | | `result.resource.location.country_code` | string | Result of the operation | | `result.resource.location.city` | string | Result of the operation | | `result.resource.location.postal_code` | string | Result of the operation | | `result.resource.location.timezone` | string | Result of the operation | | `result.resource.location.province` | string | Result of the operation | | `result.resource.location.coordinates` | object | Result of the operation | | `result.resource.location.coordinates.latitude` | number | Result of the operation | | `result.resource.location.coordinates.longitude` | number | Result of the operation | | `result.resource.autonomous_system` | object | Result of the operation | | `result.resource.autonomous_system.asn` | number | Result of the operation | | `result.resource.autonomous_system.description` | string | Result of the operation | | `result.resource.autonomous_system.bgp_prefix` | string | Result of the operation | | `result.resource.autonomous_system.name` | string | Name of the resource | | `result.resource.autonomous_system.country_code` | string | Result of the operation | | `result.resource.whois` | object | Result of the operation | | `result.resource.whois.network` | object | Result of the operation | | `result.resource.whois.network.handle` | string | Result of the operation | ### Output Example `{"status_code":200,"response_headers":{"Date":"Tue, 12 May 2026 07:27:56 GMT","Content-Type":"application/vnd.censys.api.v3.host.v1+json","Transfer-Encoding":"chunked","Connection":"keep-alive","x-request-id":"159eb614-e35d-88ce-6083-445b30b47bfd","strict-transport-security":"max-age=2592000; includeSubDomains; preload","x-content-type-options":"nosniff","x-frame-options":"DENY","cf-cache-status":"DYNAMIC","set-cookie":"__cf_bm=qKNF3_AJaXvGQVZYaP1wUfxCTHTK7H7KMbqG6HBryMk-1778570875.5542178-1.0.1...` ## Get Metadata from Host Retrieve a list of services scanned by Censys, usable as 'services.service\_name' values in search queries. ### Endpoint - **URL:** `/api/v2/metadata/hosts` - **Method:** `GET` ### Output | **Parameter** | **Type** | **Description** | | ----------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `code` | number | Output field: code | | `status` | string | Status value | | `result` | object | Result of the operation | | `result.services` | array | Result of the operation | ### Output Example `{"status_code":200,"response_headers":{"Date":"Thu, 22 Aug 2024 05:23:22 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","access-control-allow-origin":"*","x-content-type-options":"nosniff","strict-transport-security":"max-age=31536000; includeSubDomains; preload","access-control-allow-credentials":"true","access-control-allow-methods":"PUT, GET, POST, OPTIONS","access-control-allow-headers":"DNT,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Si...` ## Retrieve Tags for Host Retrieve a list of tags for a specified host in Censys using the unique host identifier. ### Endpoint - **URL:** `/api/v2/tags/{{id}}/hosts` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | -------------------- | -------- | ------------ | ------------------------- | | `path_parameters.id` | string | Required | The unique ID of the tag. | ### Input Example `{"path_parameters":{"id":"123"}}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------ | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `code` | number | Output field: code | | `status` | string | Status value | | `result` | object | Result of the operation | | `result.hosts` | array | Result of the operation | | `result.hosts.ip` | string | Result of the operation | | `result.hosts.tagged_at` | string | Result of the operation | ### Output Example `{"status_code":200,"response_headers":{"Date":"Thu, 22 Aug 2024 05:23:22 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","access-control-allow-origin":"*","x-content-type-options":"nosniff","strict-transport-security":"max-age=31536000; includeSubDomains; preload","access-control-allow-credentials":"true","access-control-allow-methods":"PUT, GET, POST, OPTIONS","access-control-allow-headers":"DNT,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Si...` ## Returns Comments about a Given Host Retrieve user-generated comments for a specified host IP address in Censys Platform using the required path parameter 'ip'. ### Endpoint - **URL:** `/api/v2/hosts/{{ip}}/comments` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | -------------------- | -------- | ------------ | ------------------------------------- | | `path_parameters.ip` | string | Required | The IP Address of the requested host. | ### Input Example `{"path_parameters":{"ip":""}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `code` | number | Output field: code | | `status` | string | Status value | | `result` | object | Result of the operation | | `result.ip` | string | Result of the operation | | `result.comments` | array | Result of the operation | | `result.comments.id` | string | Unique identifier | | `result.comments.ip` | string | Result of the operation | | `result.comments.author_id` | string | Unique identifier | | `result.comments.contents` | string | Response content | | `result.comments.created_at` | string | Result of the operation | ### Output Example `{"status_code":200,"response_headers":{"Date":"Thu, 22 Aug 2024 05:23:22 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","access-control-allow-origin":"*","x-content-type-options":"nosniff","strict-transport-security":"max-age=31536000; includeSubDomains; preload","access-control-allow-credentials":"true","access-control-allow-methods":"PUT, GET, POST, OPTIONS","access-control-allow-headers":"DNT,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Si...` ## Run a Search Query Run a search query across Censys data using the specified JSON body with the required 'query' parameter. ### Endpoint - **URL:** `v3/global/search/query` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ---------------------------- | -------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `parameters.organization_id` | string | Optional | The ID of a Censys organization to associate the request with. | | `headers` | object | Optional | HTTP headers for the request | | `headers.X-Organization-ID` | string | Optional | The ID of a Censys organization to associate the request with. | | `headers.accept` | string | Optional | Generated from available response content types. | | `fields` | array | Optional | Specify fields to only return in the response. If you provide fields and omit host.services.port, host.services.transport\_protocol, and host.services.protocol, then matched\_services will not be returned in the response. | | `page_size` | number | Optional | Number of results to return to per page. The default and maximum is 100. | | `page_token` | string | Optional | page token for the requested page of search results. | | `query` | string | Optional | CenQL query string to search upon. | ### Input Example `{"parameters":{"organization_id":"11111111-2222-3333-4444-555555555555"},"json_body":{"fields":["host.ip"],"page_size":10,"page_token":"nextPageToken","query":"host.services: (protocol=SSH and not port: 22)"},"headers":{"X-Organization-ID":"11111111-2222-3333-4444-555555555555","accept":"application/json"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------------------------------------------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `result` | object | Result of the operation | | `result.hits` | array | Result of the operation | | `result.hits.certificate_v1` | object | Result of the operation | | `result.hits.certificate_v1.extensions` | object | Result of the operation | | `result.hits.certificate_v1.resource` | object | Result of the operation | | `result.hits.certificate_v1.resource.added_at` | string | Result of the operation | | `result.hits.certificate_v1.resource.ct` | object | Result of the operation | | `result.hits.certificate_v1.resource.ever_seen_in_scan` | boolean | Result of the operation | | `result.hits.certificate_v1.resource.fingerprint_md5` | string | Result of the operation | | `result.hits.certificate_v1.resource.fingerprint_sha1` | string | Result of the operation | | `result.hits.certificate_v1.resource.fingerprint_sha256` | string | Result of the operation | | `result.hits.certificate_v1.resource.modified_at` | string | Result of the operation | | `result.hits.certificate_v1.resource.names` | array | Name of the resource | | `result.hits.certificate_v1.resource.parent_spki_fingerprint_sha256` | string | Result of the operation | | `result.hits.certificate_v1.resource.parent_spki_subject_fingerprint_sha256` | string | Result of the operation | | `result.hits.certificate_v1.resource.parse_status` | string | Status value | | `result.hits.certificate_v1.resource.parsed` | object | Result of the operation | | `result.hits.certificate_v1.resource.precert` | boolean | Result of the operation | | `result.hits.certificate_v1.resource.revocation` | object | Result of the operation | | `result.hits.certificate_v1.resource.revoked` | boolean | Result of the operation | | `result.hits.certificate_v1.resource.spki_fingerprint_sha256` | string | Result of the operation | | `result.hits.certificate_v1.resource.spki_subject_fingerprint_sha256` | string | Result of the operation | | `result.hits.certificate_v1.resource.tbs_fingerprint_sha256` | string | Result of the operation | ### Output Example `{"status_code":200,"response_headers":{"Date":"Tue, 12 May 2026 07:27:56 GMT","Content-Type":"application/vnd.censys.api.v3.host.v1+json","Transfer-Encoding":"chunked","Connection":"keep-alive","x-request-id":"159eb614-e35d-88ce-6083-445b30b47bfd","strict-transport-security":"max-age=2592000; includeSubDomains; preload","x-content-type-options":"nosniff","x-frame-options":"DENY","cf-cache-status":"DYNAMIC","set-cookie":"__cf_bm=qKNF3_AJaXvGQVZYaP1wUfxCTHTK7H7KMbqG6HBryMk-1778570875.5542178-1.0.1...` ## Search Host Execute a search in Censys for specific host or service attributes, returning a summary list of matching hosts. ### Endpoint - **URL:** `/api/v2/hosts/search` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | -------------------------- | -------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `parameters.q` | string | Optional | Query used to search for hosts with matching attributes. Uses the Censys Search Language. | | `parameters.per_page` | number | Optional | The maximum number of hits to return in each response (minimum of 1, maximum of 100). | | `parameters.virtual_hosts` | string | Optional | Determine how to query Virtual Hosts. The default is EXCLUDE which will ignore any virtual hosts entries. When set to INCLUDE or ONLY virtual hosts will be present in the returned list of hits, with the later returning only virtual hosts. | | `parameters.sort` | string | Optional | Sort the results. | | `parameters.cursor` | string | Optional | Cursor token from the API response, which fetches the next or previous page of hits when added to the endpoint URL. | | `parameters.fields` | string | Optional | Comma separated list of up to 25 fields to be returned for each result. (This parameter is only available to paid users). | ### Input Example `{"parameters":{"q":"services.service_name: HTTP","per_page":50,"virtual_hosts":"EXCLUDE","sort":"RELEVANCE","cursor":"nextCursorToken","fields":"ip,services"}}` ### Output | **Parameter** | **Type** | **Description** | | -------------------------------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `code` | number | Output field: code | | `status` | string | Status value | | `result` | object | Result of the operation | | `result.query` | string | Result of the operation | | `result.total` | number | Result of the operation | | `result.duration` | number | Result of the operation | | `result.hits` | array | Result of the operation | | `result.hits.ip` | string | Result of the operation | | `result.hits.location` | object | Result of the operation | | `result.hits.location.city` | string | Result of the operation | | `result.hits.location.province` | string | Result of the operation | | `result.hits.location.timezone` | string | Result of the operation | | `result.hits.location.country` | string | Result of the operation | | `result.hits.location.continent` | string | Result of the operation | | `result.hits.location.postal_code` | string | Result of the operation | | `result.hits.location.country_code` | string | Result of the operation | | `result.hits.location.coordinates` | object | Result of the operation | | `result.hits.location.coordinates.latitude` | number | Result of the operation | | `result.hits.location.coordinates.longitude` | number | Result of the operation | | `result.hits.last_updated_at` | string | Result of the operation | | `result.hits.autonomous_system` | object | Result of the operation | | `result.hits.autonomous_system.description` | string | Result of the operation | | `result.hits.autonomous_system.bgp_prefix` | string | Result of the operation | ### Output Example `{"code":123,"status":"active","result":{"query":"string","total":123,"duration":123,"hits":[{}],"links":{"next":"string","prev":"string"}}}` ## Search Host by IP Retrieve a detailed view of a host's services from Censys using the specified IP address. ### Endpoint - **URL:** `api/v2/hosts/{{ip}}` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | -------------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `path_parameters.ip` | string | Required | The IP Address of the requested host. | | `parameters.at_time` | string | Optional | Fetches the Censys view of a host and its services at the specified point in time. Requires historical API access. Nanosecond precision is allowed. Uses RFC3339 Timestamp. | ### Input Example `{"parameters":{"at_time":"2023-10-01T00:00:00Z"},"path_parameters":{"ip":"1.1.1.1"}}` ### Output | **Parameter** | **Type** | **Description** | | --------------------------------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `code` | number | Output field: code | | `status` | string | Status value | | `result` | object | Result of the operation | | `result.ip` | string | Result of the operation | | `result.services` | array | Result of the operation | | `result.services.port` | number | Result of the operation | | `result.services.service_name` | string | Name of the resource | | `result.services.transport_protocol` | string | Result of the operation | | `result.services.extended_service_name` | string | Name of the resource | | `result.services.dns` | object | Result of the operation | | `result.services.dns.server_type` | string | Type of the resource | | `result.services.http` | object | Result of the operation | | `result.services.http.request` | object | Result of the operation | | `result.services.http.request.method` | string | HTTP method to use | | `result.services.http.request.uri` | string | Result of the operation | | `result.services.http.request.headers` | object | HTTP headers for the request | | `result.services.http.response` | object | Result of the operation | | `result.services.http.response.body` | string | Request body data | | `result.services.http.response.protocol` | string | Result of the operation | | `result.services.http.response.body_size` | number | Request body data | | `result.services.http.response.status_code` | number | Status value | | `result.services.http.response.status_reason` | string | Status value | | `result.services.http.response.headers` | object | HTTP headers for the request | ### Output Example `{"status_code":200,"response_headers":{"Date":"Thu, 22 Aug 2024 05:23:22 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","access-control-allow-origin":"*","x-content-type-options":"nosniff","strict-transport-security":"max-age=31536000; includeSubDomains; preload","access-control-allow-credentials":"true","access-control-allow-methods":"PUT, GET, POST, OPTIONS","access-control-allow-headers":"DNT,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Si...` ## Update a Tag V3 Update an existing tag in your Censys Platform organization using the tag ID and organization ID. Only specified fields will be updated, while omitted fields remain unchanged. ### Endpoint - **URL:** `v3/tags/{{tag_id}}` - **Method:** `PUT` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ---------------------------- | -------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `path_parameters.tag_id` | string | Required | The unique ID of the tag to update. | | `parameters.organization_id` | string | Required | The ID of a Censys organization to associate the request with. | | `headers` | object | Optional | HTTP headers for the request | | `headers.X-Organization-ID` | string | Optional | The ID of a Censys organization to associate the request with. | | `headers.accept` | string | Optional | Generated from available response content types. | | `description` | string | Optional | A human-readable description of the tag. | | `name` | string | Optional | The display name of the tag. Must be unique within the organization. | | `privacy` | string | Optional | 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. | ### Input Example `{"parameters":{"organization_id":"11111111-2222-3333-4444-555555555555"},"json_body":{"description":"This is a test tag","name":"test-tag","privacy":"private"},"path_parameters":{"tag_id":"string"},"headers":{"X-Organization-ID":"11111111-2222-3333-4444-555555555555","accept":"application/json"}}` ### Output | **Parameter** | **Type** | **Description** | | -------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `result` | object | Result of the operation | | `result.created_at` | string | Result of the operation | | `result.created_by` | string | Result of the operation | | `result.description` | string | Result of the operation | | `result.id` | string | Unique identifier | | `result.name` | string | Name of the resource | | `result.privacy` | string | Result of the operation | | `result.updated_at` | string | Result of the operation | ### Output Example `{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"result":{"created_at":"2026-05-12T16:59:08.185Z","created_by":"3fa85f64-5717-4562-b3fc-2c963f66afa6","description":"string","id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","name":"string","privacy":"private","updated_at":"2026-05-12T16:59:08.185Z"}}}` # Response Headers | **Header** | **Description** | **Example** | | -------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | access-control-allow-credentials | HTTP response header: access-control-allow-credentials | true | | access-control-allow-headers | HTTP response header: access-control-allow-headers | DNT,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization | | access-control-allow-methods | HTTP response header: access-control-allow-methods | PUT, GET, POST, OPTIONS | | access-control-allow-origin | HTTP response header: access-control-allow-origin | \* | | access-control-max-age | HTTP response header: access-control-max-age | 1728000 | | CF-Cache-Status | HTTP response header: CF-Cache-Status | DYNAMIC | | CF-RAY | HTTP response header: CF-RAY | 9fa7b4243fe184bf-BOM | | Connection | HTTP response header: Connection | keep-alive | | Content-Encoding | HTTP response header: Content-Encoding | gzip | | Content-Type | The media type of the resource | application/vnd.censys.api.v3.host.v1+json | | Date | The date and time at which the message was originated | Tue, 12 May 2026 07:27:56 GMT | | Server | Information about the software used by the origin server | cloudflare | | Set-Cookie | HTTP response header: Set-Cookie | \_\_cf\_bm=iDDYryf\_kHBZTvrJd5J8a772B8.tU6ZRSDl5hqObgOw-1724304202-1.0.1.1-A.bu4qr6lcOiSBXy3LfPa.NJLWARde.rQrY9RGbfKg.ifaBxLQFGs9DctpecCvsIkGsKRHdG.f20prVDRTJTrQ; path=/; expires=Thu, 22-Aug-24 05:53:22 GMT; domain=.censys.io; HttpOnly; Secure; SameSite=None | | strict-transport-security | HTTP response header: strict-transport-security | max-age=2592000; includeSubDomains; preload | | Transfer-Encoding | HTTP response header: Transfer-Encoding | chunked | | x-content-type-options | HTTP response header: x-content-type-options | nosniff | | x-frame-options | HTTP response header: x-frame-options | DENY | | x-request-id | A unique identifier for the request | 159eb614-e35d-88ce-6083-445b30b47bfd |