components:
  schemas:
    Activemq:
      additionalProperties: false
      properties:
        cache_enabled:
          type: boolean
        cache_size:
          format: int32
          type: integer
        max_frame_size:
          format: int64
          type: integer
        max_inactivity_duration:
          format: int64
          type: integer
        max_inactivity_duration_initial_delay:
          format: int32
          type: integer
        platform_details:
          type: string
        provider_name:
          type: string
        provider_version:
          type: string
        size_prefix_disabled:
          type: boolean
        stack_trace_enabled:
          type: boolean
        tcp_no_delay_enabled:
          type: boolean
        tight_encoding_enabled:
          type: boolean
      type: object
    ActorInfo:
      additionalProperties: false
      properties:
        display_name:
          description: The human-readable name of a non-human actor, as of the time of the action. Set for service accounts, which have no email.
          type: string
        email:
          description: The email of the entity that performed the action. Only human actors have an email.
          type: string
        id:
          description: The ID of the entity that performed the action. This will depend on the type of entity, as it could be a Censys user ID, a service account ID, or an ASM workspace ID.
          type: string
        type:
          description: The type of entity that performed the action.
          enum:
            - unknown
            - user
            - system
            - customer_support
            - asm_workspace
            - service_account
          type: string
      required:
        - type
      type: object
    AdvisoryIdentity:
      additionalProperties: false
      properties:
        cve_ids:
          description: The CVE identifiers associated with the advisory. An advisory may have no CVE identifiers.
          items:
            type: string
          type: array
        id:
          description: The canonical security advisory identifier.
          type: string
        name:
          description: The advisory name, which may differ from the titles of its risk instances.
          type: string
        risk_query:
          description: The canonical query for the supply chain risk-instances endpoint. An empty value means no risk query is available; do not use it as an unfiltered query. This query selects risks rather than software or assets.
          type: string
      required:
        - id
        - name
        - cve_ids
        - risk_query
      type: object
    AlternativeQuery:
      additionalProperties: false
      properties:
        query:
          description: An alternative query that may be used.
          type: string
        targets:
          description: The types of Platform data records (host, cert, and web) that can be targeted by the alternative query.
          items:
            enum:
              - host
              - web
              - cert
              - unknown
            type: string
          type:
            - array
            - "null"
      required:
        - query
        - targets
      type: object
    Amqp:
      additionalProperties: false
      properties:
        explicit_tls:
          description: Connected via a TLS connection after initial handshake
          type: boolean
        implicit_tls:
          description: Connected via a TLS wrapped connection (AMQPS)
          type: boolean
        protocol_id:
          $ref: "#/components/schemas/Amqp_Protocol"
        version:
          $ref: "#/components/schemas/Amqp_Version"
      type: object
    Amqp_Protocol:
      additionalProperties: false
      properties:
        id:
          format: int32
          minimum: 0
          type: integer
        name:
          type: string
      type: object
    Amqp_Version:
      additionalProperties: false
      properties:
        major:
          format: int32
          minimum: 0
          type: integer
        minor:
          format: int32
          minimum: 0
          type: integer
        revision:
          format: int32
          minimum: 0
          type: integer
      type: object
    AnalyticsCapabilities:
      additionalProperties: false
      properties:
        analytics_module_support:
          type: boolean
        cell_based_scene_description_supported:
          type: boolean
        rule_options_supported:
          type: boolean
        rule_support:
          type: boolean
      type: object
    AnermaCfForth:
      additionalProperties: false
      properties:
        ip:
          type: string
        product:
          type: string
        serial_number:
          type: string
        unit_name:
          type: string
        version:
          type: string
      type: object
    AnyConnect:
      additionalProperties: false
      properties:
        aggregate_auth_version:
          description: Version number indicated by the response for config-auth exchange
          format: int32
          type: integer
        auth_methods:
          description: Supported methods for users to enter credentials for this VPN
          items:
            type: string
          type:
            - array
            - "null"
        groups:
          description: List of groups a user can authenticate with to use this VPN
          items:
            type: string
          type:
            - array
            - "null"
        raw:
          description: XML content of the config-auth response
          type: string
        response_type:
          description: Type of the response packet received after initializing the config-auth exchange
          type: string
      type: object
    Argocd:
      additionalProperties: false
      properties:
        anonymous_exposure:
          $ref: "#/components/schemas/Argocd_AnonymousExposure"
        settings:
          $ref: "#/components/schemas/Argocd_Settings"
        version:
          type: string
      type: object
    Argocd_AnonymousExposure:
      additionalProperties: false
      properties:
        application_count:
          format: int32
          type: integer
        applications_anonymously_readable:
          type: boolean
        cluster_count:
          format: int32
          type: integer
        clusters_anonymously_readable:
          type: boolean
      type: object
    Argocd_Settings:
      additionalProperties: false
      properties:
        apps_in_any_namespace_enabled:
          type: boolean
        exec_enabled:
          type: boolean
        impersonation_enabled:
          type: boolean
        installation_id:
          type: string
        oidc_config:
          $ref: "#/components/schemas/Argocd_Settings_OIDCConfig"
        sync_with_replace_allowed:
          type: boolean
        url:
          type: string
        user_logins_disabled:
          type: boolean
      type: object
    Argocd_Settings_OIDCConfig:
      additionalProperties: false
      properties:
        client_id:
          type: string
        issuer:
          type: string
      type: object
    AssetCertificateListInputBody:
      additionalProperties: false
      properties:
        certificate_ids:
          description: A list of SHA-256 certificate fingerprints.
          examples:
            - 3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf
          items:
            type: string
          maxItems: 1000
          minItems: 1
          type:
            - array
            - "null"
      required:
        - certificate_ids
      type: object
    AssetHostListInputBody:
      additionalProperties: false
      properties:
        at_time:
          description: RFC3339 Timestamp to view all requested hosts 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.
          examples:
            - "2025-01-01T00:00:00Z"
          format: date-time
          type: string
        host_ids:
          description: A list of host IP addresses.
          examples:
            - 8.8.8.8
          items:
            type: string
          maxItems: 100
          minItems: 1
          type:
            - array
            - "null"
      required:
        - host_ids
      type: object
    AssetWebpropertyListInputBody:
      additionalProperties: false
      properties:
        at_time:
          description: RFC3339 Timestamp to view all requested webproperties 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
          examples:
            - "2025-01-01T00:00:00Z"
          format: date-time
          type: string
        webproperty_ids:
          description: A list of web property identifiers.
          examples:
            - platform.censys.io:80
          items:
            type: string
          maxItems: 100
          minItems: 1
          type:
            - array
            - "null"
      required:
        - webproperty_ids
      type: object
    AsteriskManagerInterface:
      additionalProperties: false
      properties:
        version:
          type: string
      type: object
    AttackSurface:
      additionalProperties: false
      properties:
        created_at:
          description: When the attack surface was created.
          format: date-time
          type: string
        failed_asset_count:
          description: The number of added assets that Censys could not apply to the attack surface.
          format: int64
          type: integer
        id:
          description: The unique ID of the attack surface.
          examples:
            - 11111111-2222-3333-4444-555555555555
          format: uuid
          type: string
        pending_asset_count:
          description: The number of added assets that Censys has accepted but not yet applied to the attack surface.
          format: int64
          type: integer
        status:
          description: The state of the attack surface. 'populating' while Censys discovers its assets, 'active' once discovery has completed, and 'failed' if discovery did not complete. Omitted when the state cannot be determined.
          enum:
            - active
            - populating
            - failed
          type: string
        updated_at:
          description: When the attack surface was last updated.
          format: date-time
          type: string
      required:
        - id
        - pending_asset_count
        - failed_asset_count
      type: object
    AttackSurfaceAggregateBucket:
      additionalProperties: false
      properties:
        count:
          description: The number of matching documents with this field value, counted at the level set by count_by_level. By default that is the nested level of the field, so aggregating host.services.port counts services rather than hosts; set count_by_level to '.' to count hosts, web properties or certificates.
          format: int64
          type: integer
        key:
          description: The value of the aggregated field for this bucket.
          type: string
      required:
        - key
        - count
      type: object
    AttackSurfaceAggregateResponse:
      additionalProperties: false
      properties:
        buckets:
          description: The aggregated buckets, one per distinct field value.
          items:
            $ref: "#/components/schemas/AttackSurfaceAggregateBucket"
          type: array
        is_more_than_total_hits:
          description: Whether the number of matching assets exceeds the accurately tracked hit count, meaning total_count is a lower bound rather than an exact value.
          type: boolean
        other_count:
          description: The number of documents in buckets that were not returned, counted at the nested level of the field. This is a document count, not a number of distinct assets. It is always 0 when count_by_level counts at a different level than the field, so a 0 does not mean every bucket was returned.
          format: int64
          type: integer
        query_duration_millis:
          description: The time, in milliseconds, the query took to execute.
          format: int32
          type: integer
        total_count:
          description: The total number of assets matching the query.
          format: int64
          type: integer
      required:
        - total_count
        - other_count
        - query_duration_millis
        - is_more_than_total_hits
        - buckets
      type: object
    AttackSurfaceAsset:
      additionalProperties: false
      properties:
        asset:
          description: The asset, as an IP address, CIDR block, ASN, domain, or certificate SHA-256 fingerprint, in the form you would send to add it. Assets of the types web_property, registrant_organization, registrant_email, crunchbase_organization, and organization are shown by their name or identifier and cannot be named in a request.
          examples:
            - 8.8.8.0/24
          type: string
        type:
          description: The kind of entity the asset names. Only host, domain, certificate, netblock, and autonomous_system assets can be named in a request. Omitted when it cannot be determined.
          enum:
            - organization
            - host
            - domain
            - certificate
            - web_property
            - netblock
            - autonomous_system
            - registrant_organization
            - registrant_email
            - crunchbase_organization
          type: string
      required:
        - asset
      type: object
    AttackSurfaceAssetDecision:
      additionalProperties: false
      properties:
        decided_at:
          description: When the decision was made.
          format: date-time
          type: string
        pending:
          description: True when Censys has not yet applied the decision to the attack surface. A pending exclusion is why an asset that was excluded can still appear in results.
          type: boolean
        type:
          description: "'excluded' when an exclusion was added and the asset was removed from the attack surface, 'included' when an exclusion was withdrawn. Omitted when the outcome cannot be determined."
          enum:
            - excluded
            - included
          type: string
      required:
        - pending
      type: object
    AttackSurfaceAssets:
      additionalProperties: false
      properties:
        assets:
          description: The assets that were applied, in the form Censys resolved them to.
          items:
            $ref: "#/components/schemas/AttackSurfaceAsset"
          type:
            - array
            - "null"
      required:
        - assets
      type: object
    AttackSurfaceAssetsList:
      additionalProperties: false
      properties:
        assets:
          description: The assets on this page.
          items:
            $ref: "#/components/schemas/AttackSurfaceAsset"
          type:
            - array
            - "null"
        next_page_token:
          description: A token to pass as page_token to retrieve the next page. Omitted on the last page.
          type: string
      required:
        - assets
      type: object
    AttackSurfaceAssetsRequest:
      additionalProperties: false
      properties:
        assets:
          description: The assets, each an IP address, CIDR block, ASN, domain, or certificate SHA-256 fingerprint.
          examples:
            - - 8.8.8.8
              - censys.io
              - AS15169
              - 8.8.8.0/24
              - 9a1d0c3a7b6e4f5d8c2b1a0f9e8d7c6b5a4f3e2d1c0b9a8f7e6d5c4b3a291807
          items:
            type: string
          maxItems: 50
          minItems: 1
          type: array
      required:
        - assets
      type: object
    AttackSurfaceListRiskEventsResponse:
      additionalProperties: false
      properties:
        next_page_token:
          description: Pagination token for the next page of results. Omitted on the last page.
          type: string
        risk_events:
          description: Risk events in commit order, or in insert order when inserted_after_time is set.
          items:
            $ref: "#/components/schemas/AttackSurfaceRiskEvent"
          type: array
      required:
        - risk_events
      type: object
    AttackSurfaceRiskEvent:
      additionalProperties: false
      properties:
        change_type:
          description: The kind of change this event represents.
          enum:
            - opened
            - resolved
            - reopened
          type: string
        id:
          description: The unique ID of the event. Used to deduplicate events and, with inserted_at, to continue polling via inserted_after_time and inserted_after_event_id.
          type: string
        inserted_at:
          description: When this event was recorded in Censys. Differs from occurred_at, which is when the change occurred.
          format: date-time
          type: string
        occurred_at:
          description: When this change occurred.
          format: date-time
          type: string
        risk_instance:
          $ref: "#/components/schemas/AttackSurfaceRiskInstance"
          description: The risk instance as it was at the time of this change.
      required:
        - id
        - change_type
        - occurred_at
        - risk_instance
      type: object
    AttackSurfaceRiskInstance:
      additionalProperties: false
      properties:
        asset_type:
          description: Which asset type the locus fields describe, e.g. host or web.
          type: string
        confidence:
          description: Confidence that this finding is real, from 0 to 1.
          format: double
          type: number
        created_at:
          description: When the instance record was created in Censys.
          format: date-time
          type: string
        description:
          description: Description of this risk.
          type: string
        evidence:
          description: Evidence supporting the identification of this risk on this asset.
          type: string
        first_detected_at:
          description: When this risk instance was first observed.
          format: date-time
          type: string
        host:
          $ref: "#/components/schemas/AttackSurfaceRiskInstanceHost"
          description: The host this risk was observed on.
        id:
          description: Unique identifier of this risk instance.
          type: string
        last_detected_at:
          description: Most recent time this risk instance was observed.
          format: date-time
          type: string
        rapid_response:
          description: Whether this risk type was authored as a rapid response to an emerging threat.
          type: boolean
        remediations:
          description: Recommended remediation steps for this risk, in the order they should be applied.
          items:
            type: string
          type:
            - array
            - "null"
        resolve_reason:
          description: Why this risk instance resolved. Present only when status is closed.
          enum:
            - finding_removed
            - service_removed
            - web_property_removed
            - asset_removed
          type: string
        resolve_time:
          description: When this risk instance resolved. Present only when status is closed.
          format: date-time
          type: string
        risk_category:
          description: Category of this risk.
          enum:
            - VULNERABILITY
            - EXPOSURE
            - MISCONFIGURATION
            - THREAT
          type: string
        risk_name:
          description: Human-readable name of this risk, e.g. "Unencrypted HTTP Weak Auth".
          type: string
        risk_type_id:
          description: Risk identifier shared across every instance of this risk, e.g. a CVE ID or a Censys catalog ID.
          type: string
        score:
          description: Priority score from 0.0-10.0, derived from asset importance, severity, and exploitability.
          format: double
          type: number
        service:
          $ref: "#/components/schemas/AttackSurfaceRiskInstanceService"
          description: The network service this risk was observed on, set alongside host for service-scoped findings.
        severity:
          description: Severity of this risk.
          enum:
            - UNSPECIFIED
            - LOW
            - MEDIUM
            - HIGH
            - CRITICAL
          type: string
        status:
          description: "Status of this risk instance: open or closed."
          enum:
            - open
            - closed
          type: string
        tags:
          description: Tags applied to the parent asset as of when this risk was last observed.
          items:
            $ref: "#/components/schemas/SearchQueryTagInfo"
          type:
            - array
            - "null"
        web:
          $ref: "#/components/schemas/AttackSurfaceRiskInstanceWeb"
          description: The web property this risk was observed on.
      required:
        - id
        - asset_type
        - risk_type_id
        - risk_category
        - severity
        - risk_name
        - status
        - confidence
        - score
        - rapid_response
      type: object
    AttackSurfaceRiskInstanceHost:
      additionalProperties: false
      properties:
        ip:
          description: IP address of the host this risk was observed on.
          type: string
      required:
        - ip
      type: object
    AttackSurfaceRiskInstanceService:
      additionalProperties: false
      properties:
        port:
          description: Port the service runs on.
          format: int32
          minimum: 0
          type: integer
        protocol:
          description: Application protocol identified on the service, e.g. SSH, HTTP.
          type: string
        transport_protocol:
          description: Transport protocol of the service, e.g. TCP, UDP, ICMP, QUIC.
          type: string
      required:
        - transport_protocol
        - port
        - protocol
      type: object
    AttackSurfaceRiskInstanceWeb:
      additionalProperties: false
      properties:
        hostname:
          description: Hostname of the web property this risk was observed on.
          type: string
        port:
          description: Port of the web property this risk was observed on.
          format: int32
          minimum: 0
          type: integer
      required:
        - hostname
        - port
      type: object
    AttackSurfaceSearchAssetHit:
      additionalProperties: false
      properties:
        certificate_v1:
          $ref: "#/components/schemas/CertificateAsset"
          description: Set when the hit is a certificate.
        decision:
          $ref: "#/components/schemas/AttackSurfaceAssetDecision"
          description: The most recent manual exclusion decision covering this asset. Omitted when the asset has never been excluded.
        host_v1:
          $ref: "#/components/schemas/HostAssetWithMatchedServices"
          description: Set when the hit is a host. matched_services lists the services the query matched.
        risk:
          $ref: "#/components/schemas/AttackSurfaceRiskInstance"
          description: Set when the hit is a risk instance, i.e. the query references risk.* fields.
        tags:
          description: Tags applied to this asset.
          items:
            $ref: "#/components/schemas/SearchQueryTagInfo"
          type:
            - array
            - "null"
        webproperty_v1:
          $ref: "#/components/schemas/WebpropertyAsset"
          description: Set when the hit is a web property.
      type: object
    AttackSurfaceSearchAssetsResponse:
      additionalProperties: false
      properties:
        hits:
          description: Assets and risk instances matching the search.
          items:
            $ref: "#/components/schemas/AttackSurfaceSearchAssetHit"
          type:
            - array
            - "null"
        next_page_token:
          description: Pagination token for the next page of results. Omitted on the last page.
          type: string
        previous_page_token:
          description: Pagination token for the previous page of results. Omitted on the first page.
          type: string
        query_duration_millis:
          description: The amount of time, in milliseconds, the search took to run.
          format: int32
          type: integer
        total_hits:
          description: Total number of assets matching the search.
          format: int64
          type: integer
      required:
        - total_hits
        - query_duration_millis
        - hits
      type: object
    AttackSurfacesList:
      additionalProperties: false
      properties:
        attack_surfaces:
          description: The attack surfaces on this page.
          items:
            $ref: "#/components/schemas/AttackSurface"
          type:
            - array
            - "null"
        next_page_token:
          description: A token to pass as page_token to retrieve the next page. Omitted on the last page.
          type: string
      required:
        - attack_surfaces
      type: object
    Attribute:
      additionalProperties: false
      properties:
        components:
          items:
            $ref: "#/components/schemas/CPE"
          type:
            - array
            - "null"
        confidence:
          format: double
          type: number
        cpe:
          type: string
        edition:
          type: string
        evidence:
          items:
            $ref: "#/components/schemas/Evidence"
          type:
            - array
            - "null"
        life_cycle:
          $ref: "#/components/schemas/CPE_LifeCycle"
        part:
          type: string
        product:
          type: string
        source:
          enum:
            - ""
            - censys
            - recog
            - wappalyzer
            - third_party
            - html_meta_extractor
          type: string
        type:
          items:
            type: string
          type:
            - array
            - "null"
        update:
          type: string
        vendor:
          type: string
        version:
          type: string
      type: object
    AuditLogEvent:
      additionalProperties: false
      properties:
        actor:
          $ref: "#/components/schemas/ActorInfo"
          description: Information about the entity that performed the action.
        authentication_method:
          description: The method used by the actor to authenticate before performing the action.
          type: string
        event_type:
          description: The type of action that was audited.
          enum:
            - user_created
            - user_login
            - user_login_failed
            - user_password_changed
            - user_password_reset
            - user_mfa_changed
            - user_settings_changed
            - user_enabled
            - user_disabled
            - invitation_created
            - invitation_resent
            - invitation_accepted
            - invitation_deleted
            - membership_created
            - membership_updated
            - membership_removed
            - org_created
            - org_updated
            - org_deleted
            - saml_config_created
            - saml_config_updated
            - saml_config_deleted
            - saml_config_domain_verified
            - pat_created
            - pat_deleted
            - global_data_search_executed
            - global_data_lookup_executed
            - global_data_aggregation_executed
            - asm_seed_created
            - asm_seed_deleted
            - asm_exclude_created
            - asm_exclude_deleted
            - asm_risk_instance_severity_changed
            - asm_risk_instance_accepted
            - asm_risk_instance_unaccepted
            - asm_risk_type_severity_changed
            - asm_risk_type_enabled
            - asm_risk_type_disabled
            - asm_risk_type_default_enabled
            - tag_created
            - tag_updated
            - tag_deleted
            - tag_assigned
            - tag_unassigned
            - tag_bulk_operation_started
            - tag_bulk_operation_completed
            - tag_bulk_operation_cancelled
            - comment_created
            - comment_updated
            - comment_deleted
            - scim_token_generated
            - scim_token_revoked
            - scim_user_provisioned
            - scim_user_updated
            - scim_user_deprovisioned
            - module_assignment_granted
            - module_assignment_revoked
            - module_assignment_updated
            - service_account_created
            - service_account_secret_rotated
            - service_account_deleted
            - service_account_updated
          type: string
        metadata:
          additionalProperties: {}
          description: Event-specific metadata. Contents vary by event type.
          type: object
        source:
          description: Where the audited action originated from.
          type: string
        source_ip:
          description: The IP address of the source of the audited action.
          type: string
        subject:
          $ref: "#/components/schemas/SubjectInfo"
          description: Information about the resource that was affected by the audited action.
        timestamp:
          description: The timestamp of the audit log event.
          format: date-time
          type: string
        user_agent:
          description: The user agent of the source of the audited action.
          type: string
      required:
        - timestamp
        - event_type
        - actor
        - subject
      type: object
    AuditLogEventsResponse:
      additionalProperties: false
      properties:
        events:
          description: The page of audit log events for the requested filters and pagination parameters.
          items:
            $ref: "#/components/schemas/AuditLogEvent"
          type:
            - array
            - "null"
        pagination:
          $ref: "#/components/schemas/PaginationInfo"
          description: Pagination information for listing more events.
        total_results:
          format: int64
          type: integer
      required:
        - events
        - pagination
        - total_results
      type: object
    Auth:
      additionalProperties: false
      properties:
        enabled:
          type: boolean
      type: object
    AuthenticationError:
      additionalProperties: false
      properties:
        error:
          $ref: "#/components/schemas/AuthenticationErrorDetail"
          description: Detailed information about the authentication error
      type: object
    AuthenticationErrorDetail:
      additionalProperties: false
      properties:
        code:
          description: HTTP status code
          examples:
            - 401
          format: int64
          type: integer
        message:
          description: Human-readable message describing the error occurrence
          examples:
            - Access credentials are invalid
          type: string
        reason:
          description: Human-readable explanation of the underlying cause of the error
          examples:
            - Access token is not active
          type: string
        request:
          type: string
        status:
          description: HTTP status message associated with the error
          examples:
            - Unauthorized
          type: string
      type: object
    AuthorityInfoAccess:
      additionalProperties: false
      properties:
        issuer_urls:
          items:
            type: string
          type:
            - array
            - "null"
        ocsp_urls:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    AutoReplenishConfig:
      additionalProperties: false
      properties:
        amount:
          description: The amount of credits to replenish when auto-replenish is triggered.
          format: int64
          type: integer
        enabled:
          description: Whether the organization has auto-replenish enabled.
          type: boolean
        threshold:
          description: The threshold at which the organization's credit balance will be auto-replenished.
          format: int64
          type: integer
      required:
        - enabled
      type: object
    AutonomousSystem:
      additionalProperties: false
      properties:
        asn:
          description: The ASN (autonomous system number) of the host's autonomous system.
          format: int32
          minimum: 0
          type: integer
        bgp_prefix:
          description: The autonomous system's CIDR.
          type: string
        country_code:
          description: The autonomous system's two-letter ISO 3166-1 alpha-2 country code (US, CN, GB, RU, ...).
          type: string
        description:
          description: Brief description of the autonomous system.
          type: string
        name:
          description: The friendly name of the autonomous system.
          type: string
        organization:
          description: The name of the organization managning the autonomous system.
          type: string
      type: object
    Bacnet:
      additionalProperties: false
      properties:
        application_software_revision:
          type: string
        description:
          type: string
        firmware_revision:
          type: string
        instance_number:
          format: int32
          minimum: 0
          type: integer
        location:
          type: string
        model_name:
          type: string
        object_name:
          type: string
        vendor_id:
          format: int32
          minimum: 0
          type: integer
        vendor_name:
          type: string
      type: object
    BasicConstraints:
      additionalProperties: false
      properties:
        is_ca:
          description: Whether the certificate is permitted to sign other certificates.
          type: boolean
        max_path_len:
          description: When present, provides the maximum number of intermediate certificates that may follow this certificate in a trusted certification path.
          format: int32
          type: integer
      type: object
    BluemaxNuttcp:
      additionalProperties: false
      properties:
        version:
          type: string
      type: object
    BulkCreateTagAssignmentsInputBody:
      additionalProperties: false
      properties:
        max_assets:
          description: "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."
          format: int64
          minimum: 0
          type: integer
        query:
          description: A CenQL query identifying the assets to tag.
          type: string
      required:
        - query
      type: object
    BulkDeleteTagAssignmentsInputBody:
      additionalProperties: false
      properties:
        created_after:
          description: RFC3339 timestamp. Only delete assignments created after this time.
          format: date-time
          type: string
        created_before:
          description: RFC3339 timestamp. Only delete assignments created before this time.
          format: date-time
          type: string
      type: object
    CPE:
      additionalProperties: false
      properties:
        cpe:
          type: string
        edition:
          type: string
        life_cycle:
          $ref: "#/components/schemas/CPE_LifeCycle"
        part:
          type: string
        product:
          type: string
        update:
          type: string
        vendor:
          type: string
        version:
          type: string
      type: object
    CPE_LifeCycle:
      additionalProperties: false
      properties:
        end_of_life:
          type: boolean
        end_of_life_date:
          type: string
        release_date:
          type: string
      type: object
    CVSS:
      additionalProperties: false
      properties:
        components:
          $ref: "#/components/schemas/CVSS_Components"
          description: These metrics contribute to how a CVE is scored.
        score:
          description: Score of the vulnerability; 0.1 is the lowest, 10 is the maximum
          format: double
          type: number
        vector:
          description: The path, method, or scenario used to exploit the vulnerability. Each section represents components that contribute to the overall CVSS score.
          type: string
      type: object
    CVSS_Components:
      additionalProperties: false
      properties:
        attack_complexity:
          description: "Indicates conditions beyond the attacker’s control that must exist in order to exploit the vulnerability. The Attack Complexity metric is scored as either Low or High. There are two possible values: Low (L) – There are no specific pre-conditions required for exploitation, High (H) – The attacker must complete some number of preparatory steps in order to get access."
          enum:
            - ""
            - low
            - high
          type: string
        attack_vector:
          description: "Indicates the level of access required for an attacker to exploit the vulnerability. The Attack Vector metric is scored in one of four levels: Network (N) – Vulnerabilities with this rating are remotely exploitable, from one or more hops away, up to, and including, remote exploitation over the Internet, Adjacent (A) – A vulnerability with this rating requires network adjacency for exploitation. The attack must be launched from the same physical or logical network, Local (L) – Vulnerabilities with this rating are not exploitable over a network, Physical (P) – An attacker must physically interact with the target system."
          enum:
            - ""
            - network
            - adjacent
            - local
            - physical
          type: string
        availability:
          description: "If an attack renders information unavailable, such as when a system crashes or through a DDoS attack, availability is negatively impacted. Availability has three possible values: None (N) – There is no loss of availability, Low (L) – Availability might be intermittently limited, or performance might be negatively impacted, as a result of a successful attack, High (H) – There is a complete loss of availability of the impacted system or information."
          enum:
            - ""
            - none
            - low
            - high
          type: string
        confidentiality:
          description: "Refers to the disclosure of sensitive information to authorized and unauthorized users, with the goal being that only authorized users are able to access the target data. Confidentiality has three potential values: High (H) – The attacker has full access to all resources in the impacted system, including highly sensitive information such as encryption keys, Low (L) – The attacker has partial access to information, with no control over what, specifically, they are able to access, None (N) – No data is accessible to unauthorized users as a result of the exploit."
          enum:
            - ""
            - none
            - low
            - high
          type: string
        integrity:
          description: "Refers to whether the protected information has been tampered with or changed in any way. If there is no way for an attacker to alter the accuracy or completeness of the information, integrity has been maintained. Integrity has three values: None (N) – There is no loss of the integrity of any information, Low (L) – A limited amount of information might be tampered with or modified, but there is no serious impact on the protected system, High (H) – The attacker can modify any/all information on the target system, resulting in a complete loss of integrity."
          enum:
            - ""
            - none
            - low
            - high
          type: string
        privileges_required:
          description: "Describes the level of privileges or access an attacker must have before successful exploitation. There are three possible values: None (N) – There is no privilege or special access required to conduct the attack, Low (L) – The attacker requires basic, “user” level privileges to leverage the exploit, High (H) – Administrative or similar access privileges are required for successful attack."
          enum:
            - ""
            - none
            - low
            - high
          type: string
        scope:
          description: "Determines whether a vulnerability in one system or component can impact another system or component. If a vulnerability in a vulnerable component can affect a component which is in a different security scope than the vulnerable component, a scope change occurs. Scope has two possible ratings: Changed (C) – An exploited vulnerability can have a carry over impact on another system, Unchanged (U) – The exploited vulnerability is limited in damage to only the local security authority."
          enum:
            - ""
            - unchanged
            - changed
          type: string
        user_interaction:
          description: "Describes whether a user, other than the attacker, is required to do anything or participate in exploitation of the vulnerability. User interaction has two possible values: None (N) – No user interaction is required, Required (R) – A user must complete some steps for the exploit to succeed. For example, a user might be required to install some software."
          enum:
            - ""
            - none
            - required
          type: string
      type: object
    CVSSv4:
      additionalProperties: false
      properties:
        components:
          $ref: "#/components/schemas/CVSSv4_Components"
          description: These metrics contribute to how a CVE is scored.
        score:
          description: Score of the vulnerability; 0.1 is the lowest, 10 is the maximum
          format: double
          type: number
        vector:
          description: The path, method, or scenario used to exploit the vulnerability. Each section represents components that contribute to the overall CVSS score.
          type: string
      type: object
    CVSSv4_Components:
      additionalProperties: false
      properties:
        attack_complexity:
          description: "Indicates conditions beyond the attacker’s control that must exist in order to exploit the vulnerability. The Attack Complexity metric is scored as either Low or High. There are two possible values: Low (L) – There are no specific pre-conditions required for exploitation, High (H) – The attacker must complete some number of preparatory steps in order to get access."
          enum:
            - ""
            - low
            - high
          type: string
        attack_requirements:
          enum:
            - ""
            - none
            - present
          type: string
        attack_vector:
          description: "Indicates the level of access required for an attacker to exploit the vulnerability. The Attack Vector metric is scored in one of four levels: Network (N) – Vulnerabilities with this rating are remotely exploitable, from one or more hops away, up to, and including, remote exploitation over the Internet, Adjacent (A) – A vulnerability with this rating requires network adjacency for exploitation. The attack must be launched from the same physical or logical network, Local (L) – Vulnerabilities with this rating are not exploitable over a network, Physical (P) – An attacker must physically interact with the target system."
          enum:
            - ""
            - network
            - adjacent
            - local
            - physical
          type: string
        automatable:
          enum:
            - ""
            - "no"
            - "yes"
          type: string
        availability:
          description: "If an attack renders information unavailable, such as when a system crashes or through a DDoS attack, availability is negatively impacted. Availability has three possible values: None (N) – There is no loss of availability, Low (L) – Availability might be intermittently limited, or performance might be negatively impacted, as a result of a successful attack, High (H) – There is a complete loss of availability of the impacted system or information."
          enum:
            - ""
            - none
            - low
            - high
          type: string
        confidentiality:
          description: "Refers to the disclosure of sensitive information to authorized and unauthorized users, with the goal being that only authorized users are able to access the target data. Confidentiality has three potential values: High (H) – The attacker has full access to all resources in the impacted system, including highly sensitive information such as encryption keys, Low (L) – The attacker has partial access to information, with no control over what, specifically, they are able to access, None (N) – No data is accessible to unauthorized users as a result of the exploit."
          enum:
            - ""
            - none
            - low
            - high
          type: string
        integrity:
          description: "Refers to whether the protected information has been tampered with or changed in any way. If there is no way for an attacker to alter the accuracy or completeness of the information, integrity has been maintained. Integrity has three values: None (N) – There is no loss of the integrity of any information, Low (L) – A limited amount of information might be tampered with or modified, but there is no serious impact on the protected system, High (H) – The attacker can modify any/all information on the target system, resulting in a complete loss of integrity."
          enum:
            - ""
            - none
            - low
            - high
          type: string
        privileges_required:
          description: "Describes the level of privileges or access an attacker must have before successful exploitation. There are three possible values: None (N) – There is no privilege or special access required to conduct the attack, Low (L) – The attacker requires basic, “user” level privileges to leverage the exploit, High (H) – Administrative or similar access privileges are required for successful attack."
          enum:
            - ""
            - none
            - low
            - high
          type: string
        provider_urgency:
          enum:
            - ""
            - clear
            - green
            - amber
            - red
          type: string
        recovery:
          enum:
            - ""
            - automatic
            - user
            - irrecoverable
          type: string
        safety:
          enum:
            - ""
            - negligible
            - present
          type: string
        user_interaction:
          description: "Describes whether a user, other than the attacker, is required to do anything or participate in exploitation of the vulnerability. User interaction has two possible values: None (N) – No user interaction is required, Required (R) – A user must complete some steps for the exploit to succeed. For example, a user might be required to install some software."
          enum:
            - ""
            - none
            - required
          type: string
        value_density:
          enum:
            - ""
            - diffuse
            - concentrated
          type: string
        vulnerability_response_effort:
          enum:
            - ""
            - low
            - moderate
            - high
          type: string
      type: object
    CWE:
      additionalProperties: false
      properties:
        entry:
          description: A unique identifier associated with a class of a software or hardware weakness.
          type: string
      type: object
    CabfOrganizationId:
      additionalProperties: false
      properties:
        country:
          type: string
        reference:
          type: string
        scheme:
          type: string
        state:
          type: string
      type: object
    Capabilities:
      additionalProperties: false
      properties:
        analytics:
          $ref: "#/components/schemas/AnalyticsCapabilities"
        device:
          $ref: "#/components/schemas/DeviceCapabilities"
        device_io:
          $ref: "#/components/schemas/DeviceIOCapabilities"
        events:
          $ref: "#/components/schemas/EventsCapabilities"
        image:
          $ref: "#/components/schemas/ImageCapabilities"
        media:
          $ref: "#/components/schemas/MediaCapabilities"
        pan_tilt_zoom:
          $ref: "#/components/schemas/PanTiltZoomCapabilities"
        recording:
          $ref: "#/components/schemas/RecordingCapabilities"
        replay:
          $ref: "#/components/schemas/ReplayCapabilities"
        search:
          $ref: "#/components/schemas/SearchCapabilities"
      type: object
    CenseyeJob:
      additionalProperties: false
      properties:
        at_time:
          description: The point-in-time the asset data was evaluated at.
          format: date-time
          type: string
        create_time:
          description: When the job was created.
          format: date-time
          type: string
        delete_time:
          description: When the job and results will be deleted.
          format: date-time
          type: string
        error:
          description: Error message if the job failed.
          type: string
        job_id:
          description: Unique identifier of the job.
          examples:
            - 550e8400-e29b-41d4-a716-446655440000
          type: string
        result_count:
          description: Total number of result field-value pairs.
          examples:
            - 42
          format: int32
          minimum: 0
          type: integer
        state:
          description: Current state of the job.
          enum:
            - started
            - completed
            - failed
            - unknown
          examples:
            - completed
          type: string
        target:
          $ref: "#/components/schemas/CenseyeTarget"
          description: The asset that was analyzed.
        update_time:
          description: When the job was last updated.
          format: date-time
          type: string
      required:
        - job_id
        - target
        - state
      type: object
    CenseyeJobsListResponse:
      additionalProperties: false
      properties:
        jobs:
          description: List of CensEye jobs.
          items:
            $ref: "#/components/schemas/CenseyeJob"
          type:
            - array
            - "null"
        next_page_token:
          description: Token to retrieve the next page of jobs.
          type: string
      required:
        - jobs
      type: object
    CenseyeResult:
      additionalProperties: false
      properties:
        count:
          description: Number of matching documents for this field-value combination.
          format: double
          type: number
        field_value_pairs:
          description: The field-value pairs that were counted.
          items:
            $ref: "#/components/schemas/FieldValuePair"
          type:
            - array
            - "null"
      required:
        - count
        - field_value_pairs
      type: object
    CenseyeResultsResponse:
      additionalProperties: false
      properties:
        next_page_token:
          description: Token to retrieve the next page of results.
          type: string
        results:
          description: List of count results.
          items:
            $ref: "#/components/schemas/CenseyeResult"
          type:
            - array
            - "null"
      required:
        - results
      type: object
    CenseyeTarget:
      additionalProperties: false
      properties:
        certificate_id:
          description: SHA-256 fingerprint of the certificate to analyze.
          examples:
            - 3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf
          type: string
        host_id:
          description: IP address of the host to analyze.
          examples:
            - 8.8.8.8
          type: string
        webproperty_id:
          description: Web property identifier (hostname:port) to analyze.
          examples:
            - example.com:443
          type: string
      type: object
    Certificate:
      additionalProperties: false
      properties:
        added_at:
          description: When the certificate was added to the Censys dataset.
          type: string
        ct:
          $ref: "#/components/schemas/Ct"
        ever_seen_in_scan:
          description: Whether the certificate has ever been presented by a service during a scan.
          type: boolean
        fingerprint_md5:
          description: The MD-5 digest of the entire raw certificate. An identifier used by some systems.
          format: hex
          type: string
        fingerprint_sha1:
          description: The SHA-1 digest of the entire raw certificate. An identifier used by some systems.
          format: hex
          type: string
        fingerprint_sha256:
          description: The SHA-256 digest of the entire raw certificate. Its unique identifier, which Censys uses to index certificates records.
          format: hex
          type: string
        modified_at:
          description: When the certificate record was last modified.
          type: string
        names:
          description: All the names contained in the certificate from various fields.
          items:
            type: string
          type:
            - array
            - "null"
        parent_spki_fingerprint_sha256:
          description: "DEPRECATED: Use parent_spki_subject_fingerprint_sha256"
          format: hex
          type: string
        parent_spki_subject_fingerprint_sha256:
          description: The SHA-256 digest of the parent certificate's DER-encoded SubjectPublicKeyInfo concatenated with its Subject.
          format: hex
          type: string
        parse_status:
          enum:
            - ""
            - success
            - fail
            - corrupted
          type: string
        parsed:
          $ref: "#/components/schemas/Certificate_Parsed"
          description: A record containing all of the data parsed from the certificate.
        precert:
          description: "Whether the X.509 \"poison\" extension (OID: 1.3.6.1.4.1.11129.2.4.3) is marked critical, which prohibits the pre-certificate from being trusted."
          type: boolean
        revocation:
          $ref: "#/components/schemas/CertificateRevocation"
          description: A record containing revocation information, if the certificate has been revoked.
        revoked:
          description: Whether the certificate has been revoked before its expiry date by the issuer.
          type: boolean
        spki_fingerprint_sha256:
          description: "DEPRECATED: Use spki_subject_fingerprint_sha256"
          format: hex
          type: string
        spki_subject_fingerprint_sha256:
          description: The SHA-256 digest of the certificate's DER-encoded SubjectPublicKeyInfo concatenated with its Subject.
          format: hex
          type: string
        tbs_fingerprint_sha256:
          description: The SHA-256 digest of the unsigned certificate's contents.
          format: hex
          type: string
        tbs_no_ct_fingerprint_sha256:
          description: The SHA-256 digest of the unsigned certificate with the CT Poison extension removed, if present. This represents the shared contents of a certificate and its corresponding pre-certificate.
          format: hex
          type: string
        validated_at:
          description: When the certificate record's trust was last checked.
          type: string
        validation:
          $ref: "#/components/schemas/Validation"
          description: A record containing information from the maintainers of major root certificate stores related to their trust assessment.
        validation_level:
          description: The extent to which the certificate's issuer validated the identity of the entity requesting the certificate. Options include Domain validated (DV), Organization Validated (OV), or Extended Validation (EV).
          enum:
            - ""
            - dv
            - ov
            - ev
          type: string
        zlint:
          $ref: "#/components/schemas/ZLint"
          description: A record containing the results of linting the certificate for conformance to the X.509 standard using Zlint.
      type: object
    CertificateAsset:
      additionalProperties: false
      properties:
        extensions:
          additionalProperties: {}
          type: object
        resource:
          $ref: "#/components/schemas/Certificate"
      required:
        - resource
        - extensions
      type: object
    CertificateExtensions:
      additionalProperties: false
      properties:
        authority_info_access:
          $ref: "#/components/schemas/AuthorityInfoAccess"
          description: "The parsed id-pe-authorityInfoAccess extension (OID: 1.3.6.1.5.7.1.1). Only id-ad-caIssuers and id-ad-ocsp accessMethods are supported; others are omitted."
        authority_key_id:
          description: A key identifier, usually a digest of the DER-encoded SubjectPublicKeyInfo.
          format: hex
          type: string
        basic_constraints:
          $ref: "#/components/schemas/BasicConstraints"
          description: "The parsed id-ce-basicConstraints extension (OID: 2.5.29.19)."
        cabf_organization_id:
          $ref: "#/components/schemas/CabfOrganizationId"
          description: "CA/Browser Forum organization ID extensions (OID: 2.23.140.3.1)."
        certificate_policies:
          description: "The parsed id-ce-certificatePolicies extension (OID: 2.5.29.32)."
          items:
            $ref: "#/components/schemas/CertificatePolicy"
          type:
            - array
            - "null"
        crl_distribution_points:
          description: "The parsed id-ce-cRLDistributionPoints extension (OID: 2.5.29.31). Contents are a list of distributionPoint URLs; other distributionPoint types are omitted)."
          items:
            type: string
          type:
            - array
            - "null"
        ct_poison:
          description: "Whether the certificate possesses the pre-certificate \"poison\" extension (OID: 1.3.6.1.4.1.11129.2.4.3)."
          type: boolean
        extended_key_usage:
          $ref: "#/components/schemas/ExtendedKeyUsage"
          description: "The parsed id-ce-extKeyUsage extension (OID: 2.5.29.37)."
        issuer_alt_name:
          $ref: "#/components/schemas/GeneralNames"
          description: "The parsed id-ce-issuerAltName extension (OID: 2.5.29.18)."
        key_usage:
          $ref: "#/components/schemas/KeyUsage"
          description: "The parsed id-ce-keyUsage extension (OID: 2.5.29.15)."
        name_constraints:
          $ref: "#/components/schemas/NameConstraints"
          description: "The parsed id-ce-nameConstraints extension (OID: 2.5.29.30). Specifies a name space within which all child certificates' subject names MUST be located."
        qc_statements:
          $ref: "#/components/schemas/QcStatements"
        signed_certificate_timestamps:
          items:
            $ref: "#/components/schemas/SignedCertificateTimestamp"
          type:
            - array
            - "null"
        subject_alt_name:
          $ref: "#/components/schemas/GeneralNames"
          description: "The parsed id-ce-subjectAltName extension (OID: 2.5.29.17)."
        subject_key_id:
          description: A key identifier, usually a digest of the DER-encoded SubjectPublicKeyInfo..
          format: hex
          type: string
        tor_service_descriptors:
          items:
            $ref: "#/components/schemas/TorServiceDescriptor"
          type:
            - array
            - "null"
      type: object
    CertificatePolicy:
      additionalProperties: false
      properties:
        cps:
          items:
            type: string
          type:
            - array
            - "null"
        id:
          type: string
        user_notice:
          items:
            $ref: "#/components/schemas/UserNotice"
          type:
            - array
            - "null"
      type: object
    CertificateRevocation:
      additionalProperties: false
      properties:
        crl:
          $ref: "#/components/schemas/CertificateRevocation_RevocationInfo"
        ocsp:
          $ref: "#/components/schemas/CertificateRevocation_RevocationInfo"
      type: object
    CertificateRevocation_RevocationInfo:
      additionalProperties: false
      properties:
        next_update:
          type: string
        reason:
          description: An enumerated value indicating the issuer-supplied reason for the revocation.
          enum:
            - ""
            - unspecified
            - key_compromise
            - ca_compromise
            - affiliation_changed
            - superseded
            - cessation_of_operation
            - certificate_hold
            - remove_from_crl
            - privilege_withdrawn
            - aa_compromise
          type: string
        revocation_time:
          description: The issuer-supplied timestamp indicating when the certificate was revoked.
          type: string
        revoked:
          description: Whether the certificate has been revoked before its expiry date by the issuer.
          type: boolean
      type: object
    Certificate_Parsed:
      additionalProperties: false
      properties:
        extensions:
          $ref: "#/components/schemas/CertificateExtensions"
          description: A record containing parsed X.509 extensions that provide additional identification information or additional cryptographic capabilities.
        issuer:
          $ref: "#/components/schemas/DistinguishedName"
          description: A record containing the parsed contents of the issuer_dn.
        issuer_dn:
          description: Distinguished Name of the entity that has signed and issued the certificate.
          type: string
        ja4x:
          type: string
        redacted:
          type: boolean
        serial_number:
          description: Issuer-specific identifier of the certificate.
          type: string
        serial_number_hex:
          description: Issuer-specific identifier of the certificate, represented as hexadecimal.
          type: string
        signature:
          $ref: "#/components/schemas/Signature"
        subject:
          $ref: "#/components/schemas/DistinguishedName"
          description: A record containing the parsed contents of the subject_dn.
        subject_dn:
          description: Distinguished Name of the entity associated with the public key.
          type: string
        subject_key_info:
          $ref: "#/components/schemas/SubjectKeyInfo"
          description: Information about the certificate's public key.
        unknown_extensions:
          items:
            $ref: "#/components/schemas/Extension"
          type:
            - array
            - "null"
        validity_period:
          $ref: "#/components/schemas/ValidityPeriod"
          description: Information about the time for which the certificate is valid.
        version:
          format: int32
          type: integer
      type: object
    CheckpointTopology:
      additionalProperties: false
      properties:
        common_name:
          type: string
        organization:
          type: string
      type: object
    ChromeDevtools:
      additionalProperties: false
      properties:
        browser:
          type: string
        protocol_version:
          type: string
        targets:
          items:
            $ref: "#/components/schemas/ChromeDevtools_Target"
          type:
            - array
            - "null"
        user_agent:
          type: string
        v8_version:
          type: string
        webkit_version:
          type: string
      type: object
    ChromeDevtools_Target:
      additionalProperties: false
      properties:
        title:
          type: string
        type:
          type: string
        url:
          type: string
      type: object
    Chromecast:
      additionalProperties: false
      properties:
        applications:
          items:
            $ref: "#/components/schemas/Chromecast_Application"
          type:
            - array
            - "null"
        icon_url:
          format: utf8
          type: string
        is_active_input:
          type: boolean
        protocol_version:
          format: int32
          type: integer
        status_text:
          format: utf8
          type: string
        universal_app_id:
          format: utf8
          type: string
        volume:
          $ref: "#/components/schemas/Chromecast_Volume"
      type: object
    Chromecast_Application:
      additionalProperties: false
      properties:
        app_id:
          format: utf8
          type: string
        app_type:
          format: utf8
          type: string
        display_name:
          format: utf8
          type: string
        namespaces:
          items:
            $ref: "#/components/schemas/Chromecast_Namespace"
          type:
            - array
            - "null"
        session_id:
          format: utf8
          type: string
        transport_id:
          format: utf8
          type: string
      type: object
    Chromecast_Namespace:
      additionalProperties: false
      properties:
        name:
          format: utf8
          type: string
      type: object
    Chromecast_Volume:
      additionalProperties: false
      properties:
        control_type:
          format: utf8
          type: string
        level:
          format: float
          type: number
        muted:
          type: boolean
        step_interval:
          $ref: "#/components/schemas/FloatValue"
      type: object
    CiscoIpsla:
      additionalProperties: false
      properties:
        handshake:
          $ref: "#/components/schemas/CiscoIpsla_Handshake"
        measure_response:
          $ref: "#/components/schemas/CiscoIpsla_MeasureResponse"
      type: object
    CiscoIpsla_Handshake:
      additionalProperties: false
      properties:
        header:
          $ref: "#/components/schemas/CiscoIpsla_Handshake_Header"
        message:
          $ref: "#/components/schemas/CiscoIpsla_Handshake_Message"
      type: object
    CiscoIpsla_Handshake_Header:
      additionalProperties: false
      properties:
        length:
          format: int32
          minimum: 0
          type: integer
        seq:
          format: int32
          minimum: 0
          type: integer
        unknown:
          format: int32
          minimum: 0
          type: integer
        version:
          format: int32
          minimum: 0
          type: integer
      type: object
    CiscoIpsla_Handshake_Message:
      additionalProperties: false
      properties:
        ip:
          type: string
        length:
          format: int32
          minimum: 0
          type: integer
        port:
          format: int32
          minimum: 0
          type: integer
        type:
          format: int32
          minimum: 0
          type: integer
      type: object
    CiscoIpsla_MeasureResponse:
      additionalProperties: false
      properties:
        flags:
          format: int32
          minimum: 0
          type: integer
        payload:
          format: base64
          type: string
        receive_seq:
          format: int32
          minimum: 0
          type: integer
        receive_time:
          format: int64
          minimum: 0
          type: integer
        send_seq:
          format: int32
          minimum: 0
          type: integer
        send_time:
          format: int64
          minimum: 0
          type: integer
        type:
          format: int32
          minimum: 0
          type: integer
      type: object
    CiscoSdwanVdaemon:
      additionalProperties: false
      properties:
        device_role:
          type: string
        device_uuid:
          type: string
        organization_name:
          type: string
        site_id:
          format: int32
          minimum: 0
          type: integer
      type: object
    Clamav:
      additionalProperties: false
      properties:
        engine_version:
          type: string
        signature_date:
          type: string
        signature_version:
          format: int32
          minimum: 0
          type: integer
      type: object
    ClickHouseHttp:
      additionalProperties: false
      properties:
        databases:
          items:
            type: string
          type:
            - array
            - "null"
        databases_exposed:
          type: boolean
        display_name:
          type: string
        error:
          $ref: "#/components/schemas/ClickHouseHttp_Error"
        timezone:
          type: string
        version:
          type: string
      type: object
    ClickHouseHttp_Error:
      additionalProperties: false
      properties:
        code:
          type: string
        message:
          type: string
      type: object
    ClickHouseNative:
      additionalProperties: false
      properties:
        display_name:
          type: string
        error:
          $ref: "#/components/schemas/ClickHouseNative_Error"
        revision:
          format: int32
          type: integer
        server_name:
          type: string
        timezone:
          type: string
        version:
          type: string
        version_major:
          format: int32
          type: integer
        version_minor:
          format: int32
          type: integer
        version_patch:
          format: int32
          type: integer
      type: object
    ClickHouseNative_Error:
      additionalProperties: false
      properties:
        code:
          format: int32
          type: integer
        message:
          type: string
        name:
          type: string
      type: object
    Cmore:
      additionalProperties: false
      type: object
    CnordSecurityCenter:
      additionalProperties: false
      properties:
        events:
          items:
            $ref: "#/components/schemas/CnordSecurityCenter_Event"
          type:
            - array
            - "null"
        exposed_subscriber_records:
          format: int32
          minimum: 0
          type: integer
        header_generation:
          type: string
        license:
          type: string
        observed_frame_kinds:
          items:
            type: string
          type:
            - array
            - "null"
        record_message_types:
          items:
            format: int32
            minimum: 0
            type: integer
          type:
            - array
            - "null"
        station_name:
          type: string
      type: object
    CnordSecurityCenter_Event:
      additionalProperties: false
      properties:
        code:
          type: string
        description:
          type: string
        time:
          type: string
      type: object
    Coap:
      additionalProperties: false
      properties:
        code:
          type: string
        message_id:
          format: int32
          minimum: 0
          type: integer
        message_type:
          type: string
        payload:
          format: hex
          type: string
        token:
          format: hex
          type: string
        version:
          format: int32
          minimum: 0
          type: integer
      type: object
    CobaltStrike:
      additionalProperties: false
      properties:
        x64:
          $ref: "#/components/schemas/CobaltStrike_Config"
        x86:
          $ref: "#/components/schemas/CobaltStrike_Config"
      type: object
    CobaltStrike_Config:
      additionalProperties: false
      properties:
        cookie_beacon:
          format: int32
          minimum: 0
          type: integer
        crypto_scheme:
          format: int32
          minimum: 0
          type: integer
        dns:
          type: boolean
        host_header:
          format: utf8
          type: string
        http_get:
          $ref: "#/components/schemas/CobaltStrike_HttpConfig"
        http_post:
          $ref: "#/components/schemas/CobaltStrike_HttpConfig"
        jitter:
          format: int32
          minimum: 0
          type: integer
        killdate:
          format: int32
          minimum: 0
          type: integer
        post_ex:
          $ref: "#/components/schemas/CobaltStrike_PostEx"
        public_key:
          format: hex
          type: string
        sleep_time:
          format: int32
          minimum: 0
          type: integer
        ssl:
          type: boolean
        unknown_bytes:
          additionalProperties:
            type:
              - string
              - "null"
          format: base64
          type: object
        unknown_int:
          additionalProperties:
            format: int32
            minimum: 0
            type: integer
          type: object
        user_agent:
          format: utf8
          type: string
        watermark:
          format: int32
          minimum: 0
          type: integer
      type: object
    CobaltStrike_HttpConfig:
      additionalProperties: false
      properties:
        client:
          format: utf8
          type: string
        uri:
          format: utf8
          type: string
        verb:
          format: utf8
          type: string
      type: object
    CobaltStrike_PostEx:
      additionalProperties: false
      properties:
        x64:
          format: utf8
          type: string
        x86:
          format: utf8
          type: string
      type: object
    Collection:
      additionalProperties: false
      properties:
        added_assets_24_hours:
          format: int64
          type: integer
        create_time:
          format: date-time
          type: string
        created_by:
          description: The ID of the user or service account that created the collection.
          format: uuid
          type: string
        description:
          type: string
        id:
          type: string
        name:
          type: string
        privacy:
          description: Collection visibility. `private` collections are visible to their creator and organization admins. `shared` collections are also visible to all organization members. Only the creator and organization admins can edit a collection.
          enum:
            - private
            - shared
          type: string
        query:
          type: string
        removed_assets_24_hours:
          format: int64
          type: integer
        status:
          enum:
            - unspecified
            - populating
            - active
            - paused
            - archived
          type: string
        status_reason:
          enum:
            - unspecified
            - not_enough_credits
            - not_entitled
            - too_many_assets
            - manual
            - query_changed
            - initial
          type:
            - string
            - "null"
        total_assets:
          format: int64
          type: integer
      required:
        - id
        - name
        - description
        - query
        - total_assets
        - create_time
        - status
        - status_reason
        - added_assets_24_hours
        - removed_assets_24_hours
        - privacy
      type: object
    CollectionEvent:
      additionalProperties: false
      properties:
        asset_change:
          $ref: "#/components/schemas/EventAssetChange"
        status_change:
          $ref: "#/components/schemas/EventStatusChange"
      type: object
    CollectionEventsResponse:
      additionalProperties: false
      properties:
        events:
          items:
            $ref: "#/components/schemas/CollectionEvent"
          type:
            - array
            - "null"
        next_page:
          type: string
      required:
        - events
        - next_page
      type: object
    ComelitIcona:
      additionalProperties: false
      properties:
        message_type_name:
          type: string
      type: object
    Comment:
      additionalProperties: false
      properties:
        asset_id:
          description: The identifier of the commented asset (host IP, certificate SHA-256 fingerprint, or web property domain/IP:port).
          type: string
        asset_type:
          description: The inferred type of the asset.
          enum:
            - host
            - certificate
            - web_property
            - unknown
          type: string
        body:
          description: The comment body text.
          type: string
        created_at:
          description: RFC3339 timestamp when the comment was created.
          format: date-time
          type: string
        created_by:
          description: The user ID of the user who created the comment.
          format: uuid
          type: string
        id:
          description: The unique ID of the comment.
          format: uuid
          type: string
        platform_ref:
          description: A direct URL to the asset in the Censys platform.
          type: string
        updated_at:
          description: RFC3339 timestamp when the comment was last updated.
          format: date-time
          type: string
      required:
        - id
        - asset_id
        - asset_type
        - platform_ref
        - body
        - created_at
        - updated_at
        - created_by
      type: object
    CommentsList:
      additionalProperties: false
      properties:
        comments:
          description: The list of comments.
          items:
            $ref: "#/components/schemas/Comment"
          type:
            - array
            - "null"
        next_page_token:
          description: Token to retrieve the next page of results. Omitted when there are no more results.
          type: string
        total_size:
          description: Total number of comments matching the filters.
          format: int64
          type: integer
      required:
        - comments
        - total_size
      type: object
    Connection:
      additionalProperties: false
      properties:
        ahs_length:
          format: int32
          minimum: 0
          type: integer
        cmd_seq:
          format: int32
          minimum: 0
          type: integer
        isid:
          format: int64
          minimum: 0
          type: integer
        keyval_pairs:
          items:
            type: string
          type:
            - array
            - "null"
        max_new_cmds:
          format: int32
          minimum: 0
          type: integer
        status_seq:
          format: int32
          minimum: 0
          type: integer
        tsih:
          format: int64
          minimum: 0
          type: integer
        version_active:
          format: int32
          minimum: 0
          type: integer
        version_max:
          format: int32
          minimum: 0
          type: integer
      type: object
    Contact:
      additionalProperties: false
      properties:
        email:
          type: string
        handle:
          type: string
        name:
          type: string
      type: object
    ConvertQueryError:
      additionalProperties: false
      properties:
        message:
          description: The error message if the query could not be converted.
          type: string
      required:
        - message
      type: object
    Coordinates:
      additionalProperties: false
      properties:
        latitude:
          format: double
          type: number
        longitude:
          format: double
          type: number
      type: object
    CortexXdrP2P:
      additionalProperties: false
      properties:
        uuid:
          type: string
      type: object
    CountCondition:
      additionalProperties: false
      properties:
        field_value_pairs:
          description: Field-value pairs to count matches for. Must target fields from the same nested object and may contain at most 5 pairs per group.
          items:
            $ref: "#/components/schemas/FieldValuePair"
          type:
            - array
            - "null"
      required:
        - field_value_pairs
      type: object
    CreateCenseyeJobInputBody:
      additionalProperties: false
      properties:
        target:
          $ref: "#/components/schemas/CenseyeTarget"
          description: The asset to analyze. Exactly one of host_id, webproperty_id, or certificate_id must be set.
      required:
        - target
      type: object
    CreateCommentInputBody:
      additionalProperties: false
      properties:
        asset_id:
          description: The identifier of the asset (host IP, certificate SHA-256 fingerprint, or web property hostname:port).
          examples:
            - 8.8.8.8
            - 3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf
            - platform.censys.io:443
          type: string
        body:
          description: The comment body text.
          maxLength: 10000
          minLength: 1
          type: string
      required:
        - asset_id
        - body
      type: object
    CreateInvestigationFileInputBody:
      additionalProperties: false
      properties:
        content_type:
          description: "The media type of the file to upload. Send it bare: a type carrying parameters, such as a charset, is not accepted."
          enum:
            - application/pdf
            - text/html
            - text/csv
            - text/plain
            - image/png
            - image/jpeg
            - image/webp
          examples:
            - application/pdf
          type: string
        filename:
          description: The original name of the file. Used only as display metadata on the investigation; it does not affect where the file is stored.
          examples:
            - incident-report.pdf
          type: string
        size_bytes:
          description: The size of the file in bytes. The largest a single file may be is set by the service and can change; sending more returns an unprocessable entity response. The upload itself is limited independently, so understating this does not raise the limit.
          examples:
            - 1048576
          format: int64
          minimum: 1
          type: integer
      required:
        - content_type
        - size_bytes
      type: object
    CreateInvestigationJobInputBody:
      additionalProperties: false
      properties:
        end_time:
          description: End of the reported timeframe, as an RFC 3339 timestamp. Inclusive. Requires start_time and must not be before it. It may not be in the future; omit it to scope the investigation up to now. Equal bounds scope the investigation to that single instant.
          examples:
            - "2026-08-01T00:00:00Z"
          format: date-time
          type: string
        file_ids:
          description: Evidence files to investigate, identified by the file_id returned when each upload was prepared. The most that one investigation accepts is set by the service and can change. A file is meant for one investigation. A later job naming the same file is rejected, though as with a retried create, two requests sent at the same instant may both be accepted. An identifier that was never uploaded, or that belongs to someone else, returns an unprocessable entity response. May be omitted when indicators is supplied.
          examples:
            - - file_550e8400-e29b-41d4-a716-446655440000
          items:
            type: string
          minItems: 1
          type:
            - array
            - "null"
        indicators:
          description: The indicators to investigate. Can be IP addresses, domains, or host and port pairs. Each must be a single non-empty value. May be omitted when file_ids is provided. The maximum number of indicators you can submit is 100.
          examples:
            - - 1.1.1.1
              - example.com
          items:
            type: string
          minItems: 1
          type:
            - array
            - "null"
        start_time:
          description: Start of the reported timeframe to scope the investigation to, as an RFC 3339 timestamp. Inclusive, and must be in the past. Omit both start_time and end_time to investigate current data. Supplying start_time on its own scopes the investigation from that instant up to now, which is how an open-ended report is expressed.
          examples:
            - "2026-06-01T00:00:00Z"
          format: date-time
          type: string
      type: object
    CreateTagAssignmentInputBody:
      additionalProperties: false
      properties:
        asset_id:
          description: The identifier of the asset (host IP, certificate SHA-256 fingerprint, or web property hostname:port).
          examples:
            - 8.8.8.8
            - 3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf
            - platform.censys.io:443
          type: string
      required:
        - asset_id
      type: object
    CreateTagInputBody:
      additionalProperties: false
      properties:
        description:
          description: A human-readable description of the tag.
          maxLength: 1000
          type: string
        name:
          description: The display name of the tag. Must be unique within the organization.
          maxLength: 255
          minLength: 1
          type: string
        privacy:
          description: 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.
          enum:
            - private
            - shared
          type: string
      required:
        - name
        - privacy
      type: object
    CreatedInvestigationJob:
      additionalProperties: false
      properties:
        complete_time:
          description: When the investigation finished. Omitted while it is still running.
          format: date-time
          type: string
        create_time:
          description: When the investigation was started.
          format: date-time
          type: string
        end_time:
          description: End of the reported timeframe, echoed from the request that started it. Omitted when the request left it open, in which case the investigation was scoped up to the moment it started. The investigation does not store it, so it is returned only here and never by a later read.
          format: date-time
          type: string
        expire_time:
          description: When the investigation and its results stop being available for download.
          format: date-time
          type: string
        job_id:
          description: The unique identifier of the investigation.
          examples:
            - 550e8400-e29b-41d4-a716-446655440000
          format: uuid
          type: string
        start_time:
          description: Start of the reported timeframe this investigation was scoped to, echoed from the request that started it. Omitted when the investigation uses current data. The investigation does not store it, so it is returned only here and never by a later read.
          format: date-time
          type: string
        state:
          description: The current state of the investigation. Completed means the investigation succeeded, not that its results are still available to download, and unknown means only that this API is older than the state the service reported.
          enum:
            - started
            - completed
            - failed
            - unknown
          examples:
            - completed
          type: string
        title:
          description: A short description of what the investigation looked into. Omitted when the investigation has no title yet.
          type: string
      required:
        - job_id
        - state
        - create_time
      type: object
    CreditExpiration:
      additionalProperties: false
      properties:
        balance:
          description: The current balance of the credit expiration.
          format: int64
          type: integer
        created_at:
          description: The date and time the credit expiration was created.
          format: date-time
          type: string
        expires_at:
          description: The date and time the credit expiration will expire.
          format: date-time
          type: string
        initial_balance:
          description: The initial balance of the credit expiration (i.e. how much was purchased).
          format: int64
          type: integer
      required:
        - balance
        - initial_balance
      type: object
    CreditUsageReport:
      additionalProperties: false
      properties:
        credits_consumed_by_consumer:
          additionalProperties:
            description: The number of credits consumed by this consumer. The key is the user's email when known, otherwise the user UUID.
            format: int64
            minimum: 0
            type: integer
          description: The breakdown of credits consumed by consumer. This may not be present if the report is generated for a specific user.
          examples:
            - user@example.com: 3000
          type: object
        credits_consumed_by_source:
          $ref: "#/components/schemas/SourceUsageBreakdown"
          description: The breakdown of credits consumed by source.
        end_time:
          description: The end time of the window for this report.
          format: date-time
          type: string
        granularity:
          default: daily
          description: The granularity of the report.
          enum:
            - daily
            - monthly
          examples:
            - daily
          type: string
        periods:
          description: The periods of the report (i.e. time buckets).
          items:
            $ref: "#/components/schemas/CreditUsageReportPeriod"
          type:
            - array
            - "null"
        start_time:
          description: The start time of the window for this report.
          format: date-time
          type: string
        total_added:
          description: The total amount of credits added during the report period.
          format: int64
          type: integer
        total_consumed:
          description: The total amount of credits consumed during the report period.
          format: int64
          type: integer
        total_expired:
          description: The total amount of credits expired during the report period.
          format: int64
          type: integer
        transaction_count:
          description: The total number of transactions during the report period.
          format: int64
          type: integer
      required:
        - start_time
        - end_time
        - granularity
        - total_consumed
        - total_added
        - total_expired
        - transaction_count
        - periods
        - credits_consumed_by_source
      type: object
    CreditUsageReportPeriod:
      additionalProperties: false
      properties:
        credits_added:
          description: The total amount of credits added during the report period.
          format: int64
          type: integer
        credits_consumed:
          description: The total amount of credits consumed during the report period.
          format: int64
          type: integer
        credits_expired:
          description: The total amount of credits expired during the report period.
          format: int64
          type: integer
        end_date:
          description: The end date of the window for this report period.
          format: date-time
          type: string
        start_date:
          description: The start date of the window for this report period.
          format: date-time
          type: string
        transaction_count:
          description: The total number of transactions during the report period.
          format: int64
          type: integer
      required:
        - start_date
        - end_date
        - credits_consumed
        - credits_added
        - credits_expired
        - transaction_count
      type: object
    CrestronCp3:
      additionalProperties: false
      properties:
        version_string:
          type: string
      type: object
    CrestronDinAp2:
      additionalProperties: false
      properties:
        version_string:
          type: string
      type: object
    CrudCreateInputBody:
      additionalProperties: false
      properties:
        description:
          description: description of the collection
          examples:
            - Hosts with services with AsyncRAT indicator in cert subject DN
          type: string
        name:
          description: name of the collection
          examples:
            - Hosts services with AsyncRAT indicator
          type: string
        privacy:
          default: private
          description: Collection visibility. `private` collections are visible to their creator and organization admins. `shared` collections are also visible to all organization members. Only the creator and organization admins can edit a collection.
          enum:
            - private
            - shared
          type: string
        query:
          description: query string to search upon to build the collection
          examples:
            - "host.services.cert.parsed.subject_dn: \"asyncrat\""
          type: string
      required:
        - name
        - query
      type: object
    CrudUpdateInputBody:
      additionalProperties: false
      properties:
        description:
          description: description of the collection
          examples:
            - Hosts with services with AsyncRAT indicator in cert subject DN
          type: string
        name:
          description: name of the collection
          examples:
            - Hosts services with AsyncRAT indicator
          type: string
        privacy:
          description: Collection visibility. `private` collections are visible to their creator and organization admins. `shared` collections are also visible to all organization members. Only the creator and organization admins can edit a collection.
          enum:
            - private
            - shared
          type: string
        query:
          description: query string to search upon to build the collection
          examples:
            - "host.services.cert.parsed.subject_dn: \"asyncrat\""
          type: string
      required:
        - name
        - query
      type: object
    CryptSetup:
      additionalProperties: false
      properties:
        client_nonce:
          format: base64
          type: string
        key:
          format: base64
          type: string
        server_nonce:
          format: base64
          type: string
      type: object
    Ct:
      additionalProperties: false
      properties:
        entries:
          additionalProperties:
            $ref: "#/components/schemas/Ct_Record"
          type: object
      type: object
    Ct_Record:
      additionalProperties: false
      properties:
        added_to_ct_at:
          description: An RFC-3339-formatted timestamp indicating when the certificate was entered into the CT log.
          type: string
        ct_to_censys_at:
          description: An RFC-3339-formated timestamp indicating when the certificate was ingested from the CT log into the Censys dataset.
          type: string
        index:
          description: Numerical marker of the certificate's place in the CT log.
          format: int64
          type: integer
      type: object
    CursorOnTarget:
      additionalProperties: false
      properties:
        events:
          items:
            $ref: "#/components/schemas/CursorOnTarget_Event"
          type:
            - array
            - "null"
      type: object
    CursorOnTarget_Event:
      additionalProperties: false
      properties:
        callsign:
          type: string
        endpoint:
          type: string
        how:
          type: string
        point:
          $ref: "#/components/schemas/CursorOnTarget_Point"
        stale:
          type: string
        start:
          type: string
        status:
          $ref: "#/components/schemas/CursorOnTarget_Status"
        takv:
          $ref: "#/components/schemas/CursorOnTarget_Takv"
        time:
          type: string
        type:
          type: string
        uid:
          type: string
        version:
          type: string
        video_url:
          type: string
      type: object
    CursorOnTarget_Point:
      additionalProperties: false
      properties:
        ce:
          format: double
          type: number
        hae:
          format: double
          type: number
        lat:
          format: double
          type: number
        le:
          format: double
          type: number
        lon:
          format: double
          type: number
      type: object
    CursorOnTarget_Status:
      additionalProperties: false
      properties:
        battery:
          type: string
      type: object
    CursorOnTarget_Takv:
      additionalProperties: false
      properties:
        device:
          type: string
        os:
          type: string
        platform:
          type: string
        version:
          type: string
      type: object
    Cwmp:
      additionalProperties: false
      properties:
        auth:
          items:
            type: string
          type:
            - array
            - "null"
        cookies:
          items:
            type: string
          type:
            - array
            - "null"
        server:
          type: string
      type: object
    DSACryptographicKey:
      additionalProperties: false
      properties:
        g:
          format: base64
          type: string
        p:
          format: base64
          type: string
        q:
          format: base64
          type: string
        "y":
          format: base64
          type: string
      type: object
    Darkcomet:
      additionalProperties: false
      properties:
        version:
          type: string
      type: object
    Darkgate:
      additionalProperties: false
      properties:
        files:
          items:
            $ref: "#/components/schemas/Darkgate_File"
          type:
            - array
            - "null"
      type: object
    Darkgate_File:
      additionalProperties: false
      properties:
        length:
          format: int32
          type: integer
        name:
          type: string
      type: object
    Dcerpc:
      additionalProperties: false
      properties:
        could_bind:
          type: boolean
        could_query_epm:
          type: boolean
        endpoints:
          items:
            $ref: "#/components/schemas/Dcerpc_Endpoint"
          type:
            - array
            - "null"
      type: object
    Dcerpc_Endpoint:
      additionalProperties: false
      properties:
        bindings:
          items:
            type: string
          type:
            - array
            - "null"
        executable:
          type: string
        explained_uuid:
          type: string
        protocol:
          type: string
      type: object
    DenonHeos:
      additionalProperties: false
      properties:
        mac_address:
          type: string
      type: object
    DesktopInfo:
      additionalProperties: false
      properties:
        height:
          format: int32
          minimum: 0
          type: integer
        name_len:
          format: int32
          minimum: 0
          type: integer
        pixel_format:
          $ref: "#/components/schemas/PixelFormat"
        width:
          format: int32
          minimum: 0
          type: integer
      type: object
    DeviceCapabilities:
      additionalProperties: false
      properties:
        network:
          $ref: "#/components/schemas/NetworkCapabilities"
        security:
          $ref: "#/components/schemas/SecurityCapabilities"
        system:
          $ref: "#/components/schemas/SystemCapabilities"
      type: object
    DeviceIOCapabilities:
      additionalProperties: false
      properties:
        audio_outputs:
          format: int32
          minimum: 0
          type: integer
        audio_sources:
          format: int32
          minimum: 0
          type: integer
        digital_inputs:
          format: int32
          minimum: 0
          type: integer
        relay_outputs:
          format: int32
          minimum: 0
          type: integer
        serial_ports:
          format: int32
          minimum: 0
          type: integer
        video_outputs:
          format: int32
          minimum: 0
          type: integer
        video_source:
          format: int32
          minimum: 0
          type: integer
      type: object
    Dhcpdiscover:
      additionalProperties: false
      properties:
        method:
          type: string
        params:
          $ref: "#/components/schemas/Dhcpdiscover_ResponseParams"
      type: object
    Dhcpdiscover_DeviceInfo:
      additionalProperties: false
      properties:
        alarm_input_channels:
          format: int64
          type: integer
        alarm_output_channels:
          format: int64
          type: integer
        device_class:
          type: string
        device_id:
          type: string
        device_type:
          type: string
        http_port:
          format: int64
          type: integer
        ipv4_address:
          $ref: "#/components/schemas/Dhcpdiscover_IpAddress"
        ipv6_address:
          $ref: "#/components/schemas/Dhcpdiscover_IpAddress"
        machine_group:
          type: string
        machine_name:
          type: string
        manufacturer:
          type: string
        port:
          format: int64
          type: integer
        remote_video_input_channels:
          format: int64
          type: integer
        serial_number:
          type: string
        unlogin_func_mask:
          format: int64
          type: integer
        vendor:
          type: string
        version:
          type: string
        video_input_channels:
          format: int64
          type: integer
        video_output_channels:
          format: int64
          type: integer
      type: object
    Dhcpdiscover_IpAddress:
      additionalProperties: false
      properties:
        default_gateway:
          type: string
        dhcp_enable:
          type: boolean
        ip_address:
          type: string
        link_local_address:
          type: string
        subnetmask:
          type: string
      type: object
    Dhcpdiscover_ResponseParams:
      additionalProperties: false
      properties:
        device_info:
          $ref: "#/components/schemas/Dhcpdiscover_DeviceInfo"
      type: object
    Dicom:
      additionalProperties: false
      properties:
        a_abort:
          $ref: "#/components/schemas/Dicom_AAbort"
        associate_ac:
          $ref: "#/components/schemas/Dicom_AssociateAc"
        associate_rj:
          $ref: "#/components/schemas/Dicom_AssociateRj"
        pdu_type_name:
          type: string
      type: object
    Dicom_AAbort:
      additionalProperties: false
      properties:
        reason_name:
          type: string
        source_name:
          type: string
      type: object
    Dicom_AssociateAc:
      additionalProperties: false
      properties:
        implementation_class_uid:
          type: string
        implementation_version_name:
          type: string
      type: object
    Dicom_AssociateRj:
      additionalProperties: false
      properties:
        reason_name:
          type: string
        result_name:
          type: string
        source_name:
          type: string
      type: object
    DistinguishedName:
      additionalProperties: false
      properties:
        common_name:
          description: "The commonName (CN) elements of the Distinguished Name (OID: 2.5.4.3)."
          items:
            type: string
          type:
            - array
            - "null"
        country:
          description: "The countryName (C) elements of the Distinguished Name (OID: 2.5.4.6)."
          items:
            type: string
          type:
            - array
            - "null"
        domain_component:
          description: "The domainComponent (DC) elements of the Distinguished Name (OID: 0.9.2342.19200300.100.1.25)."
          items:
            type: string
          type:
            - array
            - "null"
        email_address:
          description: "The emailAddress (E) elements of the Distinguished Name (OID: 1.2.840.113549.1.9.1)."
          items:
            type: string
          type:
            - array
            - "null"
        given_name:
          description: "The givenName (G) elements of the Distinguished Name (OID: 2.5.4.42)."
          items:
            type: string
          type:
            - array
            - "null"
        jurisdiction_country:
          description: "The jurisdictionCountry elements of the Distinguished Name (OID: 1.3.6.1.4.1.311.60.2.1.3)."
          items:
            type: string
          type:
            - array
            - "null"
        jurisdiction_locality:
          description: "The jurisdictionLocality elements of the Distinguished Name (OID: 1.3.6.1.4.1.311.60.2.1.1)."
          items:
            type: string
          type:
            - array
            - "null"
        jurisdiction_province:
          description: "The jurisdictionStateOrProvince elements of the Distinguished Name (OID: 1.3.6.1.4.1.311.60.2.1.2)."
          items:
            type: string
          type:
            - array
            - "null"
        locality:
          description: "The localityName (L) elements of the Distinguished Name (OID: 2.5.4.7)."
          items:
            type: string
          type:
            - array
            - "null"
        organization:
          description: "The organizationName (O) elements of the Distinguished Name (OID: 2.5.4.10)."
          items:
            type: string
          type:
            - array
            - "null"
        organization_id:
          items:
            type: string
          type:
            - array
            - "null"
        organizational_unit:
          description: "The organizationalUnit (OU) elements of the Distinguished Name (OID: 2.5.4.11)."
          items:
            type: string
          type:
            - array
            - "null"
        postal_code:
          description: "The postalCode elements of the Distinguished Name (OID: 2.5.4.17)."
          items:
            type: string
          type:
            - array
            - "null"
        province:
          description: "The stateOrProvinceName (ST) elements of the Distinguished Name (OID: 2.5.4.8)."
          items:
            type: string
          type:
            - array
            - "null"
        serial_number:
          description: "The serialNumber elements of the Distinguished Name (OID: 2.5.4.5)."
          items:
            type: string
          type:
            - array
            - "null"
        street_address:
          description: "The streetAddress (STREET) elements of the Distinguished Name (OID: 2.5.4.9)."
          items:
            type: string
          type:
            - array
            - "null"
        surname:
          description: "The surname (SN) elements of the Distinguished Name (OID: 2.5.4.4)."
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    Dlt:
      additionalProperties: false
      properties:
        application_id:
          type: string
        context_id:
          type: string
        ecu_id:
          type: string
        htyp_flags:
          items:
            type: string
          type:
            - array
            - "null"
        message_type_info_name:
          type: string
        message_type_name:
          type: string
        verbose:
          type: boolean
      type: object
    Dnp3:
      additionalProperties: false
      type: object
    Dns:
      additionalProperties: false
      properties:
        additionals:
          description: A list of resource records (RRs) contained in the ADDITIONAL section of the response.
          items:
            $ref: "#/components/schemas/Dns_ResourceRecord"
          type:
            - array
            - "null"
        answers:
          description: A list of resource records (RRs) contained in the ANSWER section of the response.
          items:
            $ref: "#/components/schemas/Dns_ResourceRecord"
          type:
            - array
            - "null"
        authorities:
          description: A list of resource records (RRs) contained in the AUTHORITIES section of the response.
          items:
            $ref: "#/components/schemas/Dns_ResourceRecord"
          type:
            - array
            - "null"
        edns:
          $ref: "#/components/schemas/Dns_EDns"
        questions:
          description: A list of resource records (RRs) contained in the QUESTION section of the response, which may echo the request that the server is responding to.
          items:
            $ref: "#/components/schemas/Dns_ResourceRecord"
          type:
            - array
            - "null"
        r_code:
          description: A enumerated field indicating the result of the request. The most common values are defined in RFC 1035.
          enum:
            - ""
            - success
            - format_error
            - server_failure
            - name_error
            - not_implemented
            - refused
            - yx_domain
            - yx_rrset
            - nx_rrset
            - not_auth
            - not_zone
            - bad_sig
            - bad_key
            - bad_time
            - bad_mode
            - bad_name
            - bad_alg
            - bad_trunc
            - bad_cookie
          type: string
        resolves_correctly:
          description: Whether the server returns an IP address for ip.parrotdns.com that matches the authoritative server, which is controlled by Censys.
          type: boolean
        server_type:
          description: An enumerated value indicating the behavior of the server. An AUTHORITATIVE server fulfills requests for domain names it controls, which are not listed by the server. FORWARDING and RECURSIVE_RESOLVER servers fulfill requests indirectly for domain names they do not control. A RECURSIVE_RESOLVER will query ip.parrotdns.com itself, resulting in its own IP address being present in the dns.answers.response field.
          enum:
            - ""
            - recursive_resolver
            - authoritative
            - forwarding
            - redirecting
          type: string
        version:
          type: string
      type: object
    DnsIpResolutionBoundResponse:
      additionalProperties: false
      properties:
        ip:
          description: The IP address that was queried.
          type: string
        next_page_token:
          description: A token that can be used to retrieve the next page of records.
          type: string
        records:
          description: The list of domain names that resolved to this IP.
          items:
            $ref: "#/components/schemas/DnsIpResolutionRecord"
          type:
            - array
            - "null"
        total_records:
          description: The number of records that exist in total across all pages.
          format: int64
          type: integer
      required:
        - ip
        - next_page_token
        - records
        - total_records
      type: object
    DnsIpResolutionRangeRecord:
      additionalProperties: false
      properties:
        domain:
          description: The domain name that resolved to this IP.
          type: string
        first_seen:
          description: The time this record was first observed.
          format: date-time
          type: string
        last_seen:
          description: The time this record was last observed.
          format: date-time
          type: string
        record_type:
          description: Either A or AAAA.
          enum:
            - A
            - AAAA
          type: string
      required:
        - domain
        - first_seen
        - last_seen
        - record_type
      type: object
    DnsIpResolutionRangeResponse:
      additionalProperties: false
      properties:
        ip:
          description: The IP address that was queried.
          type: string
        next_page_token:
          description: A token that can be used to retrieve the next page of records.
          type: string
        records:
          description: The list of domain names that resolved to this IP.
          items:
            $ref: "#/components/schemas/DnsIpResolutionRangeRecord"
          type:
            - array
            - "null"
        total_records:
          description: The number of records that exist in total across all pages.
          format: int64
          type: integer
      required:
        - ip
        - next_page_token
        - records
        - total_records
      type: object
    DnsIpResolutionRecord:
      additionalProperties: false
      properties:
        domain:
          description: The domain name that resolved to this IP.
          type: string
        first_seen:
          description: The time this record was first observed.
          format: date-time
          type: string
        last_seen:
          description: The time this record was last observed.
          format: date-time
          type: string
        record_type:
          description: Either A or AAAA.
          enum:
            - A
            - AAAA
          type: string
      required:
        - domain
        - first_seen
        - last_seen
        - record_type
      type: object
    DnsNameResolutionBoundResponse:
      additionalProperties: false
      properties:
        name:
          description: The domain name that was queried.
          type: string
        next_page_token:
          description: A token that can be used to retrieve the next page of records.
          type: string
        records:
          description: The list of DNS records.
          items:
            $ref: "#/components/schemas/DnsResolutionRecord"
          type:
            - array
            - "null"
        total_records:
          description: The number of records that exist in total across all pages.
          format: int64
          type: integer
      required:
        - name
        - next_page_token
        - records
        - total_records
      type: object
    DnsNameResolutionRangeResponse:
      additionalProperties: false
      properties:
        name:
          description: The domain name that was queried.
          type: string
        next_page_token:
          description: A token that can be used to retrieve the next page of records.
          type: string
        records:
          description: The list of DNS observation windows.
          items:
            $ref: "#/components/schemas/DnsResolutionRangeRecord"
          type:
            - array
            - "null"
        total_records:
          description: The number of records that exist in total across all pages.
          format: int64
          type: integer
      required:
        - name
        - next_page_token
        - records
        - total_records
      type: object
    DnsResolutionRangeRecord:
      additionalProperties: false
      properties:
        first_observed:
          description: When this record was first observed in this window.
          format: date-time
          type: string
        ip:
          description: The IP of the record. IPv4 if the record_type is A. IPv6 if the record_type is AAAA. Otherwise not present.
          type: string
        last_observed:
          description: When this record was last observed in this window.
          format: date-time
          type: string
        mail_server:
          description: The MX mail server. Only present when record_type is MX. Otherwise not present.
          type: string
        mname:
          description: The primary name server. Only present when record_type is SOA. Otherwise not present.
          type: string
        name_server:
          description: The name server. Only present when record_type is NS. Otherwise not present.
          type: string
        priority:
          description: The MX priority. Only present when record_type is MX. Otherwise not present.
          format: int64
          type: integer
        record_type:
          description: The record type. Either A, AAAA, MX, NS, SOA, or TXT.
          enum:
            - A
            - AAAA
            - MX
            - NS
            - SOA
            - TXT
          type: string
        rname:
          description: The responsible contact, as email. Only present when record_type is SOA. Otherwise not present.
          type: string
        value:
          description: Full, untruncated string. Only present when record_type is TXT. Otherwise not present.
          type: string
      required:
        - first_observed
        - last_observed
        - record_type
      type: object
    DnsResolutionRecord:
      additionalProperties: false
      properties:
        first_seen:
          description: The time this record was first observed.
          format: date-time
          type: string
        ip:
          description: The IP of the record. IPv4 if the record_type is A. IPv6 if the record_type is AAAA. Otherwise not present.
          type: string
        last_seen:
          description: The time this record was last observed.
          format: date-time
          type: string
        mail_server:
          description: The MX mail server. Only present when record_type is MX. Otherwise not present.
          type: string
        mname:
          description: The primary name server. Only present when record_type is SOA. Otherwise not present.
          type: string
        name_server:
          description: The name server. Only present when record_type is NS. Otherwise not present.
          type: string
        priority:
          description: The MX priority. Only present when record_type is MX. Otherwise not present.
          format: int64
          type: integer
        record_type:
          description: The record type. Either A, AAAA, MX, NS, SOA, or TXT.
          enum:
            - A
            - AAAA
            - MX
            - NS
            - SOA
            - TXT
          type: string
        rname:
          description: The responsible contact, as email. Only present when record_type is SOA. Otherwise not present.
          type: string
        value:
          description: Full, untruncated string. Only present when record_type is TXT. Otherwise not present.
          type: string
      required:
        - first_seen
        - last_seen
        - record_type
      type: object
    Dns_EDns:
      additionalProperties: false
      properties:
        do:
          type: boolean
        options:
          items:
            type: string
          type:
            - array
            - "null"
        udp:
          format: int32
          minimum: 0
          type: integer
        version:
          format: int32
          minimum: 0
          type: integer
      type: object
    Dns_ResourceRecord:
      additionalProperties: false
      properties:
        name:
          description: The Fully Qualified Domain Name (FQDN) this RR is for.
          type: string
        response:
          description: The RDATA field of the RR.
          type: string
        type:
          description: An enumerated field indicating what type of data is in the "services.dns.additionals.response" field. For example, "A" signifies that the value in "services.dns.additionals.response" is an IPv4 address for the FQDN in "services.dns.additionals.name".
          enum:
            - ""
            - a
            - txt
            - ns
          type: string
      type: object
    DotnetNegotiateStream:
      additionalProperties: false
      properties:
        hresult:
          type: string
        message_id_name:
          type: string
        protocol_version:
          type: string
        supported_mech_oids:
          items:
            type: string
          type:
            - array
            - "null"
        supported_mechs:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    DsaPublicKey:
      additionalProperties: false
      properties:
        g:
          format: hex
          type: string
        p:
          format: hex
          type: string
        q:
          format: hex
          type: string
        "y":
          format: hex
          type: string
      type: object
    Dtls:
      additionalProperties: false
      type: object
    Dubbo:
      additionalProperties: false
      type: object
    DvrIp:
      additionalProperties: false
      properties:
        access_url:
          type: string
        function_capability:
          type: string
        function_list:
          type: string
        hard_drive:
          type: string
        language_support:
          type: string
        network_status:
          type: string
        oem_info:
          type: string
        partition_capability:
          $ref: "#/components/schemas/DvrIp_PartitionCapability"
        serial:
          type: string
        split_screen_capability:
          type: string
        version:
          type: string
        wireless_alarm_capability:
          type: string
      type: object
    DvrIp_PartitionCapability:
      additionalProperties: false
      properties:
        max_partition_number:
          format: int32
          type: integer
        supported:
          type: boolean
      type: object
    ECDSACryptographicKey:
      additionalProperties: false
      properties:
        b:
          format: base64
          type: string
        curve:
          type: string
        gx:
          format: base64
          type: string
        gy:
          format: base64
          type: string
        length:
          format: int32
          minimum: 0
          type: integer
        "n":
          format: base64
          type: string
        p:
          format: base64
          type: string
        pub:
          format: base64
          type: string
        x:
          format: base64
          type: string
        "y":
          format: base64
          type: string
      type: object
    ED25519CryptographicKey:
      additionalProperties: false
      properties:
        public_bytes:
          format: base64
          type: string
      type: object
    EPSS:
      additionalProperties: false
      properties:
        percentile:
          format: double
          type: number
        score:
          format: double
          type: number
      type: object
    EcdsaPublicKey:
      additionalProperties: false
      properties:
        b:
          format: hex
          type: string
        curve:
          type: string
        gx:
          format: hex
          type: string
        gy:
          format: hex
          type: string
        length:
          format: int64
          type: integer
        "n":
          format: hex
          type: string
        p:
          format: hex
          type: string
        pub:
          format: hex
          type: string
        x:
          format: hex
          type: string
        "y":
          format: hex
          type: string
      type: object
    EdiPartyName:
      additionalProperties: false
      properties:
        name_assigner:
          type: string
        party_name:
          type: string
      type: object
    Eip:
      additionalProperties: false
      properties:
        identity:
          $ref: "#/components/schemas/Eip_Identity"
        interfaces:
          items:
            $ref: "#/components/schemas/Eip_Interface"
          type:
            - array
            - "null"
        services:
          items:
            $ref: "#/components/schemas/Eip_Service"
          type:
            - array
            - "null"
      type: object
    Eip_Identity:
      additionalProperties: false
      properties:
        device_type:
          type: string
        device_type_code:
          format: int32
          minimum: 0
          type: integer
        product_code:
          format: int32
          minimum: 0
          type: integer
        product_name:
          type: string
        revision:
          type: string
        serial_number:
          format: int32
          minimum: 0
          type: integer
        socket_addr:
          type: string
        socket_port:
          format: int32
          minimum: 0
          type: integer
        state:
          format: int32
          minimum: 0
          type: integer
        status:
          format: int32
          minimum: 0
          type: integer
        vendor_id:
          type: string
        vendor_name:
          type: string
      type: object
    Eip_Interface:
      additionalProperties: false
      properties:
        index:
          format: int32
          minimum: 0
          type: integer
        name:
          type: string
      type: object
    Eip_Service:
      additionalProperties: false
      properties:
        capabilities:
          format: int32
          minimum: 0
          type: integer
        service_name:
          type: string
        supports_tcp:
          type: boolean
        supports_udp:
          type: boolean
      type: object
    ElasticSearch:
      additionalProperties: false
      properties:
        error_message:
          $ref: "#/components/schemas/ElasticSearch_ErrorMessage"
        results_node_info:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo"
        system_info:
          $ref: "#/components/schemas/ElasticSearch_SystemInfo"
      type: object
    ElasticSearch_ErrorMessage:
      additionalProperties: false
      properties:
        header:
          type: string
        reason:
          type: string
        type:
          type: string
      type: object
    ElasticSearch_ResultsNodeInfo:
      additionalProperties: false
      properties:
        cluster_combined_info:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_ClusterCombinedInfo"
        node_info:
          items:
            $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_Nodes"
          type:
            - array
            - "null"
      type: object
    ElasticSearch_ResultsNodeInfo_ClusterCombinedInfo:
      additionalProperties: false
      properties:
        filesystem:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_ClusterCombinedInfo_Filesystem"
        indices:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_ClusterCombinedInfo_Indices"
        name:
          type: string
        status:
          type: string
        timestamp:
          format: int64
          type: integer
        uuid:
          type: string
      type: object
    ElasticSearch_ResultsNodeInfo_ClusterCombinedInfo_Filesystem:
      additionalProperties: false
      properties:
        available:
          type: string
        available_in_bytes:
          format: int64
          type: integer
        free:
          type: string
        free_in_bytes:
          format: int64
          type: integer
        total:
          type: string
        total_in_bytes:
          format: int64
          type: integer
      type: object
    ElasticSearch_ResultsNodeInfo_ClusterCombinedInfo_Indices:
      additionalProperties: false
      properties:
        count:
          format: int64
          type: integer
        docs:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_ClusterCombinedInfo_Indices_Docs"
        store:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_ClusterCombinedInfo_Indices_Store"
      type: object
    ElasticSearch_ResultsNodeInfo_ClusterCombinedInfo_Indices_Docs:
      additionalProperties: false
      properties:
        count:
          format: int64
          type: integer
        deleted:
          format: int64
          type: integer
      type: object
    ElasticSearch_ResultsNodeInfo_ClusterCombinedInfo_Indices_Store:
      additionalProperties: false
      properties:
        reserved_in_bytes:
          format: int64
          type: integer
        size_in_bytes:
          format: int64
          type: integer
      type: object
    ElasticSearch_ResultsNodeInfo_Nodes:
      additionalProperties: false
      properties:
        node_data:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_Nodes_NodeData"
        node_name:
          type: string
      type: object
    ElasticSearch_ResultsNodeInfo_Nodes_NodeData:
      additionalProperties: false
      properties:
        build_flavor:
          type: string
        build_hash:
          type: string
        build_type:
          type: string
        host:
          type: string
        ingest_processors:
          items:
            type: string
          type:
            - array
            - "null"
        ip:
          type: string
        ip_raw:
          type: string
        jvm:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_Nodes_NodeData_JVM"
        modules:
          items:
            $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_Nodes_NodeData_Modules"
          type:
            - array
            - "null"
        name:
          type: string
        os:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_Nodes_NodeData_OS"
        roles:
          items:
            type: string
          type:
            - array
            - "null"
        settings:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_Nodes_NodeData_NodeSettings"
        thread_pool_list:
          items:
            $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_Nodes_NodeData_ThreadPool"
          type:
            - array
            - "null"
        total_indexing_buffer:
          format: int64
          type: integer
        version:
          type: string
      type: object
    ElasticSearch_ResultsNodeInfo_Nodes_NodeData_JVM:
      additionalProperties: false
      properties:
        gc:
          items:
            type: string
          type:
            - array
            - "null"
        input_args:
          items:
            type: string
          type:
            - array
            - "null"
        memory_pools:
          items:
            type: string
          type:
            - array
            - "null"
        start_time:
          type: string
        start_time_ms:
          format: int64
          type: integer
        version:
          type: string
        vm_name:
          type: string
        vm_vendor:
          type: string
        vm_version:
          type: string
      type: object
    ElasticSearch_ResultsNodeInfo_Nodes_NodeData_Modules:
      additionalProperties: false
      properties:
        class_name:
          type: string
        desc:
          type: string
        elastic_version:
          type: string
        ext_plugins:
          items:
            type: string
          type:
            - array
            - "null"
        has_native_ctrl:
          type: boolean
        java_version:
          type: string
        name:
          type: string
        version:
          type: string
      type: object
    ElasticSearch_ResultsNodeInfo_Nodes_NodeData_NodeSettings:
      additionalProperties: false
      properties:
        cluster_name:
          type: string
        node:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_Nodes_NodeData_NodeSettings_Node"
      type: object
    ElasticSearch_ResultsNodeInfo_Nodes_NodeData_NodeSettings_Node:
      additionalProperties: false
      properties:
        attr:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_Nodes_NodeData_NodeSettings_Node_Attr"
        name:
          type: string
      type: object
    ElasticSearch_ResultsNodeInfo_Nodes_NodeData_NodeSettings_Node_Attr:
      additionalProperties: false
      properties:
        ml:
          $ref: "#/components/schemas/ElasticSearch_ResultsNodeInfo_Nodes_NodeData_NodeSettings_Node_Attr_ML"
        xpack_installed:
          type: string
      type: object
    ElasticSearch_ResultsNodeInfo_Nodes_NodeData_NodeSettings_Node_Attr_ML:
      additionalProperties: false
      properties:
        enabled:
          type: string
        machine_memory:
          type: string
        max_open_jobs:
          type: string
      type: object
    ElasticSearch_ResultsNodeInfo_Nodes_NodeData_OS:
      additionalProperties: false
      properties:
        allocated_proc:
          format: int32
          type: integer
        arch:
          type: string
        available_proc:
          format: int32
          type: integer
        name:
          type: string
        pretty_name:
          type: string
        refresh_interval_ms:
          format: int64
          type: integer
        version:
          type: string
      type: object
    ElasticSearch_ResultsNodeInfo_Nodes_NodeData_ThreadPool:
      additionalProperties: false
      properties:
        keep_alive:
          type: string
        max:
          format: int32
          type: integer
        min:
          format: int32
          type: integer
        queue_size:
          format: int32
          type: integer
        type:
          type: string
      type: object
    ElasticSearch_SystemInfo:
      additionalProperties: false
      properties:
        cluster_uuid:
          type: string
        name:
          type: string
        tagline:
          type: string
        version:
          $ref: "#/components/schemas/ElasticSearch_SystemInfo_Ver"
      type: object
    ElasticSearch_SystemInfo_Ver:
      additionalProperties: false
      properties:
        build_date:
          type: string
        build_flavor:
          type: string
        build_hash:
          type: string
        build_snapshot:
          type: boolean
        build_type:
          type: string
        lucene_version:
          type: string
        min_idx_compat_ver:
          type: string
        min_wire_compat_ver:
          type: string
        number:
          type: string
      type: object
    ElasticsearchTransport:
      additionalProperties: false
      properties:
        handshake_ok:
          type: boolean
        protocol_version:
          format: int32
          minimum: 0
          type: integer
        transport_version_id:
          format: int32
          minimum: 0
          type: integer
        version:
          type: string
      type: object
    ElfFile:
      additionalProperties: false
      properties:
        class:
          type: string
        data:
          type: string
        machine:
          type: string
        os_abi:
          type: string
        type:
          type: string
      type: object
    EndpointScan:
      additionalProperties: false
      properties:
        argocd:
          $ref: "#/components/schemas/Argocd"
        banner:
          format: utf8
          type: string
        banner_hash_sha256:
          format: hex
          type: string
        chrome_devtools:
          $ref: "#/components/schemas/ChromeDevtools"
        clickhouse_http:
          $ref: "#/components/schemas/ClickHouseHttp"
        cobalt_strike:
          $ref: "#/components/schemas/CobaltStrike"
        elasticsearch:
          $ref: "#/components/schemas/ElasticSearch"
        endpoint_type:
          type: string
        fortigate:
          $ref: "#/components/schemas/Fortigate"
        graphql:
          $ref: "#/components/schemas/Graphql"
        hostname:
          type: string
        http:
          $ref: "#/components/schemas/Http"
        influxdb:
          $ref: "#/components/schemas/Influxdb"
        ip:
          type: string
        is_success:
          type: boolean
        ivanti_avalanche:
          $ref: "#/components/schemas/IvantiAvalanche"
        jenkins:
          $ref: "#/components/schemas/Jenkins"
        jupyter:
          $ref: "#/components/schemas/Jupyter"
        keycloak:
          $ref: "#/components/schemas/Keycloak"
        kubernetes:
          $ref: "#/components/schemas/Kubernetes"
        mcp:
          $ref: "#/components/schemas/Mcp"
        netflix_nrdp:
          $ref: "#/components/schemas/NetflixNrdp"
        nginx_proxy_manager:
          $ref: "#/components/schemas/NginxProxyManager"
        ollama:
          $ref: "#/components/schemas/Ollama"
        open_directory:
          $ref: "#/components/schemas/OpenDirectory"
        path:
          type: string
        plex_media_server:
          $ref: "#/components/schemas/PlexMediaServer"
        port:
          format: int32
          minimum: 0
          type: integer
        pprof:
          $ref: "#/components/schemas/Pprof"
        prometheus:
          $ref: "#/components/schemas/Prometheus"
        prometheus_target:
          $ref: "#/components/schemas/PrometheusTarget"
        proxmox_ve:
          $ref: "#/components/schemas/ProxmoxVe"
        redlion_web:
          $ref: "#/components/schemas/RedlionWeb"
        scada_view:
          $ref: "#/components/schemas/ScadaView"
        scan_time:
          type: string
        screenshots:
          items:
            $ref: "#/components/schemas/Screenshot"
          type:
            - array
            - "null"
        synology_dsm:
          $ref: "#/components/schemas/SynologyDsm"
        tailscale_derp:
          $ref: "#/components/schemas/TailscaleDerp"
        tls:
          $ref: "#/components/schemas/Tls"
        transport_protocol:
          enum:
            - ""
            - tcp
            - udp
            - icmp
            - quic
          type: string
        vault:
          $ref: "#/components/schemas/Vault"
        wordpress:
          $ref: "#/components/schemas/Wordpress"
      type: object
    EndpointScanState:
      additionalProperties: false
      properties:
        argocd:
          $ref: "#/components/schemas/Argocd"
        banner:
          format: utf8
          type: string
        banner_hash_sha256:
          format: hex
          type: string
        chrome_devtools:
          $ref: "#/components/schemas/ChromeDevtools"
        clickhouse_http:
          $ref: "#/components/schemas/ClickHouseHttp"
        cobalt_strike:
          $ref: "#/components/schemas/CobaltStrike"
        elasticsearch:
          $ref: "#/components/schemas/ElasticSearch"
        endpoint_type:
          type: string
        extracted:
          $ref: "#/components/schemas/ExtractedEndpointData"
        fortigate:
          $ref: "#/components/schemas/Fortigate"
        graphql:
          $ref: "#/components/schemas/Graphql"
        hostname:
          type: string
        http:
          $ref: "#/components/schemas/Http"
        influxdb:
          $ref: "#/components/schemas/Influxdb"
        ip:
          type: string
        ivanti_avalanche:
          $ref: "#/components/schemas/IvantiAvalanche"
        jenkins:
          $ref: "#/components/schemas/Jenkins"
        jupyter:
          $ref: "#/components/schemas/Jupyter"
        keycloak:
          $ref: "#/components/schemas/Keycloak"
        kubernetes:
          $ref: "#/components/schemas/Kubernetes"
        mcp:
          $ref: "#/components/schemas/Mcp"
        netflix_nrdp:
          $ref: "#/components/schemas/NetflixNrdp"
        nginx_proxy_manager:
          $ref: "#/components/schemas/NginxProxyManager"
        ollama:
          $ref: "#/components/schemas/Ollama"
        open_directory:
          $ref: "#/components/schemas/OpenDirectory"
        path:
          type: string
        plex_media_server:
          $ref: "#/components/schemas/PlexMediaServer"
        port:
          format: int32
          minimum: 0
          type: integer
        pprof:
          $ref: "#/components/schemas/Pprof"
        prometheus:
          $ref: "#/components/schemas/Prometheus"
        prometheus_target:
          $ref: "#/components/schemas/PrometheusTarget"
        proxmox_ve:
          $ref: "#/components/schemas/ProxmoxVe"
        redlion_web:
          $ref: "#/components/schemas/RedlionWeb"
        scada_view:
          $ref: "#/components/schemas/ScadaView"
        scan_time:
          type: string
        screenshots:
          items:
            $ref: "#/components/schemas/Screenshot"
          type:
            - array
            - "null"
        synology_dsm:
          $ref: "#/components/schemas/SynologyDsm"
        tailscale_derp:
          $ref: "#/components/schemas/TailscaleDerp"
        transport_protocol:
          enum:
            - ""
            - tcp
            - udp
            - icmp
            - quic
          type: string
        vault:
          $ref: "#/components/schemas/Vault"
        wordpress:
          $ref: "#/components/schemas/Wordpress"
      type: object
    EndpointScanned:
      additionalProperties: false
      properties:
        diff:
          additionalProperties:
            $ref: "#/components/schemas/FieldDiff"
          type: object
        scan:
          $ref: "#/components/schemas/EndpointScan"
      type: object
    Epmd:
      additionalProperties: false
      properties:
        names:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
    ErrorModel:
      additionalProperties: false
      properties:
        detail:
          description: A human-readable explanation specific to this occurrence of the problem.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: "#/components/schemas/ErrorDetail"
          type:
            - array
            - "null"
        instance:
          description: A URI reference that identifies the specific occurrence of the problem.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: A short, human-readable summary of the problem type. This value should not change between occurrences of the error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
      type: object
    Etcd:
      additionalProperties: false
      properties:
        v2:
          $ref: "#/components/schemas/Etcd_V2"
        v3:
          $ref: "#/components/schemas/Etcd_V3"
        version:
          $ref: "#/components/schemas/Etcd_Version"
      type: object
    Etcd_V2:
      additionalProperties: false
      properties:
        auth:
          $ref: "#/components/schemas/Auth"
        members:
          items:
            $ref: "#/components/schemas/Members"
          type:
            - array
            - "null"
        total_keys:
          format: int32
          minimum: 0
          type: integer
      type: object
    Etcd_V3:
      additionalProperties: false
      properties:
        auth:
          $ref: "#/components/schemas/Auth"
        members:
          items:
            $ref: "#/components/schemas/Members"
          type:
            - array
            - "null"
        total_keys:
          format: int32
          minimum: 0
          type: integer
      type: object
    Etcd_Version:
      additionalProperties: false
      properties:
        cluster:
          type: string
        server:
          type: string
      type: object
    Ethereum:
      additionalProperties: false
      properties:
        accounts:
          items:
            type: string
          type:
            - array
            - "null"
        hashrate:
          type: string
        version:
          $ref: "#/components/schemas/Ethereum_Version"
      type: object
    Ethereum_Version:
      additionalProperties: false
      properties:
        client:
          type: string
        compiler:
          type: string
        platform:
          type: string
        trailing:
          type: string
        version:
          type: string
      type: object
    EventAssetChange:
      additionalProperties: false
      properties:
        change_type:
          enum:
            - added
            - removed
          type: string
        event_time:
          format: date-time
          type: string
        reason:
          type: string
      required:
        - event_time
        - reason
        - change_type
      type: object
    EventStatusChange:
      additionalProperties: false
      properties:
        event_time:
          format: date-time
          type: string
        new_status:
          enum:
            - active
            - populating
            - paused
            - archived
          type: string
        old_status:
          enum:
            - active
            - populating
            - paused
            - archived
          type: string
        reason:
          type: string
      required:
        - event_time
        - new_status
      type: object
    EventsCapabilities:
      additionalProperties: false
      properties:
        max_notification_producers:
          format: int32
          minimum: 0
          type: integer
        max_pull_points:
          format: int32
          minimum: 0
          type: integer
        ws_pausable_subscription_manager_interface_support:
          type: boolean
        ws_pull_point_support:
          type: boolean
        ws_subscription_policy_support:
          type: boolean
      type: object
    Evidence:
      additionalProperties: false
      properties:
        data_path:
          type: string
        exists:
          type: boolean
        found_value:
          type: string
        literal_match:
          type: string
        negative:
          type: boolean
        proprietary:
          type: boolean
        regex:
          type: string
        semver_expression:
          type: string
      type: object
    Export:
      additionalProperties: false
      properties:
        details:
          type: string
        max_payload_size:
          format: int32
          minimum: 0
          type: integer
        min_block_size:
          format: int32
          minimum: 0
          type: integer
        name:
          type: string
        preferred_block_size:
          format: int32
          minimum: 0
          type: integer
        size:
          format: int64
          minimum: 0
          type: integer
        transmit_flags:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    ExportList:
      additionalProperties: false
      properties:
        directory:
          type: string
        groups:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    ExtendedKeyUsage:
      additionalProperties: false
      properties:
        any:
          type: boolean
        apple_code_signing:
          type: boolean
        apple_code_signing_development:
          type: boolean
        apple_code_signing_third_party:
          type: boolean
        apple_crypto_development_env:
          type: boolean
        apple_crypto_env:
          type: boolean
        apple_crypto_maintenance_env:
          type: boolean
        apple_crypto_production_env:
          type: boolean
        apple_crypto_qos:
          type: boolean
        apple_crypto_test_env:
          type: boolean
        apple_crypto_tier0_qos:
          type: boolean
        apple_crypto_tier1_qos:
          type: boolean
        apple_crypto_tier2_qos:
          type: boolean
        apple_crypto_tier3_qos:
          type: boolean
        apple_ichat_encryption:
          type: boolean
        apple_ichat_signing:
          type: boolean
        apple_resource_signing:
          type: boolean
        apple_software_update_signing:
          type: boolean
        apple_system_identity:
          type: boolean
        client_auth:
          type: boolean
        code_signing:
          type: boolean
        dvcs:
          type: boolean
        eap_over_lan:
          type: boolean
        eap_over_ppp:
          type: boolean
        email_protection:
          type: boolean
        ipsec_end_system:
          type: boolean
        ipsec_intermediate_system_usage:
          type: boolean
        ipsec_tunnel:
          type: boolean
        ipsec_user:
          type: boolean
        microsoft_ca_exchange:
          type: boolean
        microsoft_cert_trust_list_signing:
          type: boolean
        microsoft_csp_signature:
          type: boolean
        microsoft_document_signing:
          type: boolean
        microsoft_drm:
          type: boolean
        microsoft_drm_individualization:
          type: boolean
        microsoft_efs_recovery:
          type: boolean
        microsoft_embedded_nt_crypto:
          type: boolean
        microsoft_encrypted_file_system:
          type: boolean
        microsoft_enrollment_agent:
          type: boolean
        microsoft_kernel_mode_code_signing:
          type: boolean
        microsoft_key_recovery_21:
          type: boolean
        microsoft_key_recovery_3:
          type: boolean
        microsoft_license_server:
          type: boolean
        microsoft_licenses:
          type: boolean
        microsoft_lifetime_signing:
          type: boolean
        microsoft_mobile_device_software:
          type: boolean
        microsoft_nt5_crypto:
          type: boolean
        microsoft_oem_whql_crypto:
          type: boolean
        microsoft_qualified_subordinate:
          type: boolean
        microsoft_root_list_signer:
          type: boolean
        microsoft_server_gated_crypto:
          type: boolean
        microsoft_sgc_serialized:
          type: boolean
        microsoft_smart_display:
          type: boolean
        microsoft_smartcard_logon:
          type: boolean
        microsoft_system_health:
          type: boolean
        microsoft_system_health_loophole:
          type: boolean
        microsoft_timestamp_signing:
          type: boolean
        microsoft_whql_crypto:
          type: boolean
        netscape_server_gated_crypto:
          type: boolean
        ocsp_signing:
          type: boolean
        sbgp_cert_aa_service_auth:
          type: boolean
        server_auth:
          type: boolean
        time_stamping:
          type: boolean
        unknown:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    Extension:
      additionalProperties: false
      properties:
        critical:
          type: boolean
        id:
          type: string
        value:
          format: hex
          type: string
      type: object
    ExtractedEndpointData:
      additionalProperties: false
      properties:
        analytics_services:
          items:
            $ref: "#/components/schemas/ExtractedEndpointData_AnalyticsService"
          type:
            - array
            - "null"
        copyrights:
          items:
            $ref: "#/components/schemas/ExtractedEndpointData_Copyright"
          type:
            - array
            - "null"
        ip_addresses:
          items:
            type: string
          type:
            - array
            - "null"
        languages:
          items:
            type: string
          type:
            - array
            - "null"
        links:
          items:
            type: string
          type:
            - array
            - "null"
        mac_addresses:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    ExtractedEndpointData_AnalyticsService:
      additionalProperties: false
      properties:
        ids:
          items:
            type: string
          type:
            - array
            - "null"
        provider:
          type: string
      type: object
    ExtractedEndpointData_Copyright:
      additionalProperties: false
      properties:
        end_year:
          format: int32
          type: integer
        holder:
          type: string
        start_year:
          format: int32
          type: integer
        text:
          type: string
      type: object
    FieldDiff:
      additionalProperties: false
      properties:
        new:
          type: string
        old:
          type: string
      type: object
    FieldValuePair:
      additionalProperties: false
      properties:
        field:
          description: The field to match
          examples:
            - host.services.port
          type: string
        value:
          description: The value to match
          examples:
            - "80"
          type: string
      required:
        - field
        - value
      type: object
    Fins:
      additionalProperties: false
      properties:
        model:
          type: string
        status_error_message:
          type: string
        status_run_mode:
          type: string
        version:
          type: string
      type: object
    FlashSocketPolicy:
      additionalProperties: false
      properties:
        allow_access_from:
          items:
            $ref: "#/components/schemas/FlashSocketPolicy_AllowAccessFrom"
          type:
            - array
            - "null"
        policy:
          type: string
        site_control:
          type: string
      type: object
    FlashSocketPolicy_AllowAccessFrom:
      additionalProperties: false
      properties:
        domain:
          type: string
        secure:
          type: boolean
        to_ports:
          type: string
      type: object
    FloatValue:
      additionalProperties: false
      properties:
        value:
          format: float
          type: number
      type: object
    Fortigate:
      additionalProperties: false
      properties:
        api_version:
          type: string
        build:
          format: int32
          type: integer
        serial:
          type: string
        status_code:
          format: int32
          type: integer
        status_msg:
          type: string
        version:
          type: string
      type: object
    ForwardDnsResolved:
      additionalProperties: false
      properties:
        name:
          type: string
        resolve_time:
          type: string
      type: object
    FourdServer:
      additionalProperties: false
      properties:
        application_name:
          type: string
        application_version:
          type: string
        database_file:
          type: string
        transport_label:
          type: string
      type: object
    Fox:
      additionalProperties: false
      properties:
        app_name:
          type: string
        app_version:
          type: string
        auth_agent_type:
          type: string
        brand_id:
          type: string
        host_address:
          type: string
        host_id:
          type: string
        hostname:
          type: string
        id:
          format: int32
          minimum: 0
          type: integer
        language:
          type: string
        os_name:
          type: string
        os_version:
          type: string
        station_name:
          type: string
        sys_info:
          type: string
        time_zone:
          type: string
        version:
          type: string
        vm_name:
          type: string
        vm_uuid:
          type: string
        vm_version:
          type: string
      type: object
    Frps:
      additionalProperties: false
      properties:
        error:
          type: string
        run_id:
          type: string
        version:
          type: string
      type: object
    Ftp:
      additionalProperties: false
      properties:
        auth_ssl_response:
          format: utf8
          type: string
        auth_tls_response:
          format: utf8
          type: string
        implicit_tls:
          type: boolean
        status_code:
          format: int32
          type: integer
        status_meaning:
          type: string
      type: object
    Gearman:
      additionalProperties: false
      properties:
        status:
          items:
            $ref: "#/components/schemas/Status"
          type:
            - array
            - "null"
        version:
          type: string
        workers:
          items:
            $ref: "#/components/schemas/Worker"
          type:
            - array
            - "null"
      type: object
    Gemini:
      additionalProperties: false
      properties:
        body:
          format: utf8
          type: string
        client_cert_required:
          type: boolean
        meta:
          type: string
        status_code:
          format: int32
          type: integer
      type: object
    GeneralNames:
      additionalProperties: false
      properties:
        directory_names:
          description: The parsed directoryName entries in the GeneralName.
          items:
            $ref: "#/components/schemas/DistinguishedName"
          type:
            - array
            - "null"
        dns_names:
          description: The parsed dNSName entries in the GeneralName.
          items:
            type: string
          type:
            - array
            - "null"
        edi_party_names:
          description: The parsed eDIPartyName entries in the GeneralName.
          items:
            $ref: "#/components/schemas/EdiPartyName"
          type:
            - array
            - "null"
        email_addresses:
          description: The parsed rfc822Name entries in the GeneralName.
          items:
            type: string
          type:
            - array
            - "null"
        ip_addresses:
          description: The parsed ipAddress entries in the GeneralName.
          items:
            type: string
          type:
            - array
            - "null"
        other_names:
          description: The parsed otherName entries in the GeneralName. An arbitrary binary value identified by an OID.
          items:
            $ref: "#/components/schemas/OtherName"
          type:
            - array
            - "null"
        registered_ids:
          description: The parsed registeredID entries in the GeneralName. Stored in dotted-decimal format.
          items:
            type: string
          type:
            - array
            - "null"
        uniform_resource_identifiers:
          description: The parsed uniformResourceIdentifier entries in the GeneralName.
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    GeneralSubtreeIp:
      additionalProperties: false
      properties:
        begin:
          description: The first IP address in the range.
          type: string
        cidr:
          description: The CIDR specifying the subtree.
          type: string
        end:
          description: The last IP address in the range.
          type: string
        mask:
          description: The subnet mask of the CIDR.
          type: string
      type: object
    GeovisionAudio:
      additionalProperties: false
      properties:
        variant:
          type: string
        version:
          type: string
      type: object
    GetSupplierPayload:
      additionalProperties: false
      properties:
        supplier:
          $ref: "#/components/schemas/SupplyChainSupplier"
          description: Supplier
      required:
        - supplier
      type: object
    Giop:
      additionalProperties: false
      properties:
        byte_order:
          type: string
        implementation_hints:
          items:
            type: string
          type:
            - array
            - "null"
        ior:
          $ref: "#/components/schemas/Giop_Ior"
        locate_status:
          type: string
        message_type:
          type: string
        version:
          type: string
      type: object
    Giop_IiopProfile:
      additionalProperties: false
      properties:
        host:
          type: string
        object_key_hex:
          type: string
        port:
          format: int32
          minimum: 0
          type: integer
        tagged_components:
          items:
            $ref: "#/components/schemas/Giop_TaggedComponent"
          type:
            - array
            - "null"
        version:
          type: string
      type: object
    Giop_Ior:
      additionalProperties: false
      properties:
        iiop_profile:
          $ref: "#/components/schemas/Giop_IiopProfile"
        type_id:
          type: string
      type: object
    Giop_TaggedComponent:
      additionalProperties: false
      properties:
        ssl_port:
          format: int32
          minimum: 0
          type: integer
        ssl_requires:
          items:
            type: string
          type:
            - array
            - "null"
        ssl_supports:
          items:
            type: string
          type:
            - array
            - "null"
        tag:
          format: int32
          minimum: 0
          type: integer
        tag_name:
          type: string
      type: object
    Gopher:
      additionalProperties: false
      properties:
        body:
          type: string
        items:
          items:
            $ref: "#/components/schemas/Gopher_Item"
          type:
            - array
            - "null"
        title:
          type: string
      type: object
    Gopher_Item:
      additionalProperties: false
      properties:
        display_string:
          type: string
        hostname:
          type: string
        item_type:
          type: string
        port:
          format: int32
          type: integer
        selector:
          type: string
      type: object
    Graphql:
      additionalProperties: false
      properties:
        response:
          type: string
        supports_introspection:
          type: boolean
      type: object
    Greynoise:
      additionalProperties: false
      properties:
        actor:
          description: The actor that was observed.
          type: string
        classification:
          description: The classification of the IP address.
          type: string
        last_observed_time:
          description: The last time the IP address was observed.
          type: string
        tags:
          description: The tags associated with the IP address.
          items:
            $ref: "#/components/schemas/Greynoise_Tag"
          type:
            - array
            - "null"
      type: object
    Greynoise_Tag:
      additionalProperties: false
      properties:
        name:
          description: The name of the tag.
          type: string
      type: object
    GrilConsole:
      additionalProperties: false
      properties:
        board:
          type: string
        firmware_version:
          type: string
        model:
          type: string
        receiver_id:
          type: string
        vendor:
          type: string
      type: object
    Hajime:
      additionalProperties: false
      properties:
        public_key:
          format: hex
          type: string
      type: object
    HashObservationOnHostRange:
      additionalProperties: false
      properties:
        end_time:
          description: When the observation was last seen
          format: date-time
          type: string
        ip:
          description: IP address of the host
          type: string
        observation_type:
          description: Observation type selected in the request
          type: string
        observation_value:
          description: Observed value for the selected observation type
          type: string
        port:
          description: Port number
          type: string
        start_time:
          description: When the observation was first seen
          format: date-time
          type: string
        transport_protocol:
          description: Transport protocol when present for the selected timeline
          type: string
      required:
        - ip
        - port
        - observation_type
        - observation_value
        - start_time
        - end_time
      type: object
    HashObservationsOnHostResponse:
      additionalProperties: false
      properties:
        next_page_token:
          description: A token that can be used to retrieve the next page of ranges.
          type: string
        ranges:
          description: The list of observation ranges matching the request.
          items:
            $ref: "#/components/schemas/HashObservationOnHostRange"
          type:
            - array
            - "null"
      required:
        - ranges
        - next_page_token
      type: object
    HidVertx:
      additionalProperties: false
      properties:
        firmware_date:
          type: string
        id:
          type: string
        ip:
          type: string
        mac_address:
          type: string
        make_model:
          type: string
        model:
          type: string
        version:
          type: string
      type: object
    Hikvision:
      additionalProperties: false
      properties:
        custom_version:
          type: string
        platforms:
          items:
            $ref: "#/components/schemas/Hikvision_Platform"
          type:
            - array
            - "null"
        plugin_version:
          type: string
        web_version:
          type: string
      type: object
    Hikvision_Platform:
      additionalProperties: false
      properties:
        libraries:
          items:
            $ref: "#/components/schemas/Hikvision_Platform_Library"
          type:
            - array
            - "null"
        name:
          type: string
      type: object
    Hikvision_Platform_Library:
      additionalProperties: false
      properties:
        name:
          type: string
        version:
          type: string
      type: object
    HoosatHtndGrpc:
      additionalProperties: false
      properties:
        is_synced:
          type: boolean
        is_utxo_indexed:
          type: boolean
        mempool_size:
          format: int64
          minimum: 0
          type: integer
        p2p_id:
          type: string
        rpc_error:
          type: string
        server_version:
          type: string
      type: object
    Host:
      additionalProperties: false
      properties:
        autonomous_system:
          $ref: "#/components/schemas/Routing"
        dns:
          $ref: "#/components/schemas/HostDns"
        greynoise:
          $ref: "#/components/schemas/Greynoise"
        hardware:
          $ref: "#/components/schemas/Attribute"
        ip:
          type: string
        labels:
          items:
            $ref: "#/components/schemas/Label"
          type:
            - array
            - "null"
        location:
          $ref: "#/components/schemas/Location"
        network:
          description: Information about what type of network the host belongs to.
          items:
            $ref: "#/components/schemas/NetworkClassification"
          type:
            - array
            - "null"
        operating_system:
          $ref: "#/components/schemas/Attribute"
        privacy:
          description: Information about privacy services used by the IP, such as VPNs, Proxies, or Tor.
          items:
            $ref: "#/components/schemas/Privacy"
          type:
            - array
            - "null"
        reputation:
          $ref: "#/components/schemas/Reputation"
        service_count:
          format: int32
          type: integer
        services:
          items:
            $ref: "#/components/schemas/Service"
          type:
            - array
            - "null"
        whois:
          $ref: "#/components/schemas/Whois"
      type: object
    HostAsset:
      additionalProperties: false
      properties:
        extensions:
          additionalProperties: {}
          type: object
        resource:
          $ref: "#/components/schemas/Host"
      required:
        - resource
        - extensions
      type: object
    HostAssetWithMatchedServices:
      additionalProperties: false
      properties:
        extensions:
          additionalProperties: {}
          type: object
        matched_services:
          description: The host services that match the query.
          items:
            $ref: "#/components/schemas/MatchedService"
          type:
            - array
            - "null"
        resource:
          $ref: "#/components/schemas/Host"
      required:
        - resource
        - extensions
      type: object
    HostDns:
      additionalProperties: false
      properties:
        forward_dns:
          additionalProperties:
            $ref: "#/components/schemas/HostDns_ForwardResolution"
          type: object
        names:
          items:
            type: string
          type:
            - array
            - "null"
        reverse_dns:
          $ref: "#/components/schemas/HostDns_ReverseResolution"
      type: object
    HostDns_ForwardResolution:
      additionalProperties: false
      properties:
        name:
          type: string
        record_type:
          enum:
            - ""
            - a
            - aaaa
          type: string
        resolve_time:
          type: string
        server:
          type: string
      type: object
    HostDns_ReverseResolution:
      additionalProperties: false
      properties:
        names:
          items:
            type: string
          type:
            - array
            - "null"
        resolve_time:
          type: string
        server:
          type: string
      type: object
    HostEnrichment:
      additionalProperties: false
      properties:
        autonomous_system:
          $ref: "#/components/schemas/Routing"
        dns:
          $ref: "#/components/schemas/HostDns"
        greynoise:
          $ref: "#/components/schemas/HostEnrichmentGreynoise"
        ip:
          type: string
        labels:
          items:
            $ref: "#/components/schemas/Label"
          type:
            - array
            - "null"
        location:
          $ref: "#/components/schemas/Location"
        network:
          description: Information about what type of network the host belongs to.
          items:
            $ref: "#/components/schemas/NetworkClassification"
          type:
            - array
            - "null"
        privacy:
          description: Information about privacy services used by the IP, such as VPNs, Proxies, or Tor.
          items:
            $ref: "#/components/schemas/Privacy"
          type:
            - array
            - "null"
        reputation:
          $ref: "#/components/schemas/Reputation"
        service_count:
          format: int32
          type: integer
        services:
          items:
            $ref: "#/components/schemas/HostEnrichmentService"
          type:
            - array
            - "null"
        third_party:
          $ref: "#/components/schemas/ThirdParty"
          description: Enrichment data from third-party providers.
        whois:
          $ref: "#/components/schemas/Whois"
      type: object
    HostEnrichmentAsset:
      additionalProperties: false
      properties:
        extensions:
          additionalProperties: {}
          type: object
        resource:
          $ref: "#/components/schemas/HostEnrichment"
      required:
        - resource
        - extensions
      type: object
    HostEnrichmentGreynoise:
      additionalProperties: false
      properties:
        actor:
          description: The actor that was observed.
          type: string
        classification:
          description: The classification of the IP address.
          type: string
        last_observed_time:
          description: The last time the IP address was observed.
          type: string
      type: object
    HostEnrichmentService:
      additionalProperties: false
      properties:
        labels:
          items:
            $ref: "#/components/schemas/Label"
          type:
            - array
            - "null"
        port:
          format: int32
          minimum: 0
          type: integer
        protocol:
          type: string
        scan_time:
          type: string
        threats:
          items:
            $ref: "#/components/schemas/Threat"
          type:
            - array
            - "null"
      type: object
    HostObservationRange:
      additionalProperties: false
      properties:
        end_time:
          format: date-time
          type: string
        ip:
          type: string
        port:
          format: int32
          type: integer
        protocols:
          items:
            type: string
          type:
            - array
            - "null"
        start_time:
          format: date-time
          type: string
        transport_protocol:
          type: string
      required:
        - ip
        - port
        - transport_protocol
        - protocols
        - start_time
        - end_time
      type: object
    HostObservationResponse:
      additionalProperties: false
      properties:
        next_page_token:
          type: string
        ranges:
          items:
            $ref: "#/components/schemas/HostObservationRange"
          type:
            - array
            - "null"
        total_results:
          format: int64
          type: integer
      required:
        - ranges
        - total_results
      type: object
    HostTimeline:
      additionalProperties: false
      properties:
        events:
          items:
            $ref: "#/components/schemas/HostTimelineEventAsset"
          type:
            - array
            - "null"
        scanned_to:
          format: date-time
          type: string
      required:
        - events
        - scanned_to
      type: object
    HostTimelineEvent:
      additionalProperties: false
      properties:
        endpoint_scanned:
          $ref: "#/components/schemas/EndpointScanned"
        event_time:
          type: string
        forward_dns_resolved:
          $ref: "#/components/schemas/ForwardDnsResolved"
        jarm_scanned:
          $ref: "#/components/schemas/JarmScanned"
        location_updated:
          $ref: "#/components/schemas/LocationUpdated"
        reverse_dns_resolved:
          $ref: "#/components/schemas/ReverseDnsResolved"
        route_updated:
          $ref: "#/components/schemas/RouteUpdated"
        service_scanned:
          $ref: "#/components/schemas/ServiceScanned"
        whois_updated:
          $ref: "#/components/schemas/WhoisUpdated"
      type: object
    HostTimelineEventAsset:
      additionalProperties: false
      properties:
        extensions:
          additionalProperties: {}
          type: object
        resource:
          $ref: "#/components/schemas/HostTimelineEvent"
      required:
        - resource
        - extensions
      type: object
    Http:
      additionalProperties: false
      properties:
        body:
          description: The body of the HTTP response. For hosts without a name, the first 64KB are available. For hosts with a name, only 6KB are available.
          format: utf8
          type: string
        body_hash_sha1:
          format: hex
          type: string
        body_hash_sha256:
          format: hex
          type: string
        body_hash_tlsh:
          format: hex
          type: string
        body_size:
          description: The length, in bytes, of services.http.response.body; at most, 64KB.
          format: int32
          type: integer
        copyrights:
          description: Copyright notices declared by or found in the page, the one most likely to be the site's own first.
          items:
            $ref: "#/components/schemas/Http_Copyright"
          type:
            - array
            - "null"
        favicons:
          items:
            $ref: "#/components/schemas/Http_Favicon"
          type:
            - array
            - "null"
        google_site_verification:
          items:
            type: string
          type:
            - array
            - "null"
        headers:
          additionalProperties:
            $ref: "#/components/schemas/Http_RepeatedHeaders"
          description: The key-value header pairs included in the response.
          type: object
        html_tags:
          description: A list of the <title> and <meta> tags from services.http.response.body.
          items:
            format: utf8
            type: string
          type:
            - array
            - "null"
        html_title:
          description: "The title of the HTML page: the inner contents of the <title> tag in the response body, if present."
          format: utf8
          type: string
        network_log:
          $ref: "#/components/schemas/NetworkLog"
          description: List of all resources fetched when visiting this page as browser
        protocol:
          description: The protocol field of the response, which includes the claimed HTTP version number.
          type: string
        redirect_chain:
          description: If the scan redirects, the list of followup scans performed
          items:
            $ref: "#/components/schemas/Http_RedirectChainLink"
          type:
            - array
            - "null"
        status_code:
          description: A 3-digit integer result code indicating the result of the services.http.request.
          format: int32
          type: integer
        status_reason:
          description: A human-readable phrase describing the status code.
          type: string
        supported_versions:
          items:
            type: string
          type:
            - array
            - "null"
        uri:
          description: The full path used to make the request, which includes the scheme, host, port (when non-standard), and endpoint.
          type: string
      type: object
    Http_Copyright:
      additionalProperties: false
      properties:
        source:
          description: "Where in the response the notice was found: meta (a copyright meta tag) or body (text matched in the response body)."
          type: string
        text:
          description: The copyright notice as it appears in the response.
          type: string
      type: object
    Http_Favicon:
      additionalProperties: false
      properties:
        hash_md5:
          format: hex
          type: string
        hash_phash:
          description: A 64-bit 'perceptual' hash of the favicon
          format: hex
          type: string
        hash_sha256:
          format: hex
          type: string
        hash_shodan:
          description: A hash expressed as a signed decimal integer, provided for compatability with Shodan search.
          format: int32
          type: integer
        name:
          description: "The URI used to retrieve the favicon, which most commonly use the http(s) or data schemes. URIs using the data scheme are truncated: the first 48 and last 24 characters are preserved."
          type: string
        size:
          description: The size of the favicon retrieved, in bytes.
          format: int32
          type: integer
      type: object
    Http_RedirectChainLink:
      additionalProperties: false
      properties:
        hostname:
          type: string
        http_status:
          $ref: "#/components/schemas/Http_RedirectChainLink_HttpStatus"
          description: "The HTTP status code and reason of the redirecting response. "
        path:
          type: string
        port:
          format: int32
          minimum: 0
          type: integer
        reason:
          type: string
        scheme:
          type: string
        transport_protocol:
          enum:
            - ""
            - tcp
            - udp
            - icmp
            - quic
          type: string
      type: object
    Http_RedirectChainLink_HttpStatus:
      additionalProperties: false
      properties:
        code:
          description: A 3-digit integer result code indicating the result of the redirecting response.
          format: int32
          type: integer
        reason:
          description: A human-readable phrase describing the status code.
          type: string
      type: object
    Http_RepeatedHeaders:
      additionalProperties: false
      properties:
        headers:
          description: The values provided in the corresponding header.
          items:
            format: utf8
            type: string
          type:
            - array
            - "null"
      type: object
    Ibmnje:
      additionalProperties: false
      properties:
        ohost:
          type: string
        oip:
          type: string
        reason:
          format: int32
          minimum: 0
          type: integer
        rhost:
          type: string
        rip:
          type: string
        type:
          type: string
      type: object
    Icap:
      additionalProperties: false
      properties:
        options_response:
          $ref: "#/components/schemas/Icap_OptionsResponse"
      type: object
    Icap_OptionsResponse:
      additionalProperties: false
      properties:
        allow_204:
          type: boolean
        icap_version:
          type: string
        istag:
          type: string
        max_connections:
          format: int32
          type: integer
        methods:
          items:
            type: string
          type:
            - array
            - "null"
        options_ttl:
          format: int32
          type: integer
        preview:
          format: int32
          type: integer
        server_header:
          type: string
        service:
          type: string
        service_id:
          type: string
        status_code:
          format: int32
          type: integer
        status_text:
          type: string
      type: object
    Iec608705104:
      additionalProperties: false
      properties:
        apci:
          $ref: "#/components/schemas/Iec608705104_Apci"
        asdu:
          $ref: "#/components/schemas/Iec608705104_Asdu"
      type: object
    Iec608705104_Apci:
      additionalProperties: false
      properties:
        format:
          type: string
        u_subtype:
          type: string
      type: object
    Iec608705104_Asdu:
      additionalProperties: false
      properties:
        common_address:
          format: int32
          minimum: 0
          type: integer
        cot_name:
          type: string
        type_id_name:
          type: string
      type: object
    Ike:
      additionalProperties: false
      properties:
        v1:
          $ref: "#/components/schemas/Ike_V1"
        v2:
          $ref: "#/components/schemas/Ike_V2"
      type: object
    Ike_V1:
      additionalProperties: false
      properties:
        accepted_proposal:
          description: Did the host accept our security proposal? When false, the host responded with an error.
          type: boolean
        notify_message_types:
          description: Which types of NOTIFY messages did the host send us?
          items:
            format: int32
            minimum: 0
            type: integer
          type:
            - array
            - "null"
        vendor_ids:
          description: The list of Vendor ID "extensions" the host claimed to support in its handshake
          items:
            format: utf8
            type: string
          type:
            - array
            - "null"
      type: object
    Ike_V2:
      additionalProperties: false
      properties:
        accepted_proposal:
          type: boolean
        notify_message_types:
          items:
            format: int32
            minimum: 0
            type: integer
          type:
            - array
            - "null"
        vendor_ids:
          items:
            format: utf8
            type: string
          type:
            - array
            - "null"
      type: object
    ImageCapabilities:
      additionalProperties: false
      properties:
        image_stabilization:
          type: boolean
      type: object
    Imap:
      additionalProperties: false
      properties:
        start_tls:
          description: The server's response to the STARTTLS command.
          format: utf8
          type: string
      type: object
    Influxdb:
      additionalProperties: false
      properties:
        build:
          type: string
        setup_allowed:
          type: boolean
        version:
          type: string
      type: object
    InvestigationFileUpload:
      additionalProperties: false
      properties:
        expire_time:
          description: When upload_url stops working. A file that was uploaded before then stays usable afterwards; only the URL expires.
          format: date-time
          type: string
        file_id:
          description: Identifier for the uploaded file, to be sent as a file_ids entry when starting an investigation. It is an opaque handle, not a storage location, and it is meant for one investigation.
          examples:
            - file_550e8400-e29b-41d4-a716-446655440000
          type: string
        upload_headers:
          additionalProperties:
            type: string
          description: Send these headers on the PUT exactly as given. They are part of what the URL authorizes, so an upload that omits or changes one is rejected by storage.
          type: object
        upload_url:
          description: Send the file bytes here with an HTTP PUT. The URL grants access to this one file and nothing else, and stops working at expire_time.
          type: string
      required:
        - file_id
        - upload_url
        - upload_headers
        - expire_time
      type: object
    InvestigationJob:
      additionalProperties: false
      properties:
        complete_time:
          description: When the investigation finished. Omitted while it is still running.
          format: date-time
          type: string
        create_time:
          description: When the investigation was started.
          format: date-time
          type: string
        expire_time:
          description: When the investigation and its results stop being available for download.
          format: date-time
          type: string
        job_id:
          description: The unique identifier of the investigation.
          examples:
            - 550e8400-e29b-41d4-a716-446655440000
          format: uuid
          type: string
        state:
          description: The current state of the investigation. Completed means the investigation succeeded, not that its results are still available to download, and unknown means only that this API is older than the state the service reported.
          enum:
            - started
            - completed
            - failed
            - unknown
          examples:
            - completed
          type: string
        title:
          description: A short description of what the investigation looked into. Omitted when the investigation has no title yet.
          type: string
      required:
        - job_id
        - state
        - create_time
      type: object
    InvestigationJobsList:
      additionalProperties: false
      properties:
        jobs:
          description: The caller's investigations in this organization, newest first.
          items:
            $ref: "#/components/schemas/InvestigationJob"
          type:
            - array
            - "null"
        next_page_token:
          description: Token to retrieve the next page of investigations. Omitted when there are no more results.
          type: string
      required:
        - jobs
      type: object
    InvestigationUsage:
      additionalProperties: false
      properties:
        limit:
          description: Maximum new investigations allowed per organization in the rolling window.
          format: int64
          type: integer
        next_expire_time:
          description: When the oldest counted start reaches the end of the rolling window and stops counting. This expires one start, it does not reset the allowance, and it is reported whenever any start is counted rather than only when remaining is zero. Omitted when used is zero.
          format: date-time
          type: string
        remaining:
          description: Additional new investigations available, never less than zero. This is a snapshot, not a reservation.
          format: int64
          minimum: 0
          type: integer
        used:
          description: New investigations started by all organization members through the UI and API within the rolling window.
          format: int64
          type: integer
        window_seconds:
          description: Duration of the rolling allowance window in seconds.
          format: int64
          type: integer
      required:
        - limit
        - used
        - remaining
        - window_seconds
      type: object
    InviteMemberInputBody:
      additionalProperties: false
      properties:
        email:
          description: Email of the user
          examples:
            - user@example.com
          format: email
          type: string
      required:
        - email
      type: object
    Iota:
      additionalProperties: false
      properties:
        v0_info:
          $ref: "#/components/schemas/NodeInfoV0"
        v1_info:
          $ref: "#/components/schemas/NodeInfoV1"
        v2_info:
          $ref: "#/components/schemas/NodeInfoV2"
      type: object
    Iperf3:
      additionalProperties: false
      properties:
        state_name:
          type: string
      type: object
    Ipmi:
      additionalProperties: false
      properties:
        capabilities:
          $ref: "#/components/schemas/Ipmi_Capabilities"
          description: The Get Channel Authentication Capabilities response (section 22.13)
        command_payload:
          $ref: "#/components/schemas/Ipmi_CommandPayload"
          description: The IPMI command payload
        raw:
          description: The raw data returned by the server
          format: hex
          type: string
        rmcp_header:
          $ref: "#/components/schemas/Ipmi_RMCPHeader"
          description: The RMCP header of the response, (section 13.1.3)
        session_header:
          $ref: "#/components/schemas/Ipmi_SessionHeader"
          description: The IPMI sesssion header of the response
      type: object
    Ipmi_Capabilities:
      additionalProperties: false
      properties:
        auth_status:
          $ref: "#/components/schemas/Ipmi_Capabilities_AuthStatus"
          description: The authentication status
        channel_number:
          description: The response channel number
          format: int32
          type: integer
        completion_code:
          $ref: "#/components/schemas/Ipmi_Capabilities_CompletionCode"
          description: The status code of the response
        extended_capabilities:
          $ref: "#/components/schemas/Ipmi_Capabilities_ExtendedCapabilities"
          description: Extended auth capabilities (if present)
        oem_data:
          description: The OEM-specific data
          format: int32
          type: integer
        oem_id:
          description: The 3-byte OEM identifier
          format: hex
          type: string
        supported_auth_types:
          $ref: "#/components/schemas/Ipmi_Capabilities_SupportedAuthTypes"
          description: The auth types supported by the server
      type: object
    Ipmi_Capabilities_AuthStatus:
      additionalProperties: false
      properties:
        anonymous_login_enabled:
          description: If true, the server allows anonymous login.
          type: boolean
        auth_each_message:
          description: If true, each message must be authenticated.
          type: boolean
        has_anonymous_users:
          description: If true, the server has anonymous users.
          type: boolean
        has_named_users:
          description: If true, the server supports named users.
          type: boolean
        two_key_login_required:
          description: The KG field.
          type: boolean
        user_auth_disabled:
          description: If true, user authentication is disabled.
          type: boolean
      type: object
    Ipmi_Capabilities_CompletionCode:
      additionalProperties: false
      properties:
        name:
          description: The human-readable name of the code
          type: string
        raw:
          description: The raw completion code
          format: int32
          type: integer
      type: object
    Ipmi_Capabilities_ExtendedCapabilities:
      additionalProperties: false
      properties:
        supports_ipmi_v1_5:
          description: True if IPMI v1.5 is supported
          type: boolean
        supports_ipmi_v2_0:
          description: True if IPMI v2.0 is supported
          type: boolean
      type: object
    Ipmi_Capabilities_SupportedAuthTypes:
      additionalProperties: false
      properties:
        extended:
          description: If true, the extended capabilities are present.
          type: boolean
        md2:
          description: True if the MD2 AuthType is supported.
          type: boolean
        md5:
          description: True if the MD5 AuthType is supported.
          type: boolean
        none:
          description: True if the None AuthType is supported.
          type: boolean
        oem_proprietary:
          description: True if the OEM Proprietary AuthType is supported
          type: boolean
        password:
          description: True if the Password AuthType is supported.
          type: boolean
        raw:
          description: The raw byte, with the bit mask etc
          format: int32
          type: integer
      type: object
    Ipmi_CommandPayload:
      additionalProperties: false
      properties:
        checksum_error:
          description: This is set to true if the values of chk1 / chk2 do not match the command data
          type: boolean
        data:
          description: The raw data. On success, this should be the value of the GetAuthenticationCapabilities resopnse
          format: hex
          type: string
        ipmi_command_number:
          $ref: "#/components/schemas/Ipmi_CommandPayload_CommandNumber"
          description: The parsed IPMI command number
        network_function_code:
          $ref: "#/components/schemas/Ipmi_CommandPayload_PackedNetFn"
          description: The NetFn and LUN
        requestor_sequence_number:
          description: The request sequence number.
          format: int32
          type: integer
      type: object
    Ipmi_CommandPayload_CommandNumber:
      additionalProperties: false
      properties:
        name:
          description: The human-readable name of the cmd + NetFn
          type: string
        raw:
          description: The raw value of the cmd value
          format: int32
          type: integer
      type: object
    Ipmi_CommandPayload_PackedNetFn:
      additionalProperties: false
      properties:
        logical_unit_number:
          $ref: "#/components/schemas/Ipmi_CommandPayload_PackedNetFn_LogicalUnitNumber"
          description: The parsed LUN (logical unit number -- the lower 2 bits of raw)
        net_fn:
          $ref: "#/components/schemas/Ipmi_CommandPayload_PackedNetFn_NetFn"
          description: The parsed NetFn value (the upper 6 bits of raw)
        raw:
          description: The raw value of the (NetFn << 2) | LUN
          format: int32
          type: integer
      type: object
    Ipmi_CommandPayload_PackedNetFn_LogicalUnitNumber:
      additionalProperties: false
      properties:
        name:
          description: The human-readable name of the LUN
          type: string
        raw:
          description: The value of the LUN (3 bits)
          format: int32
          type: integer
      type: object
    Ipmi_CommandPayload_PackedNetFn_NetFn:
      additionalProperties: false
      properties:
        is_request:
          description: True if the least-significant bit is zero
          type: boolean
        is_response:
          description: True if the least-significant bit is one
          type: boolean
        name:
          description: The human-readable name of the NetFn
          type: string
        raw:
          description: The raw value of the NetFn (6 bits, least significant indicates request/response)
          format: int32
          type: integer
        value:
          description: The normalized value of the NetFn (i.e. raw & 0xfe, so it is always even)
          format: int32
          type: integer
      type: object
    Ipmi_RMCPHeader:
      additionalProperties: false
      properties:
        message_class:
          $ref: "#/components/schemas/Ipmi_RMCPHeader_MessageClass"
          description: The class of the message.
        sequence_number:
          description: Sequence number of this packet in the session.
          format: int32
          type: integer
        version:
          description: The version. This scanner supports version 6.
          format: int32
          type: integer
      type: object
    Ipmi_RMCPHeader_MessageClass:
      additionalProperties: false
      properties:
        class:
          description: Just the class part of the byte (lower 5 bits of raw)
          format: int32
          type: integer
        is_ack:
          description: True if the message is an acknowledgment to a previous message.
          type: boolean
        name:
          description: The human-readable name of the message class
          type: string
        raw:
          description: The raw message class byte.
          format: int32
          type: integer
      type: object
    Ipmi_SessionHeader:
      additionalProperties: false
      properties:
        auth_code:
          description: The 16-byte authentication code; not present if auth_type is None.
          format: hex
          type: string
        auth_type:
          $ref: "#/components/schemas/Ipmi_SessionHeader_AuthType"
          description: The authentication type for this request (see section 13.6)
        session_id:
          description: The ID of this sessiod.
          format: int64
          type: integer
        session_sequence_number:
          description: The session sequence number of this packet in the session
          format: int64
          type: integer
      type: object
    Ipmi_SessionHeader_AuthType:
      additionalProperties: false
      properties:
        name:
          description: The raw value of the auth_type
          type: string
        raw:
          description: The raw value of the auth_type
          format: int32
          type: integer
        type:
          description: Just the auth type (reserved bits omitted)
          format: int32
          type: integer
      type: object
    Ipp:
      additionalProperties: false
      properties:
        attribute_cups_version:
          description: The CUPS version, if any, specified in the list of attributes returned in a get-printer-attributes response or CUPS-get-printers response. Generally in the form 'x.y.z'.
          type: string
        attribute_ipp_versions:
          description: Each IPP version, if any, specified in the list of attributes returned in a get-printer-attributes response or CUPS-get-printers response. Always in the form 'x.y'.
          items:
            type: string
          type:
            - array
            - "null"
        attribute_printer_uris:
          description: Each printer URI, if any, specified in the list of attributes returned in a get-printer-attributes response or CUPS-get-printers response. Uses ipp(s) or http(s) scheme, followed by a hostname or IP, and then the path to a particular printer.
          items:
            type: string
          type:
            - array
            - "null"
        attributes:
          description: All IPP attributes included in any contentful responses obtained. Each has a name, list of values (potentially only one), and a tag denoting how the value should be interpreted.
          items:
            $ref: "#/components/schemas/Ipp_Attribute"
          type:
            - array
            - "null"
        cups_version:
          description: The CUPS version, if any, specified in the Server header of an IPP get-attributes response.
          type: string
        major_version:
          description: Major component of IPP version listed in the Server header of a response to an IPP get-printer-attributes request.
          format: int32
          minimum: 0
          type: integer
        minor_version:
          description: Minor component of IPP version listed in the Server header of a response to an IPP get-printer-attributes request.
          format: int32
          minimum: 0
          type: integer
        version_string:
          description: The specific IPP version returned in response to an IPP get-printer-attributes request. Always in the form 'IPP/x.y'
          type: string
      type: object
    Ipp_Attribute:
      additionalProperties: false
      properties:
        name:
          type: string
        value_tag:
          format: int32
          minimum: 0
          type: integer
      type: object
    IscDhcpOmapi:
      additionalProperties: false
      properties:
        auth_posture:
          type: string
        message_dict_extra_keys:
          items:
            type: string
          type:
            - array
            - "null"
        object_dict_keys:
          items:
            type: string
          type:
            - array
            - "null"
        object_dict_present:
          type: boolean
        object_state:
          format: int32
          minimum: 0
          type: integer
        reply_header:
          $ref: "#/components/schemas/IscDhcpOmapi_ReplyHeader"
        status_message:
          type: string
      type: object
    IscDhcpOmapi_ReplyHeader:
      additionalProperties: false
      properties:
        authid:
          format: int32
          minimum: 0
          type: integer
        authlen:
          format: int32
          minimum: 0
          type: integer
        handle:
          format: int32
          minimum: 0
          type: integer
        opcode:
          type: string
        tid:
          format: int32
          minimum: 0
          type: integer
      type: object
    Iscsi:
      additionalProperties: false
      properties:
        connection:
          $ref: "#/components/schemas/Connection"
        errors:
          items:
            type: string
          type:
            - array
            - "null"
        targets:
          items:
            $ref: "#/components/schemas/Target"
          type:
            - array
            - "null"
      type: object
    IvantiAvalanche:
      additionalProperties: false
      properties:
        body:
          format: utf8
          type: string
        status_code:
          format: int32
          type: integer
        version:
          type: string
      type: object
    JA4TScanScan:
      additionalProperties: false
      properties:
        fingerprint:
          type: string
        scan_time:
          type: string
      type: object
    JarmScan:
      additionalProperties: false
      properties:
        cipher_and_version_fingerprint:
          description: The first 30 character portion of the Jarm fingerprint.
          format: hex
          type: string
        fingerprint:
          description: The 62 character Jarm fingerprint of the service.
          format: hex
          type: string
        hostname:
          type: string
        ip:
          type: string
        is_success:
          type: boolean
        port:
          format: int32
          minimum: 0
          type: integer
        scan_time:
          description: The time the service was fingerprinted
          type: string
        tls_extensions_sha256:
          description: The second 32 character portion of the Jarm fingerprint
          format: hex
          type: string
        transport_protocol:
          enum:
            - ""
            - tcp
            - udp
            - icmp
            - quic
          type: string
      type: object
    JarmScanned:
      additionalProperties: false
      properties:
        diff:
          additionalProperties:
            $ref: "#/components/schemas/FieldDiff"
          type: object
        scan:
          $ref: "#/components/schemas/JarmScan"
      type: object
    JavaRmi:
      additionalProperties: false
      properties:
        codebase_url:
          type: string
        software:
          type: string
        stub_classes:
          items:
            type: string
          type:
            - array
            - "null"
        unicast_refs:
          items:
            $ref: "#/components/schemas/JavaRmi_UnicastRef"
          type:
            - array
            - "null"
      type: object
    JavaRmi_UnicastRef:
      additionalProperties: false
      properties:
        host:
          type: string
        port:
          format: int32
          minimum: 0
          type: integer
        type:
          type: string
      type: object
    Jenkins:
      additionalProperties: false
      properties:
        assigned_labels:
          items:
            $ref: "#/components/schemas/Jenkins_Label"
          type:
            - array
            - "null"
        jobs:
          items:
            $ref: "#/components/schemas/Jenkins_Job"
          type:
            - array
            - "null"
        mode:
          type: string
        node_description:
          type: string
        node_name:
          type: string
        slave_agent_port:
          format: int32
          type: integer
        use_security:
          type: boolean
      type: object
    Jenkins_Build:
      additionalProperties: false
      properties:
        duration_seconds:
          format: int64
          type: integer
        number:
          format: int64
          type: integer
        result:
          type: string
        timestamp:
          format: int64
          type: integer
        url:
          type: string
      type: object
    Jenkins_Job:
      additionalProperties: false
      properties:
        description:
          type: string
        last_build:
          $ref: "#/components/schemas/Jenkins_Build"
        name:
          type: string
        url:
          type: string
      type: object
    Jenkins_Label:
      additionalProperties: false
      properties:
        name:
          type: string
        value:
          type: string
      type: object
    Jupyter:
      additionalProperties: false
      properties:
        version:
          type: string
      type: object
    KEV:
      additionalProperties: false
      properties:
        date_added:
          description: The date the vulnerability was added to the KEV catalog.
          type: string
        date_due:
          description: Per CISA’s Binding Operation Directive 22-01, the date all federal civilian executive branch (FCEB) agencies are required to remediate vulnerabilities in the KEV catalog.
          type: string
        source:
          description: The source checked to determine whether the CVE is in the KEV catalog.
          enum:
            - ""
            - cisa
            - third_party
          type: string
      type: object
    KcodesNetusb:
      additionalProperties: false
      properties:
        capabilities:
          items:
            type: string
          type:
            - array
            - "null"
        device_id:
          type: string
        session_id:
          type: string
        version:
          type: string
      type: object
    KeyAlgorithm:
      additionalProperties: false
      properties:
        name:
          description: Name of public key type, such as RSA or ECDSA. Information specific to the key type is available in the named sub-record.
          type: string
        oid:
          type: string
      type: object
    KeyUsage:
      additionalProperties: false
      properties:
        certificate_sign:
          description: Whether the keyCertSign bit is set.
          type: boolean
        content_commitment:
          description: Whether the contentCommitment (formerly called nonRepudiation) bit is set.
          type: boolean
        crl_sign:
          description: Whether the cRLSign bit is set.
          type: boolean
        data_encipherment:
          description: Whether the dataEncipherment bit is set.
          type: boolean
        decipher_only:
          description: Whether the decipherOnly bit is set.
          type: boolean
        digital_signature:
          description: Whether the digitalSignature bit is set.
          type: boolean
        encipher_only:
          description: Whether the encipherOnly bit is set.
          type: boolean
        key_agreement:
          description: Whether the keyAgreement bit is set.
          type: boolean
        key_encipherment:
          description: Whether the keyEncipherment bit is set.
          type: boolean
        value:
          description: The integer value of the bitmask in the extension.
          format: int32
          minimum: 0
          type: integer
      type: object
    Keycloak:
      additionalProperties: false
      properties:
        grant_types_supported:
          items:
            type: string
          type:
            - array
            - "null"
        id_token_signing_alg_values_supported:
          items:
            type: string
          type:
            - array
            - "null"
        public_key:
          format: hex
          type: string
        realm_base_path:
          type: string
        token_service:
          type: string
      type: object
    Knxip:
      additionalProperties: false
      properties:
        device_info:
          $ref: "#/components/schemas/Knxip_DeviceInfo"
        protocol_version:
          type: string
        response_type:
          type: string
        supported_service_families:
          items:
            $ref: "#/components/schemas/Knxip_ServiceFamily"
          type:
            - array
            - "null"
      type: object
    Knxip_DeviceInfo:
      additionalProperties: false
      properties:
        device_status:
          type: string
        friendly_name:
          type: string
        individual_address:
          type: string
        knx_medium:
          type: string
        mac_address:
          type: string
        multicast_address:
          type: string
        project_installation_id:
          format: int32
          minimum: 0
          type: integer
        serial_number:
          type: string
      type: object
    Knxip_ServiceFamily:
      additionalProperties: false
      properties:
        name:
          type: string
        version:
          format: int32
          minimum: 0
          type: integer
      type: object
    Krpc:
      additionalProperties: false
      properties:
        ping_response_id:
          type: string
      type: object
    Kubernetes:
      additionalProperties: false
      properties:
        endpoints:
          items:
            $ref: "#/components/schemas/Kubernetes_Endpoint"
          type:
            - array
            - "null"
        kubernetes_dashboard_found:
          description: True if the dashboard is running and accessible
          type: boolean
        nodes:
          items:
            $ref: "#/components/schemas/Kubernetes_Node"
          type:
            - array
            - "null"
        pod_names:
          items:
            type: string
          type:
            - array
            - "null"
        roles:
          items:
            $ref: "#/components/schemas/Kubernetes_Role"
          type:
            - array
            - "null"
        version_info:
          $ref: "#/components/schemas/Kubernetes_VersionInfo"
      type: object
    Kubernetes_Endpoint:
      additionalProperties: false
      properties:
        name:
          type: string
        self_link:
          type: string
        subsets:
          items:
            $ref: "#/components/schemas/Kubernetes_Endpoint_Subset"
          type:
            - array
            - "null"
      type: object
    Kubernetes_Endpoint_Subset:
      additionalProperties: false
      properties:
        addresses:
          items:
            $ref: "#/components/schemas/Kubernetes_Endpoint_Subset_EndpointAddress"
          type:
            - array
            - "null"
        ports:
          items:
            $ref: "#/components/schemas/Kubernetes_Endpoint_Subset_Port"
          type:
            - array
            - "null"
      type: object
    Kubernetes_Endpoint_Subset_EndpointAddress:
      additionalProperties: false
      properties:
        hostname:
          type: string
        ip:
          type: string
        node_name:
          type: string
      type: object
    Kubernetes_Endpoint_Subset_Port:
      additionalProperties: false
      properties:
        name:
          type: string
        port:
          format: int32
          minimum: 0
          type: integer
        protocol:
          type: string
      type: object
    Kubernetes_Node:
      additionalProperties: false
      properties:
        addresses:
          items:
            $ref: "#/components/schemas/Kubernetes_Node_NodeAddress"
          type:
            - array
            - "null"
        architecture:
          description: The Architecture reported by the node.
          type: string
        container_runtime_version:
          description: ContainerRuntime Version reported by the node through runtime remote API (e.g. docker://1.5.0).
          type: string
        images:
          description: List of container images on this node
          items:
            type: string
          type:
            - array
            - "null"
        kernel_version:
          description: Kernel Version reported by the node from 'uname -r' (e.g. 3.16.0-0.bpo.4-amd64).
          type: string
        kube_proxy_version:
          description: KubeProxy Version reported by the node.
          type: string
        kubelet_version:
          description: Kubelet Version reported by the node.
          type: string
        name:
          type: string
        operating_system:
          description: The Operating System reported by the node.
          type: string
        os_image:
          description: OS Image reported by the node from /etc/os-release (e.g. Debian GNU/Linux 7 (wheezy)).
          type: string
      type: object
    Kubernetes_Node_NodeAddress:
      additionalProperties: false
      properties:
        address:
          description: Node address, IP/URL.
          type: string
        address_type:
          description: Node address type, one of Hostname, ExternalIP or InternalIP.
          type: string
      type: object
    Kubernetes_Role:
      additionalProperties: false
      properties:
        name:
          type: string
        rules:
          description: Rules set for this role.
          items:
            $ref: "#/components/schemas/Kubernetes_Role_Rule"
          type:
            - array
            - "null"
      type: object
    Kubernetes_Role_Rule:
      additionalProperties: false
      properties:
        api_groups:
          description: APIGroups is the name of the APIGroup that contains the resources. If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be allowed.
          items:
            type: string
          type:
            - array
            - "null"
        resources:
          description: Resources is a list of resources this rule applies to. ResourceAll represents all resources
          items:
            type: string
          type:
            - array
            - "null"
        verbs:
          description: Verbs is a list of Verbs that apply to ALL the ResourceKinds and AttributeRestrictions contained in this rule. VerbAll represents all kinds.
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    Kubernetes_VersionInfo:
      additionalProperties: false
      properties:
        build_date:
          description: Date version was built.
          type: string
        compiler:
          description: Go Compiler used
          type: string
        git_commit:
          description: Git commit version built from.
          type: string
        git_tree_state:
          description: State of the tree when built.
          type: string
        git_version:
          type: string
        go_version:
          description: Version of GO used to build version.
          type: string
        major:
          description: Kubernetes major version
          type: string
        minor:
          description: Kubernetes minor version
          type: string
        platform:
          description: Platform compiled for
          type: string
      type: object
    L2Tp:
      additionalProperties: false
      properties:
        hello_received:
          type: boolean
        ordered_messages_raw:
          items:
            format: utf8
            type: string
          type:
            - array
            - "null"
        sccn_received:
          type: boolean
        sccrp:
          $ref: "#/components/schemas/L2Tp_Sccrp"
        sccrp_received:
          type: boolean
        sccrq_received:
          type: boolean
        stop_sccn:
          $ref: "#/components/schemas/L2Tp_StopCcn"
        stop_sccn_received:
          type: boolean
        zlb_received:
          type: boolean
      type: object
    L2Tp_AttributeValues:
      additionalProperties: false
      properties:
        error_code:
          format: int32
          minimum: 0
          type: integer
        error_meaning:
          type: string
        error_message:
          type: string
        firmware_revision:
          format: int32
          minimum: 0
          type: integer
        hostname:
          type: string
        protocol_revision:
          format: int32
          minimum: 0
          type: integer
        protocol_version:
          format: int32
          minimum: 0
          type: integer
        result_code:
          format: int32
          minimum: 0
          type: integer
        result_meaning:
          type: string
        vendor_name:
          type: string
        window_size:
          format: int32
          minimum: 0
          type: integer
      type: object
    L2Tp_Sccrp:
      additionalProperties: false
      properties:
        attribute_values:
          $ref: "#/components/schemas/L2Tp_AttributeValues"
      type: object
    L2Tp_StopCcn:
      additionalProperties: false
      properties:
        attribute_values:
          $ref: "#/components/schemas/L2Tp_AttributeValues"
      type: object
    Label:
      additionalProperties: false
      properties:
        confidence:
          format: double
          type: number
        evidence:
          items:
            $ref: "#/components/schemas/Evidence"
          type:
            - array
            - "null"
        source:
          enum:
            - ""
            - censys
            - recog
            - wappalyzer
            - third_party
            - html_meta_extractor
          type: string
        value:
          type: string
      type: object
    Ldap:
      additionalProperties: false
      properties:
        allows_anonymous_bind:
          description: Ability to connect with anonymous bind (empty username and password)
          type: boolean
        attributes:
          description: All root DN attributes available via anonymous bind
          items:
            $ref: "#/components/schemas/Ldap_Attribute"
          type:
            - array
            - "null"
        result_code:
          description: Result or error code returned by LDAP instance upon bind
          format: int32
          minimum: 0
          type: integer
      type: object
    Ldap_Attribute:
      additionalProperties: false
      properties:
        name:
          description: Name of the LDAP attribute in the root DN
          type: string
        values:
          description: Values for the respective LDAP attribute
          items:
            format: utf8
            type: string
          type:
            - array
            - "null"
      type: object
    Libp2P:
      additionalProperties: false
      properties:
        advertised_protocols:
          items:
            type: string
          type:
            - array
            - "null"
        multistream_version:
          type: string
      type: object
    ListCollectionsResponseV1:
      additionalProperties: false
      properties:
        collections:
          items:
            $ref: "#/components/schemas/Collection"
          type:
            - array
            - "null"
        next_page_token:
          type: string
      required:
        - collections
        - next_page_token
      type: object
    ListRiskEventsResponse:
      additionalProperties: false
      properties:
        next_page_token:
          description: Pagination token for the next page of results, if any.
          type: string
        risk_events:
          description: Risk events in commit order.
          items:
            $ref: "#/components/schemas/RiskEvent"
          type:
            - array
            - "null"
        supplier_ids:
          description: The supplier(s) these events belong to. Omitted when the page has no events.
          items:
            type: string
          type:
            - array
            - "null"
        supply_chain_id:
          description: The supply chain this listing was scoped to, resolved from 'default' if that was given.
          format: uuid
          type: string
      required:
        - supply_chain_id
        - risk_events
      type: object
    ListRisksPayload:
      additionalProperties: false
      properties:
        next_page_token:
          description: Pagination token for the next page of results, if any.
          type: string
        risks:
          description: Risks matching the given search criteria.
          items:
            $ref: "#/components/schemas/SupplyChainRisk"
          type:
            - array
            - "null"
      required:
        - risks
      type: object
    ListSuppliersPayload:
      additionalProperties: false
      properties:
        next_page_token:
          description: Pagination token for the next page of results, if any.
          type: string
        suppliers:
          description: Suppliers in the supply chain.
          items:
            $ref: "#/components/schemas/SupplyChainSupplier"
          type:
            - array
            - "null"
      required:
        - suppliers
      type: object
    Location:
      additionalProperties: false
      properties:
        city:
          description: The English name of the detected city.
          type: string
        continent:
          description: The English name of the detected continent (North America, Europe, Asia, South America, Africa, Oceania, Antarctica).
          type: string
        coordinates:
          $ref: "#/components/schemas/Coordinates"
          description: The estimated coordinates of the detected location.
        country:
          description: The English name of the detected country.
          type: string
        country_code:
          description: The detected two-letter ISO 3166-1 alpha-2 country code (US, CN, GB, RU, ...).
          type: string
        postal_code:
          description: The postal code (if applicable) of the detected location.
          type: string
        province:
          description: The state or province name of the detected location.
          type: string
        registered_country:
          description: The English name of the registered country.
          type: string
        registered_country_code:
          description: The registered country's two-letter ISO 3166-1 alpha-2 country code (US, CN, GB, RU, ...).
          type: string
        timezone:
          description: The IANA time zone database name of the detected location.
          type: string
      type: object
    LocationUpdated:
      additionalProperties: false
      properties:
        location:
          $ref: "#/components/schemas/Location"
      type: object
    Lpd:
      additionalProperties: false
      properties:
        jobs:
          $ref: "#/components/schemas/LpdMessage"
        long_state:
          type: string
        lpd_message:
          $ref: "#/components/schemas/LpdMessage"
        printer:
          type: string
        raw:
          type: string
        short_state:
          type: string
        text:
          type: string
      type: object
    LpdMessage:
      additionalProperties: false
      properties:
        body:
          format: base64
          type: string
        status:
          format: int32
          minimum: 0
          type: integer
      type: object
    MalloryAI:
      additionalProperties: false
      properties:
        created_at:
          type: string
        first_seen_at:
          type: string
        last_seen_at:
          type: string
        observable:
          $ref: "#/components/schemas/MalloryAI_Observable"
        opinions:
          items:
            $ref: "#/components/schemas/MalloryAI_Opinion"
          type:
            - array
            - "null"
        source_count:
          format: int64
          type: integer
        updated_at:
          type: string
        uuid:
          type: string
        verdict_summary:
          $ref: "#/components/schemas/MalloryAI_VerdictSummary"
      type: object
    MalloryAI_Observable:
      additionalProperties: false
      properties:
        attributes:
          type: string
        created_at:
          type: string
        description:
          type: string
        name:
          type: string
        type:
          type: string
        updated_at:
          type: string
        uuid:
          type: string
      type: object
    MalloryAI_Opinion:
      additionalProperties: false
      properties:
        attributes:
          $ref: "#/components/schemas/MalloryAI_Opinion_Attributes"
        confidence:
          type: string
        created_at:
          type: string
        description:
          type: string
        published_at:
          type: string
        reference_source_slug:
          type: string
        reference_url:
          type: string
        reference_uuid:
          type: string
        source:
          type: string
        updated_at:
          type: string
        uuid:
          type: string
        verdict:
          type: string
      type: object
    MalloryAI_Opinion_Attributes:
      additionalProperties: false
      properties:
        associated_malware:
          items:
            type: string
          type:
            - array
            - "null"
        associated_threat_actors:
          items:
            type: string
          type:
            - array
            - "null"
        associated_vulnerabilities:
          items:
            type: string
          type:
            - array
            - "null"
        tags:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    MalloryAI_VerdictSummary:
      additionalProperties: false
      properties:
        malicious:
          format: int64
          type: integer
        suspicious:
          format: int64
          type: integer
      type: object
    Managesieve:
      additionalProperties: false
      properties:
        implementation:
          type: string
        language:
          type: string
        max_redirects:
          format: int32
          type: integer
        notify_methods:
          items:
            type: string
          type:
            - array
            - "null"
        ok_greeting:
          type: string
        sasl_mechanisms:
          items:
            type: string
          type:
            - array
            - "null"
        sieve_extensions:
          items:
            type: string
          type:
            - array
            - "null"
        starttls:
          type: boolean
        version:
          type: string
      type: object
    ManticoreSphinxapi:
      additionalProperties: false
      properties:
        release_band:
          type: string
        status:
          items:
            $ref: "#/components/schemas/ManticoreSphinxapi_StatusEntry"
          type:
            - array
            - "null"
        status_row_count:
          format: int32
          minimum: 0
          type: integer
      type: object
    ManticoreSphinxapi_StatusEntry:
      additionalProperties: false
      properties:
        key:
          type: string
        value:
          type: string
      type: object
    MatchedService:
      additionalProperties: false
      properties:
        port:
          format: int32
          minimum: 0
          type: integer
        protocol:
          type: string
        transport_protocol:
          enum:
            - ""
            - tcp
            - udp
            - icmp
            - quic
          type: string
      type: object
    Mavlink:
      additionalProperties: false
      properties:
        frames:
          items:
            $ref: "#/components/schemas/Mavlink_Frame"
          type:
            - array
            - "null"
        saw_pong:
          type: boolean
      type: object
    Mavlink_Frame:
      additionalProperties: false
      properties:
        component_id:
          format: int32
          minimum: 0
          type: integer
        message_id:
          format: int32
          minimum: 0
          type: integer
        message_type:
          type: string
        payload:
          format: hex
          type: string
        system_id:
          format: int32
          minimum: 0
          type: integer
        version:
          format: int32
          minimum: 0
          type: integer
      type: object
    Mcp:
      additionalProperties: false
      properties:
        prompts:
          items:
            $ref: "#/components/schemas/McpPrompt"
          type:
            - array
            - "null"
        protocol_version:
          type: string
        resources:
          items:
            $ref: "#/components/schemas/McpResource"
          type:
            - array
            - "null"
        server_name:
          type: string
        server_version:
          type: string
        tools:
          items:
            $ref: "#/components/schemas/McpTool"
          type:
            - array
            - "null"
      type: object
    McpPrompt:
      additionalProperties: false
      properties:
        name:
          type: string
      type: object
    McpResource:
      additionalProperties: false
      properties:
        content:
          type: string
        description:
          type: string
        mime_type:
          type: string
        name:
          type: string
        uri:
          type: string
      type: object
    McpTool:
      additionalProperties: false
      properties:
        description:
          type: string
        name:
          type: string
      type: object
    Mdns:
      additionalProperties: false
      properties:
        multiple_responses:
          type: boolean
        names:
          items:
            type: string
          type:
            - array
            - "null"
        results:
          items:
            $ref: "#/components/schemas/MdnsResult"
          type:
            - array
            - "null"
      type: object
    MdnsResult:
      additionalProperties: false
      properties:
        addresses:
          items:
            type: string
          type:
            - array
            - "null"
        full_name:
          type: string
        port:
          format: int32
          type: integer
        priority:
          format: int32
          type: integer
        target:
          type: string
        texts:
          items:
            type: string
          type:
            - array
            - "null"
        weight:
          format: int32
          type: integer
      type: object
    MediaCapabilities:
      additionalProperties: false
      properties:
        osd:
          type: boolean
        profile:
          $ref: "#/components/schemas/MediaProfile"
        rotation:
          type: boolean
        snapshot_uri:
          type: boolean
        streaming:
          $ref: "#/components/schemas/MediaStreaming"
        video_source_mode:
          type: boolean
      type: object
    MediaProfile:
      additionalProperties: false
      properties:
        max_profile_count:
          format: int32
          minimum: 0
          type: integer
      type: object
    MediaStreaming:
      additionalProperties: false
      properties:
        non_aggregate_control:
          type: boolean
        rtp_multicast:
          type: boolean
        rtp_rtsp_tcp:
          type: boolean
        rtp_tcp:
          type: boolean
      type: object
    Melsec:
      additionalProperties: false
      properties:
        cpu_info:
          type: string
      type: object
    MemberCounts:
      additionalProperties: false
      properties:
        by_role:
          description: The number of users in the organization, split by Platform-wide role.
          properties:
            admin:
              description: The number of users with the admin role.
              format: int64
              type: integer
            api_access:
              description: The number of users with the API access role.
              format: int64
              type: integer
          type: object
        total:
          description: The total number of users in the organization.
          format: int64
          type: integer
      required:
        - total
        - by_role
      type: object
    MemberModuleRole:
      additionalProperties: false
      properties:
        module:
          description: The module identifier, for example platform-search.
          type: string
        module_display_name:
          description: The display name of the module.
          type: string
        role:
          description: The role the user holds in the module, for example gs_analyst.
          type: string
        role_display_name:
          description: The display name of the role.
          type: string
      required:
        - module
        - module_display_name
        - role
        - role_display_name
      type: object
    Memberlist:
      additionalProperties: false
      properties:
        encrypted:
          type: boolean
        encrypted_len:
          format: int32
          minimum: 0
          type: integer
        encryption_version:
          format: int32
          minimum: 0
          type: integer
        error_message:
          type: string
        node:
          $ref: "#/components/schemas/Memberlist_NodeInfo"
      type: object
    Memberlist_NodeInfo:
      additionalProperties: false
      properties:
        delegate_versions:
          items:
            format: int32
            minimum: 0
            type: integer
          type:
            - array
            - "null"
        incarnation:
          format: int32
          minimum: 0
          type: integer
        ip:
          type: string
        meta:
          format: base64
          type: string
        name:
          type: string
        port:
          format: int32
          minimum: 0
          type: integer
        protocol_version:
          format: int32
          minimum: 0
          type: integer
      type: object
    Members:
      additionalProperties: false
      properties:
        client_urls:
          items:
            type: string
          type:
            - array
            - "null"
        id:
          type: string
        name:
          type: string
        peer_urls:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    Memcached:
      additionalProperties: false
      properties:
        ascii_binding_protocol_enabled:
          description: Whether server responds to a handshake using the ASCII wire format of the protocol.
          type: boolean
        binary_binding_protocol_enabled:
          description: Whether server responds to a handshake using the binary wire format of the protocol.
          type: boolean
        responds_to_udp:
          description: Whether the server on the UDP port with the same number responds to a handshake using the ASCII wire format of the protocol.
          type: boolean
        stats:
          additionalProperties:
            type: string
          description: Server information returned in response to the stats command, as a set of key:value pairs.
          type: object
        version:
          description: The Memcached version indicated in the server's response.
          type: string
      type: object
    Metrics:
      additionalProperties: false
      properties:
        cvss_v30:
          $ref: "#/components/schemas/CVSS"
        cvss_v31:
          $ref: "#/components/schemas/CVSS"
        cvss_v40:
          $ref: "#/components/schemas/CVSSv4"
        epss:
          $ref: "#/components/schemas/EPSS"
      type: object
    MikrotikWinbox:
      additionalProperties: false
      properties:
        components:
          items:
            type: string
          type:
            - array
            - "null"
        version:
          type: string
      type: object
    Minecraft:
      additionalProperties: false
      properties:
        motd:
          type: string
        players_max:
          format: int64
          type: integer
        players_online:
          format: int64
          type: integer
        protocol_version:
          type: string
        server_version:
          type: string
      type: object
    Mms:
      additionalProperties: false
      properties:
        model:
          type: string
        revision:
          type: string
        vendor:
          type: string
      type: object
    Modbus:
      additionalProperties: false
      properties:
        exception_response:
          $ref: "#/components/schemas/Modbus_ExceptionResponse"
        function:
          format: int32
          minimum: 0
          type: integer
        mei_response:
          $ref: "#/components/schemas/Modbus_MEIResponse"
        unit_id:
          format: int64
          type: integer
      type: object
    Modbus_ExceptionResponse:
      additionalProperties: false
      properties:
        exception_function:
          format: int32
          minimum: 0
          type: integer
        exception_type:
          format: int32
          minimum: 0
          type: integer
      type: object
    Modbus_MEIResponse:
      additionalProperties: false
      properties:
        conformity_level:
          format: int64
          type: integer
        more_follows:
          type: boolean
        objects:
          additionalProperties:
            type: string
          type: object
      type: object
    ModuleRoleOption:
      additionalProperties: false
      properties:
        display_name:
          description: The display name of the role.
          type: string
        role:
          description: The role identifier.
          type: string
      required:
        - role
        - display_name
      type: object
    MoneroP2P:
      additionalProperties: false
      properties:
        ping_response:
          $ref: "#/components/schemas/MoneroP2P_PingResponse"
      type: object
    MoneroP2P_Entry:
      additionalProperties: false
      properties:
        data:
          type: string
        name:
          type: string
      type: object
    MoneroP2P_Payload:
      additionalProperties: false
      properties:
        entries:
          items:
            $ref: "#/components/schemas/MoneroP2P_Entry"
          type:
            - array
            - "null"
      type: object
    MoneroP2P_PingResponse:
      additionalProperties: false
      properties:
        payload:
          $ref: "#/components/schemas/MoneroP2P_Payload"
        response_header:
          $ref: "#/components/schemas/MoneroP2P_ResponseHeader"
      type: object
    MoneroP2P_ResponseHeader:
      additionalProperties: false
      properties:
        command:
          format: int32
          minimum: 0
          type: integer
        expects_response:
          type: boolean
        flags:
          format: int32
          minimum: 0
          type: integer
        length:
          format: int32
          minimum: 0
          type: integer
        return_code:
          format: int32
          type: integer
        signature:
          format: int64
          minimum: 0
          type: integer
        version:
          format: int32
          minimum: 0
          type: integer
      type: object
    Mongodb:
      additionalProperties: false
      properties:
        build_info:
          $ref: "#/components/schemas/Mongodb_BuildInfo"
        is_master:
          $ref: "#/components/schemas/Mongodb_IsMaster"
      type: object
    Mongodb_BuildInfo:
      additionalProperties: false
      properties:
        build_environment:
          $ref: "#/components/schemas/Mongodb_BuildInfo_BuildEnvironment"
        git_version:
          description: Version of mongodb server
          type: string
        version:
          description: Version of mongodb server
          type: string
      type: object
    Mongodb_BuildInfo_BuildEnvironment:
      additionalProperties: false
      properties:
        cc:
          type: string
        cc_flags:
          type: string
        cxx:
          type: string
        cxx_flags:
          type: string
        dist_arch:
          type: string
        dist_mod:
          type: string
        link_flags:
          type: string
        target_arch:
          type: string
        target_os:
          type: string
      type: object
    Mongodb_IsMaster:
      additionalProperties: false
      properties:
        is_master:
          type: boolean
        logical_session_timeout_minutes:
          format: int32
          type: integer
        max_bson_object_size:
          format: int32
          type: integer
        max_message_size_bytes:
          format: int32
          type: integer
        max_wire_version:
          format: int32
          type: integer
        max_write_batch_size:
          format: int32
          type: integer
        min_wire_version:
          format: int32
          type: integer
        read_only:
          type: boolean
      type: object
    MplsLdp:
      additionalProperties: false
      properties:
        header:
          $ref: "#/components/schemas/MplsLdp_Header"
        notification:
          $ref: "#/components/schemas/MplsLdp_Notification"
      type: object
    MplsLdp_Header:
      additionalProperties: false
      properties:
        label_space_id:
          format: int32
          minimum: 0
          type: integer
        lsr_id:
          type: string
      type: object
    MplsLdp_Notification:
      additionalProperties: false
      properties:
        message_id:
          format: int32
          minimum: 0
          type: integer
        status_type:
          type: string
      type: object
    Mqtt:
      additionalProperties: false
      properties:
        connection_ack_raw:
          description: Raw CONNACK response packet
          format: hex
          type: string
        connection_ack_return:
          $ref: "#/components/schemas/Mqtt_ConnectionAckReturn"
        subscription_ack_return:
          $ref: "#/components/schemas/Mqtt_SubscriptionAckReturn"
      type: object
    Mqtt_ConnectionAckReturn:
      additionalProperties: false
      properties:
        raw:
          description: Raw connect status value
          format: int32
          minimum: 0
          type: integer
        return_value:
          description: Connection status
          type: string
      type: object
    Mqtt_SubscriptionAckReturn:
      additionalProperties: false
      properties:
        raw:
          description: Raw subscription response value
          format: int32
          minimum: 0
          type: integer
        return_value:
          description: Subscription response
          type: string
      type: object
    Mssql:
      additionalProperties: false
      properties:
        encrypt_mode:
          description: The negotiated ENCRYPT_MODE with the server
          type: string
        instance_name:
          type: string
        prelogin_options:
          $ref: "#/components/schemas/Mssql_PreloginOptions"
        version:
          type: string
      type: object
    Mssql_PreloginOptions:
      additionalProperties: false
      properties:
        encrypt_mode:
          type: string
        fed_auth_required:
          type: boolean
        instance:
          type: string
        mars:
          type: boolean
        nonce:
          format: hex
          type: string
        server_version:
          $ref: "#/components/schemas/Mssql_PreloginOptions_ServerVersion"
        thread_id:
          format: int32
          minimum: 0
          type: integer
        trace_id:
          format: hex
          type: string
        unknown:
          additionalProperties:
            type: string
          format: hex
          type: object
      type: object
    Mssql_PreloginOptions_ServerVersion:
      additionalProperties: false
      properties:
        build_number:
          format: int32
          minimum: 0
          type: integer
        major:
          format: int32
          minimum: 0
          type: integer
        minor:
          format: int32
          minimum: 0
          type: integer
      type: object
    Murmur:
      additionalProperties: false
      properties:
        crypt_setup:
          $ref: "#/components/schemas/CryptSetup"
        murmur_messages:
          items:
            $ref: "#/components/schemas/MurmurMessage"
          type:
            - array
            - "null"
        reject:
          $ref: "#/components/schemas/Reject"
        server_config:
          $ref: "#/components/schemas/ServerConfig"
        server_sync:
          $ref: "#/components/schemas/ServerSync"
        text_messages:
          items:
            $ref: "#/components/schemas/TextMessage"
          type:
            - array
            - "null"
        version:
          $ref: "#/components/schemas/Murmur_MurmurVersion"
      type: object
    MurmurMessage:
      additionalProperties: false
      properties:
        body:
          format: base64
          type: string
        header:
          $ref: "#/components/schemas/MurmurMessage_MurmurHeader"
      type: object
    MurmurMessage_MurmurHeader:
      additionalProperties: false
      properties:
        length:
          format: int32
          minimum: 0
          type: integer
        type:
          type: string
      type: object
    Murmur_MurmurVersion:
      additionalProperties: false
      properties:
        build:
          format: int32
          minimum: 0
          type: integer
        major:
          format: int32
          minimum: 0
          type: integer
        minor:
          format: int32
          minimum: 0
          type: integer
        os:
          type: string
        os_version:
          type: string
        version_string:
          type: string
      type: object
    Mysql:
      additionalProperties: false
      properties:
        auth_plugin_data:
          description: Optional plugin-specific data, whose meaning depends on the value of auth_plugin_name. Returned in the initial HandshakePacket.
          format: hex
          type: string
        auth_plugin_name:
          description: The name of the authentication plugin, returned in the initial HandshakePacket.
          type: string
        capability_flags:
          additionalProperties:
            type: boolean
          description: "The set of capability flags the server returned in the initial HandshakePacket. Each entry corresponds to a bit being set in the flags; key names correspond to the #defines in the MySQL docs."
          type: object
        character_set:
          description: The identifier for the character set the server is using. Returned in the initial HandshakePacket.
          format: int32
          minimum: 0
          type: integer
        connection_id:
          description: The server's internal identifier for this client's connection, sent in the initial HandshakePacket.
          format: int32
          minimum: 0
          type: integer
        error_code:
          description: Only set if there is an error returned by the server, for example if the scanner is not on the allowed hosts list.
          format: int64
          type: integer
        error_id:
          description: The friendly name for the error code as defined at https://dev.mysql.com/doc/refman/8.0/en/error-messages-server.html, or UNKNOWN
          type: string
        error_message:
          description: Optional string describing the error. Only set if there is an error.
          type: string
        protocol_version:
          description: 8-bit unsigned integer representing the server's protocol version sent in the initial HandshakePacket from the server.
          format: int32
          minimum: 0
          type: integer
        server_version:
          description: The specific server version returned in the initial HandshakePacket. Often in the form x.y.z, but not always.
          type: string
        status_flags:
          additionalProperties:
            type: boolean
          description: "The set of status flags the server returned in the initial HandshakePacket. Each entry corresponds to a bit being set in the flags; key names correspond to the #defines in the MySQL docs."
          type: object
      type: object
    Mysqlx:
      additionalProperties: false
      properties:
        auth_mechanisms:
          items:
            type: string
          type:
            - array
            - "null"
        capabilities:
          items:
            type: string
          type:
            - array
            - "null"
        compression_algorithms:
          items:
            type: string
          type:
            - array
            - "null"
        doc_format:
          type: string
        node_type:
          type: string
        tls_supported:
          type: boolean
      type: object
    NameConstraints:
      additionalProperties: false
      properties:
        critical:
          type: boolean
        excluded_directory_names:
          description: A record providing excluded names of the type directoryName in leaf certificates whose trust path includes this certificate.
          items:
            $ref: "#/components/schemas/DistinguishedName"
          type:
            - array
            - "null"
        excluded_edi_party_names:
          description: A record providing excluded names of the type ediPartyName in leaf certificates whose trust path includes this certificate.
          items:
            $ref: "#/components/schemas/EdiPartyName"
          type:
            - array
            - "null"
        excluded_email_addresses:
          description: A record providing a range of excluded names of the type rfc822Name in leaf certificates whose trust path includes this certificate.
          items:
            type: string
          type:
            - array
            - "null"
        excluded_ip_addresses:
          description: A record providing a range of excluded names of the type iPAddress in leaf certificates whose trust path includes this certificate.
          items:
            $ref: "#/components/schemas/GeneralSubtreeIp"
          type:
            - array
            - "null"
        excluded_names:
          description: A record providing a range of excluded names of the type dNSName in leaf certificates whose trust path includes this certificate.
          items:
            type: string
          type:
            - array
            - "null"
        excluded_registered_ids:
          description: A record providing excluded names of the type registeredID in leaf certificates whose trust path includes this certificate.
          items:
            type: string
          type:
            - array
            - "null"
        excluded_uris:
          description: A record providing a range of excluded uniform resource identifiers in leaf certificates whose trust path includes this certificate.
          items:
            type: string
          type:
            - array
            - "null"
        permitted_directory_names:
          description: A record providing permitted names of the type directoryName in leaf certificates whose trust path includes this certificate.
          items:
            $ref: "#/components/schemas/DistinguishedName"
          type:
            - array
            - "null"
        permitted_edi_party_names:
          description: A record providing permitted names of the type ediPartyName in leaf certificates whose trust path includes this certificate.
          items:
            $ref: "#/components/schemas/EdiPartyName"
          type:
            - array
            - "null"
        permitted_email_addresses:
          description: A record providing a range of permitted names of the type rfc822Name in leaf certificates whose trust path includes this certificate.
          items:
            type: string
          type:
            - array
            - "null"
        permitted_ip_addresses:
          description: A record providing a range of permitted names of the type iPAddress in leaf certificates whose trust path includes this certificate.
          items:
            $ref: "#/components/schemas/GeneralSubtreeIp"
          type:
            - array
            - "null"
        permitted_names:
          description: A record providing a range of permitted names of the type dNSName in leaf certificates whose trust path includes this certificate.
          items:
            type: string
          type:
            - array
            - "null"
        permitted_registered_ids:
          description: A record providing permitted names of the type registeredID in leaf certificates whose trust path includes this certificate.
          items:
            type: string
          type:
            - array
            - "null"
        permitted_uris:
          description: A record providing a range of permitted uniform resource identifiers in leaf certificates whose trust path includes this certificate.
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    NatsIo:
      additionalProperties: false
      properties:
        auth_required:
          type: boolean
        cluster:
          type: string
        connect_urls:
          items:
            type: string
          type:
            - array
            - "null"
        domain:
          type: string
        git_commit:
          type: string
        go:
          type: string
        headers:
          type: boolean
        jetstream:
          type: boolean
        proto:
          format: int32
          type: integer
        server_id:
          type: string
        server_name:
          type: string
        tls_available:
          type: boolean
        tls_required:
          type: boolean
        tls_verify:
          type: boolean
        version:
          type: string
        ws_connect_urls:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    Nbd:
      additionalProperties: false
      properties:
        exports:
          items:
            $ref: "#/components/schemas/Export"
          type:
            - array
            - "null"
        handshake_style:
          type: string
        policies:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    NetflixNrdp:
      additionalProperties: false
      properties:
        version:
          type: string
      type: object
    Network:
      additionalProperties: false
      properties:
        allocation_type:
          type: string
        cidrs:
          description: A set of CIDRs describing the range.
          items:
            type: string
          type:
            - array
            - "null"
        created:
          type: string
        handle:
          type: string
        name:
          type: string
        updated:
          type: string
      type: object
    NetworkCapabilities:
      additionalProperties: false
      properties:
        dhcp_v6:
          type: boolean
        dot11_configuration:
          type: boolean
        dot1x_configurations:
          format: int32
          minimum: 0
          type: integer
        dynamic_dns:
          type: boolean
        hostname_from_dhcp:
          type: boolean
        ip_filter:
          type: boolean
        ipv6:
          type: boolean
        ntp:
          format: int32
          minimum: 0
          type: integer
        zero_configuration:
          type: boolean
      type: object
    NetworkClassification:
      additionalProperties: false
      properties:
        hosting:
          description: Whether the host belongs to an Internet hosting service provider.
          type: boolean
        mobile:
          description: Whether the host belongs to a mobile network.
          type: boolean
        mobile_info:
          $ref: "#/components/schemas/Network_MobileInfo"
          description: Information about the mobile network the host belongs to, if any.
        satellite:
          description: Whether the host belongs to a statellite network.
          type: boolean
        source:
          description: The source of the data.
          type: string
      type: object
    NetworkLog:
      additionalProperties: false
      properties:
        har_handle:
          description: Storage handle for the full HAR network log.
          type: string
        resources:
          description: Resources fetched during page load.
          items:
            $ref: "#/components/schemas/NetworkLog_ResourceInfo"
          type:
            - array
            - "null"
      type: object
    NetworkLog_ResourceInfo:
      additionalProperties: false
      properties:
        host:
          description: Hostname from the URL.
          type: string
        md5:
          description: MD5 hash of the resource content.
          format: hex
          type: string
        mime_type:
          description: MIME type of the resource.
          type: string
        path:
          description: Path from the URL.
          type: string
        port:
          description: Port from the URL.
          type: string
        scheme:
          description: URL scheme (e.g., http, https).
          type: string
        sha1:
          description: SHA-1 hash of the resource content.
          format: hex
          type: string
        sha256:
          description: SHA-256 hash of the resource content.
          format: hex
          type: string
        size:
          description: Size of the resource in bytes.
          format: int32
          type: integer
        url:
          description: Full URL of the resource.
          type: string
      type: object
    Network_MobileInfo:
      additionalProperties: false
      properties:
        carrier_name:
          description: The name of the mobile carrier.
          type: string
        mcc:
          description: The Mobile Country Code, identifying the country of the mobile network.
          type: string
        mnc:
          description: The Mobile Network Code, identifying the specific carrier network.
          type: string
      type: object
    NfsMountd:
      additionalProperties: false
      properties:
        export_lists:
          items:
            $ref: "#/components/schemas/ExportList"
          type:
            - array
            - "null"
      type: object
    NginxProxyManager:
      additionalProperties: false
      properties:
        setup:
          type: boolean
        version:
          type: string
      type: object
    Nmea:
      additionalProperties: false
      properties:
        messages:
          items:
            $ref: "#/components/schemas/Nmea_NmeaMessage"
          type:
            - array
            - "null"
      type: object
    Nmea_NmeaMessage:
      additionalProperties: false
      properties:
        fields:
          items:
            type: string
          type:
            - array
            - "null"
        sentence_id:
          type: string
        talker_id:
          type: string
        talker_name:
          type: string
      type: object
    NodeInfoV0:
      additionalProperties: false
      properties:
        features:
          items:
            type: string
          type:
            - array
            - "null"
        is_healthy:
          type: boolean
        latest_milestone:
          format: int64
          type: integer
        latest_uncommitted_milestone:
          format: int64
          type: integer
        name:
          type: string
        neighbors:
          format: int64
          type: integer
        tips:
          format: int64
          type: integer
        version:
          type: string
      type: object
    NodeInfoV1:
      additionalProperties: false
      properties:
        confirmed_milestone_index:
          format: int64
          type: integer
        features:
          items:
            type: string
          type:
            - array
            - "null"
        is_healthy:
          type: boolean
        latest_milestone_index:
          format: int64
          type: integer
        name:
          type: string
        network_id:
          type: string
        version:
          type: string
      type: object
    NodeInfoV2:
      additionalProperties: false
      properties:
        decimals:
          format: int64
          type: integer
        features:
          items:
            type: string
          type:
            - array
            - "null"
        is_healthy:
          type: boolean
        latest_milestone:
          format: int64
          type: integer
        latest_uncommitted_milestone:
          format: int64
          type: integer
        name:
          type: string
        network_name:
          type: string
        protocol_version:
          format: int64
          type: integer
        subunit:
          type: string
        supported_protocol_versions:
          items:
            format: int64
            type: integer
          type:
            - array
            - "null"
        ticker_symbol:
          type: string
        token_name:
          type: string
        token_supply:
          type: string
        unit:
          type: string
        version:
          type: string
      type: object
    NoticeReference:
      additionalProperties: false
      properties:
        notice_numbers:
          items:
            format: int32
            type: integer
          type:
            - array
            - "null"
        organization:
          type: string
      type: object
    Nrpe:
      additionalProperties: false
      properties:
        packet_version:
          format: int32
          type: integer
        version:
          type: string
      type: object
    NtlmInfo:
      additionalProperties: false
      properties:
        always_sign_supported:
          type: boolean
        challenge_type:
          format: int32
          type: integer
        dns_domain_name:
          type: string
        dns_server_name:
          type: string
        dns_tree_name:
          type: string
        encryption_128bit_supported:
          type: boolean
        encryption_56bit_supported:
          type: boolean
        netbios_computer_name:
          type: string
        netbios_domain_name:
          type: string
        ntlm1_supported:
          type: boolean
        ntlm2_supported:
          type: boolean
        ntlm_version:
          format: int32
          minimum: 0
          type: integer
        os_version:
          type: string
        target_name:
          type: string
      type: object
    Ntp:
      additionalProperties: false
      properties:
        get_time_header:
          $ref: "#/components/schemas/Ntp_NTPHeader"
          description: The header of the server's response to a GetTime request.
      type: object
    Ntp_NTPHeader:
      additionalProperties: false
      properties:
        leap_indicator:
          description: An enumerated value from 0 to 3 signifying whether a leap second will occur at the end of the current month. 0 signifies no leap second, 1 signifies an additive leap second, 2 signifies a subtractive leap second, and 3 signifies the state is unknown.
          format: int32
          minimum: 0
          type: integer
        mode:
          description: An enumerated value from 0 to 7 signifying the operational mode of the server.
          format: int32
          minimum: 0
          type: integer
        poll:
          description: The interval within which the server will expect a subsequent synchronization message, in log2 seconds.
          format: int32
          type: integer
        precision:
          description: The precision of the system's clock, in log2 seconds.
          format: int32
          type: integer
        reference_id:
          description: The identifier of the reference clock. For servers in stratum 1, one of an IANA-maintained list of sources. For servers in stratum 2, the ID of the stratum 1 server from which the time was retrieved (usually, its IP address), etc.
          format: hex
          type: string
        stratum:
          description: The number of servers between a client and a non-NTP time source. 1 signifies that the server is authoritative, having direct access to a sensor. 2 signifies that the server got its time from a "stratum 1" server, etc. 16 means the clock is unsynchronized.
          format: int32
          minimum: 0
          type: integer
        version:
          description: The NTP version indicated in the server's response.
          format: int32
          minimum: 0
          type: integer
      type: object
    Ntrip:
      additionalProperties: false
      properties:
        data_streams:
          items:
            $ref: "#/components/schemas/Ntrip_DataStream"
          type:
            - array
            - "null"
        server:
          type: string
        version:
          type: string
      type: object
    Ntrip_DataStream:
      additionalProperties: false
      properties:
        authentication:
          items:
            type: string
          type:
            - array
            - "null"
        bitrate:
          format: int32
          minimum: 0
          type: integer
        carrier_info:
          type: string
        caster_mount_point:
          type: string
        compression_or_encryption:
          type: string
        country_code:
          type: string
        data_format:
          type: string
        fee:
          type: boolean
        format_details:
          type: string
        generator:
          type: string
        latitude:
          type: string
        longitude:
          type: string
        misc:
          type: string
        nav_system:
          type: string
        network:
          type: string
        nmea:
          type: boolean
        solution:
          type: string
        source_identifier:
          type: string
      type: object
    Ollama:
      additionalProperties: false
      properties:
        models:
          items:
            $ref: "#/components/schemas/Ollama_Model"
          type:
            - array
            - "null"
        running_models:
          items:
            $ref: "#/components/schemas/Ollama_Model"
          type:
            - array
            - "null"
        version:
          type: string
      type: object
    Ollama_Model:
      additionalProperties: false
      properties:
        digest:
          type: string
        expires_at:
          type: string
        family:
          type: string
        model:
          type: string
        name:
          type: string
        parent_model:
          type: string
        size:
          format: int64
          minimum: 0
          type: integer
        size_vram:
          format: int64
          minimum: 0
          type: integer
      type: object
    Onc:
      additionalProperties: false
      type: object
    Onvif:
      additionalProperties: false
      properties:
        hostname:
          $ref: "#/components/schemas/Onvif_Hostname"
        services:
          items:
            $ref: "#/components/schemas/OnvifService"
          type:
            - array
            - "null"
      type: object
    OnvifService:
      additionalProperties: false
      properties:
        capabilities:
          $ref: "#/components/schemas/Capabilities"
        namespace:
          type: string
        service_version_major:
          format: int32
          minimum: 0
          type: integer
        service_version_minor:
          format: int32
          minimum: 0
          type: integer
        xaddr:
          type: string
      type: object
    Onvif_Hostname:
      additionalProperties: false
      properties:
        from_dhcp:
          type: boolean
        name:
          type: string
      type: object
    OpcUa:
      additionalProperties: false
      properties:
        endpoints:
          items:
            $ref: "#/components/schemas/OpcUa_Endpoint"
          type:
            - array
            - "null"
        max_chunk_size:
          format: int32
          minimum: 0
          type: integer
        max_message_size:
          format: int32
          minimum: 0
          type: integer
        protocol_version:
          format: int32
          minimum: 0
          type: integer
        receive_buffer_size:
          format: int32
          minimum: 0
          type: integer
        send_buffer_size:
          format: int32
          minimum: 0
          type: integer
      type: object
    OpcUa_Description:
      additionalProperties: false
      properties:
        application_name:
          $ref: "#/components/schemas/OpcUa_LocalizedText"
        application_type:
          format: int32
          minimum: 0
          type: integer
        application_uri:
          type: string
        discovery_profile_uri:
          type: string
        discovery_urls:
          items:
            type: string
          type:
            - array
            - "null"
        gateway_server_uri:
          type: string
        product_uri:
          type: string
      type: object
    OpcUa_Endpoint:
      additionalProperties: false
      properties:
        endpoint_url:
          type: string
        security_level:
          format: int32
          minimum: 0
          type: integer
        security_mode:
          format: int32
          minimum: 0
          type: integer
        security_policy_uri:
          type: string
        serve_cert:
          format: base64
          type: string
        server:
          $ref: "#/components/schemas/OpcUa_Description"
        transport_profile_uri:
          type: string
        user_identity_token:
          items:
            $ref: "#/components/schemas/OpcUa_UserTokenPolicy"
          type:
            - array
            - "null"
      type: object
    OpcUa_LocalizedText:
      additionalProperties: false
      properties:
        flags:
          format: int32
          minimum: 0
          type: integer
        locale:
          type: string
        text:
          type: string
      type: object
    OpcUa_UserTokenPolicy:
      additionalProperties: false
      properties:
        issued_token_type:
          type: string
        issuer_endpoint_url:
          type: string
        policy_id:
          type: string
        security_policy_uri:
          type: string
        token_type:
          format: int32
          type: integer
      type: object
    OpenDirectory:
      additionalProperties: false
      properties:
        files:
          items:
            $ref: "#/components/schemas/OpenDirectory_File"
          type:
            - array
            - "null"
        recursive:
          type: boolean
      type: object
    OpenDirectory_File:
      additionalProperties: false
      properties:
        extension:
          type: string
        last_modified:
          type: string
        name:
          type: string
        path:
          type: string
        size:
          format: int64
          type: integer
        suspicious_score:
          format: double
          type: number
        type:
          type: string
      type: object
    Openflow:
      additionalProperties: false
      properties:
        auxiliary_id:
          format: int32
          minimum: 0
          type: integer
        bare_hello:
          type: boolean
        capabilities:
          items:
            type: string
          type:
            - array
            - "null"
        datapath_id:
          format: int64
          minimum: 0
          type: integer
        datapath_mac:
          type: string
        dp_desc:
          type: string
        hello_elements:
          items:
            $ref: "#/components/schemas/Openflow_HelloElement"
          type:
            - array
            - "null"
        hw_desc:
          type: string
        mfr_desc:
          type: string
        n_buffers:
          format: int32
          minimum: 0
          type: integer
        n_tables:
          format: int32
          minimum: 0
          type: integer
        peer_role:
          type: string
        protocol_version:
          type: string
        protocol_version_raw:
          type: string
        serial_num:
          type: string
        sw_desc:
          type: string
        xid:
          format: int32
          minimum: 0
          type: integer
      type: object
    Openflow_HelloElement:
      additionalProperties: false
      properties:
        element_type:
          type: string
        supported_versions:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    Openvpn:
      additionalProperties: false
      properties:
        accepts_v1:
          type: boolean
        accepts_v2:
          type: boolean
      type: object
    OpenvpnMgmt:
      additionalProperties: false
      properties:
        build_date:
          type: string
        features:
          items:
            type: string
          type:
            - array
            - "null"
        management_version:
          type: string
        open_vpn_version:
          type: string
        target_triple:
          type: string
      type: object
    OpwFsc3000:
      additionalProperties: false
      properties:
        site_id:
          type: string
      type: object
    Oracle:
      additionalProperties: false
      properties:
        accept_version:
          description: The version declared by the service when it accepts the handshake, if applicable.
          format: int32
          minimum: 0
          type: integer
        connect_flags0:
          additionalProperties:
            type: boolean
          description: The first set of ConnectFlags returned in the Accept packet.
          type: object
        connect_flags1:
          additionalProperties:
            type: boolean
          description: The second set of ConnectFlags returned in the Accept packet.
          type: object
        did_resend:
          description: Whether the server requested that the scanner resend its initial connection packet.
          type: boolean
        global_service_options:
          additionalProperties:
            type: boolean
          description: Set of flags that the server returns in the Accept packet.
          type: object
        nsn_service_versions:
          additionalProperties:
            type: string
          description: A map from the native Service Negotation service names to the ReleaseVersion (in dotted-decimal format) in that service packet.
          type: object
        nsn_version:
          description: The version string in the root of the native service negotiation packet, if applicable.
          type: string
        refuse_error:
          description: The parsed descriptor returned by the server in the Refuse packet; it is empty if the server does not return a Refuse packet. The keys are strings like 'DESCRIPTION.ERROR_STACK.ERROR.CODE
          items:
            $ref: "#/components/schemas/Oracle_Descriptor"
          type:
            - array
            - "null"
        refuse_error_raw:
          description: The unparsed error received when the initial handshake is refused.
          type: string
        refuse_reason_app:
          description: The 'AppReason' returned by the server in the RefusePacket, as an 8-bit unsigned hex string.
          type: string
        refuse_reason_sys:
          description: The 'SysReason' returned by the server in the RefusePacket, as an 8-bit unsigned hex string.
          type: string
        refuse_version:
          description: The version declared by the service when it refuses the handshake, if applicable.
          type: string
      type: object
    Oracle_Descriptor:
      additionalProperties: false
      properties:
        key:
          description: The dot-delimited path to the parsed value from the error received when the initial handshake is refused.
          type: string
        value:
          description: The parsed value from the error received when the initial handshake is refused.
          type: string
      type: object
    OrencoAtrtu:
      additionalProperties: false
      properties:
        custom_number:
          type: string
        firmware_version:
          type: string
        hostname:
          type: string
        lan_addresses:
          items:
            type: string
          type:
            - array
            - "null"
        panel_status:
          type: string
        quote_number:
          type: string
        site_config:
          type: string
        site_name:
          type: string
      type: object
    Organization:
      additionalProperties: false
      properties:
        abuse_contacts:
          items:
            $ref: "#/components/schemas/Contact"
          type:
            - array
            - "null"
        address:
          type: string
        admin_contacts:
          items:
            $ref: "#/components/schemas/Contact"
          type:
            - array
            - "null"
        city:
          type: string
        country:
          type: string
        handle:
          type: string
        name:
          type: string
        postal_code:
          type: string
        state:
          type: string
        street:
          type: string
        tech_contacts:
          items:
            $ref: "#/components/schemas/Contact"
          type:
            - array
            - "null"
      type: object
    OrganizationCredits:
      additionalProperties: false
      properties:
        auto_replenish_config:
          $ref: "#/components/schemas/AutoReplenishConfig"
          description: The auto-replenish configuration for the organization.
        balance:
          description: The current credit balance for the organization.
          format: int64
          type: integer
        credit_expirations:
          description: The credit expirations for the organization.
          items:
            $ref: "#/components/schemas/CreditExpiration"
          type:
            - array
            - "null"
        uid:
          description: The ID of a Censys organization.
          format: uuid
          type: string
      required:
        - balance
        - auto_replenish_config
        - credit_expirations
        - uid
      type: object
    OrganizationDetails:
      additionalProperties: false
      properties:
        created_at:
          description: The date and time the organization was created.
          format: date-time
          type: string
        member_counts:
          $ref: "#/components/schemas/MemberCounts"
          description: The number of users in the organization, split by Platform-wide role.
        modules:
          description: The modules this organization is entitled to. Only present when include_modules is true; empty when the organization has none.
          items:
            $ref: "#/components/schemas/OrganizationModule"
          type: array
        name:
          description: The name of the organization.
          type: string
        preferences:
          $ref: "#/components/schemas/OrganizationPreferences"
          description: The configured preferences of the organization.
        uid:
          description: The ID of a Censys organization.
          format: uuid
          type: string
      required:
        - name
        - uid
      type: object
    OrganizationMember:
      additionalProperties: false
      properties:
        created_at:
          description: The date and time the user was created.
          format: date-time
          type: string
        email:
          description: The email of the user.
          type: string
        first_login_time:
          description: The date and time the user first logged in.
          format: date-time
          type: string
        first_name:
          description: The first name of the user.
          type: string
        last_name:
          description: The last name of the user.
          type: string
        latest_login_time:
          description: The date and time the user last logged in.
          format: date-time
          type: string
        module_roles:
          description: The module roles this user holds. Empty when the user holds no module roles; absent when module roles could not be retrieved. A role in a module also grants access to the modules included with it; see included_with on the organization's modules.
          items:
            $ref: "#/components/schemas/MemberModuleRole"
          type: array
        roles:
          description: The Platform-wide roles the user has in the organization.
          items:
            type: string
          type:
            - array
            - "null"
        uid:
          description: The ID of a Censys user.
          format: uuid
          type: string
      required:
        - roles
        - email
        - first_name
        - last_name
        - uid
      type: object
    OrganizationMembersList:
      additionalProperties: false
      properties:
        members:
          description: The list of users in the organization.
          items:
            $ref: "#/components/schemas/OrganizationMember"
          type:
            - array
            - "null"
        pagination:
          $ref: "#/components/schemas/PaginationInfo"
          description: Pagination information for listing more users.
      required:
        - members
        - pagination
      type: object
    OrganizationModule:
      additionalProperties: false
      properties:
        display_name:
          description: The display name of the module.
          type: string
        included_with:
          description: The module whose roles grant access to this module, for example platform-search. Present only for modules included with another module, which have no roles or seats of their own.
          type: string
        module:
          description: The module identifier.
          type: string
        roles:
          description: The roles this module offers.
          items:
            $ref: "#/components/schemas/ModuleRoleOption"
          type: array
        seat_limit:
          description: The number of seats the organization may fill in this module. Absent when unlimited or when the module is included with another module.
          format: int64
          type: integer
        seats_assigned:
          description: The number of users currently assigned to this module. Absent when the module is included with another module.
          format: int64
          type: integer
      required:
        - module
        - display_name
        - roles
      type: object
    OrganizationPreferences:
      additionalProperties: false
      properties:
        ai_opt_in:
          description: Whether the organization has opted into AI features.
          type: boolean
        ai_training:
          description: Whether the organization has opted into AI training.
          type: boolean
        mfa_required:
          description: Whether the organization has opted into multi-factor authentication.
          type: boolean
      type: object
    OtherName:
      additionalProperties: false
      properties:
        id:
          description: The OID identifying the syntax of the otherName value.
          type: string
        value:
          description: The raw otherName value.
          format: base64
          type: string
      type: object
    OtlpGrpc:
      additionalProperties: false
      properties:
        proto_version_band:
          type: string
        signals:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    PaginationInfo:
      additionalProperties: false
      properties:
        next_page_token:
          description: The token to use to retrieve the next page of results.
          type: string
        page_size:
          description: The number of results requested per page.
          format: int32
          type: integer
      required:
        - page_size
      type: object
    PanTiltZoomCapabilities:
      additionalProperties: false
      properties:
        eflip:
          type: boolean
        get_compatible_configurations:
          type: boolean
        move_status:
          type: boolean
        reverse:
          type: boolean
        status_position:
          type: boolean
      type: object
    PcAnywhere:
      additionalProperties: false
      properties:
        name:
          description: Workstation Name, with padding bytes removed
          type: string
        nr:
          description: Full 'NR' query response
          type: string
        status:
          $ref: "#/components/schemas/PcAnywhere_Status"
      type: object
    PcAnywhere_Status:
      additionalProperties: false
      properties:
        in_use:
          description: Workstation is In Use if true, Available if false
          type: boolean
        raw:
          description: Full 'ST' query response
          format: hex
          type: string
      type: object
    Peer:
      additionalProperties: false
      properties:
        ip:
          type: string
        port:
          format: int64
          type: integer
        public_key:
          type: string
        type:
          type: string
        version:
          type: string
      type: object
    PerforceP4D:
      additionalProperties: false
      properties:
        info:
          $ref: "#/components/schemas/PerforceP4D_Info"
        protocol:
          $ref: "#/components/schemas/PerforceP4D_Protocol"
      type: object
    PerforceP4D_Info:
      additionalProperties: false
      properties:
        case_handling:
          type: string
        server_addr:
          type: string
        server_build_date:
          type: string
        server_changelist:
          type: string
        server_license:
          type: string
        server_platform:
          type: string
        server_release:
          type: string
        server_root:
          type: string
        server_timezone:
          type: string
        server_uptime:
          type: string
        server_version:
          type: string
      type: object
    PerforceP4D_Protocol:
      additionalProperties: false
      properties:
        auto_tune:
          type: string
        security_level_name:
          type: string
        server_id:
          type: string
        server_protocol:
          type: string
        server_sub_protocol:
          type: string
        tz_offset:
          type: string
      type: object
    Pgbouncer:
      additionalProperties: false
      properties:
        startup_capabilities:
          $ref: "#/components/schemas/Pgbouncer_StartupCapabilities"
      type: object
    Pgbouncer_StartupCapabilities:
      additionalProperties: false
      properties:
        v2:
          type: boolean
        v3:
          type: boolean
        v4:
          type: boolean
      type: object
    Pigeonhole:
      additionalProperties: false
      properties:
        implementation:
          type: string
        language:
          type: string
        max_redirects:
          format: int32
          type: integer
        notify_methods:
          items:
            type: string
          type:
            - array
            - "null"
        ok_greeting:
          type: string
        sasl_mechanisms:
          items:
            type: string
          type:
            - array
            - "null"
        sieve_extensions:
          items:
            type: string
          type:
            - array
            - "null"
        starttls:
          type: boolean
        version:
          type: string
      type: object
    PixelFormat:
      additionalProperties: false
      properties:
        big_endian:
          description: If pixel RGB data are in big-endian
          type: boolean
        bits_per_pixel:
          description: "How many bits in a single full pixel datum. Valid values are: 8, 16, 32"
          format: int32
          minimum: 0
          type: integer
        blue_max:
          description: Max value of blue pixel
          format: int32
          minimum: 0
          type: integer
        blue_shift:
          description: How many bits to right shift a pixel datum to get blue bits in lsb
          format: int32
          minimum: 0
          type: integer
        depth:
          description: Color depth
          format: int32
          minimum: 0
          type: integer
        green_max:
          description: Max value of green pixel
          format: int32
          minimum: 0
          type: integer
        green_shift:
          description: How many bits to right shift a pixel datum to get green bits in lsb
          format: int32
          minimum: 0
          type: integer
        padding1:
          format: int32
          minimum: 0
          type: integer
        padding2:
          format: int32
          minimum: 0
          type: integer
        padding3:
          format: int32
          minimum: 0
          type: integer
        red_max:
          description: Max value of red pixel
          format: int32
          minimum: 0
          type: integer
        red_shift:
          description: How many bits to right shift a pixel datum to get red bits in lsb
          format: int32
          minimum: 0
          type: integer
        true_color:
          description: If false, color maps are used
          type: boolean
      type: object
    PlexMediaServer:
      additionalProperties: false
      properties:
        version:
          type: string
      type: object
    Pop3:
      additionalProperties: false
      properties:
        start_tls:
          description: The server's response to the STARTTLS command.
          format: utf8
          type: string
      type: object
    Port:
      additionalProperties: false
      properties:
        port:
          type: string
        protocol:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    Portmap:
      additionalProperties: false
      properties:
        v2_entries:
          items:
            $ref: "#/components/schemas/Portmap_V2Entry"
          type:
            - array
            - "null"
        v3_entries:
          items:
            $ref: "#/components/schemas/Portmap_V3Entry"
          type:
            - array
            - "null"
      type: object
    Portmap_V2Entry:
      additionalProperties: false
      properties:
        description:
          type: string
        port:
          format: int32
          minimum: 0
          type: integer
        protocol:
          type: string
        shorthand:
          type: string
        version:
          format: int32
          minimum: 0
          type: integer
      type: object
    Portmap_V3Entry:
      additionalProperties: false
      properties:
        description:
          type: string
        network_id:
          type: string
        owner:
          type: string
        shorthand:
          type: string
        universal_address:
          type: string
        version:
          format: int32
          minimum: 0
          type: integer
      type: object
    Postgres:
      additionalProperties: false
      properties:
        protocol_error:
          additionalProperties:
            type: string
          description: The error received in response to a StartupMessage with an unexpected protocol version.
          type: object
        startup_error:
          additionalProperties:
            type: string
          description: The error received in response to a StartupMessage without providing the User field.
          type: object
        supported_versions:
          type: string
      type: object
    Pprof:
      additionalProperties: false
      properties:
        allocs:
          format: int32
          type: integer
        block:
          format: int32
          type: integer
        cmdline:
          type: string
        goroutine:
          format: int32
          type: integer
        heap:
          format: int32
          type: integer
        mutex:
          format: int32
          type: integer
        profile:
          format: int32
          type: integer
        threadcreate:
          format: int32
          type: integer
        trace:
          format: int32
          type: integer
      type: object
    Pptp:
      additionalProperties: false
      properties:
        bearer_message:
          $ref: "#/components/schemas/Pptp_ResponseInfo"
        error_message:
          $ref: "#/components/schemas/Pptp_ResponseInfo"
        firmware:
          $ref: "#/components/schemas/Pptp_Version"
        framing_message:
          $ref: "#/components/schemas/Pptp_ResponseInfo"
        hostname:
          type: string
        maximum_channels:
          format: int32
          minimum: 0
          type: integer
        protocol:
          $ref: "#/components/schemas/Pptp_Version"
        result_message:
          $ref: "#/components/schemas/Pptp_ResponseInfo"
        vendor:
          type: string
      type: object
    Pptp_ResponseInfo:
      additionalProperties: false
      properties:
        code:
          format: int32
          minimum: 0
          type: integer
        meaning:
          type: string
      type: object
    Pptp_Version:
      additionalProperties: false
      properties:
        major:
          format: int32
          minimum: 0
          type: integer
        minor:
          format: int32
          minimum: 0
          type: integer
      type: object
    Privacy:
      additionalProperties: false
      properties:
        anonymous:
          description: Whether the host uses any kind of privacy service.
          type: boolean
        proxy:
          description: Whether the host is an open web proxy.
          type: boolean
        relay:
          description: Whether the host is a location-preserving anonymous relay service, like iCloud Private Relay..
          type: boolean
        service_provider:
          description: The name of the privacy service providers detected.
          items:
            type: string
          type:
            - array
            - "null"
        source:
          description: The source of the data.
          type: string
        tor:
          description: Whether the host is a Tor exit node.
          type: boolean
        tor_info:
          $ref: "#/components/schemas/Privacy_TorInfo"
          description: Information about the Tor exit node, if the host is one.
        vpn:
          description: Whether the host is a VPN service exit node IP address.
          type: boolean
      type: object
    Privacy_TorInfo:
      additionalProperties: false
      properties:
        relays:
          items:
            $ref: "#/components/schemas/Privacy_TorInfo_Relay"
          type:
            - array
            - "null"
      type: object
    Privacy_TorInfo_Relay:
      additionalProperties: false
      properties:
        advertised_bandwidth:
          description: Bandwidth in bytes per second that this relay is willing and capable to provide. The minimum of bandwidth_rate, bandwidth_burst, and observed_bandwidth.
          format: int64
          type: integer
        alleged_family:
          description: Fingerprints of relays that are part of this relay's family but do not consider this relay to be part of their family.
          items:
            type: string
          type:
            - array
            - "null"
        bandwidth_burst:
          description: Bandwidth in bytes per second that this relay is willing to sustain in very short intervals.
          format: int64
          type: integer
        bandwidth_rate:
          description: Average bandwidth in bytes per second that this relay is willing to sustain over long periods.
          format: int64
          type: integer
        blocklist:
          description: Country codes where this bridge is not served because it is believed to be blocked.
          items:
            type: string
          type:
            - array
            - "null"
        bridge:
          description: Whether this entry represents a bridge rather than a relay.
          type: boolean
        bridgedb_distributor:
          description: BridgeDB distributor that this bridge is currently assigned to.
          type: string
        consensus_weight:
          description: Weight assigned to this relay by the directory authorities that clients use in their path selection algorithm.
          format: int64
          type: integer
        consensus_weight_fraction:
          description: Fraction of this relay's consensus weight compared to the sum of all consensus weights in the network. A rough approximation of the probability of this relay to be selected by clients.
          format: double
          type: number
        contact:
          description: Contact address of the relay operator.
          type: string
        dir_address:
          description: IPv4 address and TCP port where the relay accepts directory connections.
          type: string
        effective_family:
          description: Fingerprints of relays in an effective, mutual family relationship with this relay. Always contains the relay's own fingerprint.
          items:
            type: string
          type:
            - array
            - "null"
        exit_addresses:
          description: IPv4 addresses that the relay used to exit to the Internet in the past 24 hours.
          items:
            type: string
          type:
            - array
            - "null"
        exit_policy:
          description: Array of exit-policy lines from the relay's router descriptor.
          items:
            type: string
          type:
            - array
            - "null"
        exit_policy_summary:
          $ref: "#/components/schemas/Privacy_TorInfo_Relay_ExitPolicySummary"
          description: Summary of the relay's exit policy containing accepted or rejected TCP ports/port ranges for most IP addresses.
        exit_policy_v6_summary:
          $ref: "#/components/schemas/Privacy_TorInfo_Relay_ExitPolicySummary"
          description: Summary of the relay's IPv6 exit policy containing accepted or rejected TCP ports/port ranges for most IP addresses.
        exit_probability:
          description: Probability of this relay to be selected for the exit position, calculated based on consensus weights, relay flags, and bandwidth weights.
          format: double
          type: number
        fingerprint:
          description: Relay fingerprint consisting of 40 upper-case hexadecimal characters.
          type: string
        flags:
          description: Relay flags assigned by the directory authorities.
          items:
            type: string
          type:
            - array
            - "null"
        guard_probability:
          description: Probability of this relay to be selected for the guard position, calculated based on consensus weights, relay flags, and bandwidth weights.
          format: double
          type: number
        hashed_fingerprint:
          description: SHA-1 hash of the bridge fingerprint consisting of 40 upper-case hexadecimal characters.
          type: string
        indirect_family:
          description: Fingerprints of relays reachable by following effective, mutual family relationships starting at this relay, but not directly in a mutual family relationship.
          items:
            type: string
          type:
            - array
            - "null"
        measured:
          description: Whether the consensus weight of this relay is based on a threshold of 3 or more measurements by Tor bandwidth authorities.
          type: boolean
        middle_probability:
          description: Probability of this relay to be selected for the middle position, calculated based on consensus weights, relay flags, and bandwidth weights.
          format: double
          type: number
        nickname:
          description: Relay nickname consisting of 1-19 alphanumerical characters.
          type: string
        observed_bandwidth:
          description: Bandwidth estimate in bytes per second of the capacity this relay can handle. The lesser of the maximum sustained output and input over any ten second period in the past day.
          format: int64
          type: integer
        or_addresses:
          description: IPv4 or IPv6 addresses and TCP ports where the relay accepts onion-routing connections. The first address is the primary onion-routing address.
          items:
            type: string
          type:
            - array
            - "null"
        overload_general_timestamp:
          description: Timestamp indicating when the relay reached an overloaded state (e.g., OOM invocation, ntor onionskins dropped, or TCP port exhaustion).
          format: int64
          type: integer
        platform:
          description: Platform string containing operating system and Tor version details.
          type: string
        recommended_version:
          description: Whether the Tor software version of this relay is recommended by the directory authorities.
          type: boolean
        transports:
          description: Pluggable transport names supported by this bridge.
          items:
            type: string
          type:
            - array
            - "null"
        unreachable_or_addresses:
          description: IPv4 or IPv6 addresses and TCP ports where the relay claims to accept onion-routing connections but that the directory authorities failed to confirm as reachable.
          items:
            type: string
          type:
            - array
            - "null"
        version:
          description: Tor software version without leading 'Tor' as reported by the directory authorities.
          type: string
        version_status:
          description: "Status of the Tor software version: recommended, experimental, obsolete, new in series, or unrecommended."
          type: string
      type: object
    Privacy_TorInfo_Relay_ExitPolicySummary:
      additionalProperties: false
      properties:
        accept:
          description: TCP ports or port ranges that the relay accepts for most IP addresses.
          items:
            type: string
          type:
            - array
            - "null"
        reject:
          description: TCP ports or port ranges that the relay rejects for most IP addresses.
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    ProfinetCm:
      additionalProperties: false
      properties:
        byte_order:
          type: string
        lookup_response_raw:
          format: hex
          type: string
        multiple_fragments:
          type: boolean
      type: object
    Prometheus:
      additionalProperties: false
      properties:
        response:
          $ref: "#/components/schemas/Prometheus_Response"
          description: Information Prometheus captured as well as build information.
      type: object
    PrometheusMetricFamily:
      additionalProperties: false
      properties:
        help:
          type: string
        name:
          type: string
      type: object
    PrometheusTarget:
      additionalProperties: false
      properties:
        metric_families:
          items:
            $ref: "#/components/schemas/PrometheusMetricFamily"
          type:
            - array
            - "null"
      type: object
    Prometheus_Response:
      additionalProperties: false
      properties:
        active_targets:
          description: List of active targets.
          items:
            $ref: "#/components/schemas/Prometheus_Response_ActiveTarget"
          type:
            - array
            - "null"
        all_versions:
          description: List of the versions of everything that Prometheus finds i.e., version of Prometheus, Go, Node, cAdvisor, etc.
          items:
            type: string
          type:
            - array
            - "null"
        config_exposed:
          description: True when the config endpoint is exposed.
          type: boolean
        dropped_targets:
          description: List of dropped targets.
          items:
            $ref: "#/components/schemas/Prometheus_Response_DroppedTarget"
          type:
            - array
            - "null"
        go_versions:
          description: List of the versions of Go.
          items:
            type: string
          type:
            - array
            - "null"
        prometheus_versions:
          items:
            $ref: "#/components/schemas/Prometheus_Response_PrometheusVersion"
          type:
            - array
            - "null"
      type: object
    Prometheus_Response_ActiveTarget:
      additionalProperties: false
      properties:
        discovered_labels:
          $ref: "#/components/schemas/Prometheus_Response_ActiveTarget_DiscoveredLabels"
        health:
          description: Whether target is up or down.
          type: string
        labels:
          $ref: "#/components/schemas/Prometheus_Response_ActiveTarget_Labels"
        last_error:
          description: Last error that occurred within target.
          type: string
        last_scrape:
          description: Last time Prometheus scraped target.
          type: string
        scrape_url:
          description: URL that Prometheus scraped.
          type: string
      type: object
    Prometheus_Response_ActiveTarget_DiscoveredLabels:
      additionalProperties: false
      properties:
        address:
          description: Address of target.
          type: string
        job:
          description: Job of target.
          type: string
        metrics_path:
          description: Path to metrics of target.
          type: string
        scheme:
          description: URL scheme.
          type: string
      type: object
    Prometheus_Response_ActiveTarget_Labels:
      additionalProperties: false
      properties:
        instance:
          description: Instance after relabelling has occurred.
          type: string
        job:
          description: Job of target after relabelling has occurred.
          type: string
      type: object
    Prometheus_Response_DroppedTarget:
      additionalProperties: false
      properties:
        address:
          description: Address of target.
          type: string
        job:
          description: Job of target.
          type: string
        metrics_path:
          description: Path to metrics of target.
          type: string
        scheme:
          description: URL scheme.
          type: string
      type: object
    Prometheus_Response_PrometheusVersion:
      additionalProperties: false
      properties:
        go_version:
          description: Version of Go used to build Prometheus.
          type: string
        revision:
          description: Revision of Prometheus.
          type: string
        version:
          description: Version of Prometheus.
          type: string
      type: object
    ProxmoxVe:
      additionalProperties: false
      properties:
        api_daemon_version:
          type: string
        realms:
          items:
            $ref: "#/components/schemas/ProxmoxVe_Realm"
          type:
            - array
            - "null"
      type: object
    ProxmoxVe_Realm:
      additionalProperties: false
      properties:
        comment:
          type: string
        realm:
          type: string
        tfa:
          type: string
        type:
          type: string
      type: object
    QcStatements:
      additionalProperties: false
      properties:
        ids:
          items:
            type: string
          type:
            - array
            - "null"
        parsed:
          $ref: "#/components/schemas/QcStatements_ParsedStatements"
      type: object
    QcStatements_MonetaryValue:
      additionalProperties: false
      properties:
        amount:
          format: int64
          type: integer
        currency:
          type: string
        currency_number:
          format: int64
          type: integer
        exponent:
          format: int64
          type: integer
      type: object
    QcStatements_ParsedStatements:
      additionalProperties: false
      properties:
        etsi_compliance:
          items:
            type: boolean
          type:
            - array
            - "null"
        legislation:
          items:
            $ref: "#/components/schemas/QcStatements_QCLegislation"
          type:
            - array
            - "null"
        limit:
          items:
            $ref: "#/components/schemas/QcStatements_MonetaryValue"
          type:
            - array
            - "null"
        pds_locations:
          items:
            $ref: "#/components/schemas/QcStatements_PdsLocation"
          type:
            - array
            - "null"
        retention_period:
          items:
            format: int64
            type: integer
          type:
            - array
            - "null"
        sscd:
          items:
            type: boolean
          type:
            - array
            - "null"
        types:
          items:
            $ref: "#/components/schemas/QcStatements_QcType"
          type:
            - array
            - "null"
      type: object
    QcStatements_PdsLocation:
      additionalProperties: false
      properties:
        language:
          type: string
        url:
          type: string
      type: object
    QcStatements_QCLegislation:
      additionalProperties: false
      properties:
        country_codes:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    QcStatements_QcType:
      additionalProperties: false
      properties:
        ids:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    QdrantGrpc:
      additionalProperties: false
      properties:
        commit:
          type: string
        version:
          type: string
      type: object
    R1SoftBuagent:
      additionalProperties: false
      properties:
        cpu_hypervisor_signature:
          type: string
        rsa_public_key_bits:
          format: int32
          minimum: 0
          type: integer
        rsa_public_key_sha256:
          format: hex
          type: string
      type: object
    RSACryptographicKey:
      additionalProperties: false
      properties:
        exponent:
          format: base64
          type: string
        length:
          format: int32
          minimum: 0
          type: integer
        modulus:
          format: base64
          type: string
      type: object
    RawCertificateResponse:
      additionalProperties: false
      properties:
        certificate_id:
          type: string
        pem:
          type: string
      required:
        - certificate_id
        - pem
      type: object
    Rdate:
      additionalProperties: false
      properties:
        date:
          type: string
      type: object
    Rdp:
      additionalProperties: false
      properties:
        certificate_info:
          $ref: "#/components/schemas/Rdp_CertificateInfo"
        connect_response:
          $ref: "#/components/schemas/Rdp_ConnectResponse"
        protocol_flags:
          $ref: "#/components/schemas/Rdp_ProtocolFlags"
        selected_security_protocol:
          $ref: "#/components/schemas/Rdp_SecurityProtocol"
        version:
          $ref: "#/components/schemas/Rdp_Version"
        x224_cc_pdu_dstref:
          format: int32
          minimum: 0
          type: integer
        x224_cc_pdu_srcref:
          format: int32
          minimum: 0
          type: integer
      type: object
    Rdp_CertificateInfo:
      additionalProperties: false
      properties:
        internal_x509_chain_fps:
          items:
            format: hex
            type: string
          type:
            - array
            - "null"
        proprietary_rsa_key:
          $ref: "#/components/schemas/Rdp_EmbeddedRSACert"
      type: object
    Rdp_ConnectResponse:
      additionalProperties: false
      properties:
        connect_id:
          format: int32
          minimum: 0
          type: integer
        domain_parameters:
          $ref: "#/components/schemas/Rdp_DomainParameters"
      type: object
    Rdp_DomainParameters:
      additionalProperties: false
      properties:
        domain_protocol_version:
          format: int64
          type: integer
        max_channel_ids:
          format: int64
          type: integer
        max_mcspdu_size:
          format: int64
          type: integer
        max_provider_height:
          format: int64
          type: integer
        max_token_ids:
          format: int64
          type: integer
        max_user_id_channels:
          format: int64
          type: integer
        min_throughput:
          format: int64
          type: integer
        num_priorities:
          format: int64
          type: integer
      type: object
    Rdp_EmbeddedRSACert:
      additionalProperties: false
      properties:
        key_length:
          format: int32
          minimum: 0
          type: integer
        magic:
          format: int32
          minimum: 0
          type: integer
        max_bytes_datalen:
          format: int32
          minimum: 0
          type: integer
        modulus:
          type: string
        modulus_bitlen:
          format: int32
          minimum: 0
          type: integer
        public_exponent:
          format: int32
          minimum: 0
          type: integer
        signature:
          type: string
      type: object
    Rdp_ProtocolFlags:
      additionalProperties: false
      properties:
        dynvc_graphics_pipeline:
          type: boolean
        extended_client_data_supported:
          type: boolean
        neg_resp_reserved:
          type: boolean
        restricted_admin_mode:
          type: boolean
        restricted_auth_mode:
          type: boolean
      type: object
    Rdp_SecurityProtocol:
      additionalProperties: false
      properties:
        credssp:
          type: boolean
        credssp_early_auth:
          type: boolean
        error:
          type: boolean
        error_bad_flags:
          type: boolean
        error_hybrid_required:
          type: boolean
        error_ssl_cert_missing:
          type: boolean
        error_ssl_forbidden:
          type: boolean
        error_ssl_required:
          type: boolean
        error_ssl_user_auth_required:
          type: boolean
        error_unknown:
          type: boolean
        raw_value:
          format: int32
          minimum: 0
          type: integer
        rdstls:
          type: boolean
        standard_rdp:
          type: boolean
        tls:
          type: boolean
      type: object
    Rdp_Version:
      additionalProperties: false
      properties:
        major:
          format: int32
          type: integer
        minor:
          format: int32
          type: integer
        raw:
          description: Raw Version Response, Major version is stored in upper 2 bytes, minor in lower 2 bytes.
          format: hex
          type: string
      type: object
    Realport:
      additionalProperties: false
      properties:
        hardware_id:
          format: int32
          minimum: 0
          type: integer
        hardware_version:
          format: int32
          minimum: 0
          type: integer
        num_ports:
          format: int32
          minimum: 0
          type: integer
        product_name:
          format: utf8
          type: string
        software_version:
          format: int32
          minimum: 0
          type: integer
        unpatched_etherlite:
          type: boolean
        vpd:
          additionalProperties:
            type: string
          format: utf8
          type: object
      type: object
    RecordingCapabilities:
      additionalProperties: false
      properties:
        dynamic_recordings:
          type: boolean
        dynamic_tracks:
          type: boolean
        encoding:
          type: string
        max_rate:
          format: int32
          minimum: 0
          type: integer
        max_recordings:
          format: int32
          minimum: 0
          type: integer
        max_recordings_job:
          format: int32
          minimum: 0
          type: integer
        max_total_rate:
          format: int32
          minimum: 0
          type: integer
        options:
          type: boolean
      type: object
    Redis:
      additionalProperties: false
      properties:
        arch_bits:
          description: The architecture bits (32 or 64) the Redis server used to build.
          type: string
        auth_response:
          description: The response from the AUTH command, if sent.
          type: string
        build_id:
          description: The Build ID of the Redis server.
          type: string
        commands:
          description: The list of commands actually sent to the server, serialized in inline format, like 'PING' or 'AUTH somePassword'.
          items:
            type: string
          type:
            - array
            - "null"
        commands_processed:
          description: The total number of commands processed by the server.
          format: int32
          minimum: 0
          type: integer
        connections_received:
          description: The total number of connections accepted by the server.
          format: int32
          minimum: 0
          type: integer
        gcc_version:
          description: The version of the GCC compiler used to compile the Redis server.
          type: string
        git_sha1:
          description: The Sha-1 Git commit hash the Redis server used.
          type: string
        info_response:
          additionalProperties:
            type: string
          description: The response from the INFO command. Should be a series of key:value pairs separated by CRLFs.
          type: object
        major:
          description: Major is the version's major number.
          format: int32
          minimum: 0
          type: integer
        mem_allocator:
          description: The memory allocator.
          type: string
        minor:
          description: Minor is the version's major number.
          format: int32
          minimum: 0
          type: integer
        mode:
          description: The mode the Redis server is running (standalone or cluster), read from the the info_response (if available).
          type: string
        nonexistent_response:
          description: The response from the NONEXISTENT command.
          type: string
        os:
          description: The OS the Redis server is running, read from the the info_response (if available).
          type: string
        patch_level:
          description: Patchlevel is the version's patchlevel number.
          format: int32
          minimum: 0
          type: integer
        ping_response:
          description: The response from the PING command; should either be "PONG" or an authentication error.
          type: string
        quit_response:
          description: The response to the QUIT command.
          type: string
        raw_command_output:
          description: The raw output returned by the server for each command sent; the indices match those of commands.
          items:
            $ref: "#/components/schemas/Redis_RawOutput"
          type:
            - array
            - "null"
        uptime:
          description: The number of seconds since Redis server start.
          format: int32
          minimum: 0
          type: integer
        used_memory:
          description: The total number of bytes allocated by Redis using its allocator.
          format: int32
          minimum: 0
          type: integer
      type: object
    Redis_RawOutput:
      additionalProperties: false
      properties:
        output:
          format: hex
          type: string
      type: object
    Redline:
      additionalProperties: false
      properties:
        action_response:
          type: string
        settings_response:
          type: string
        transport:
          type: string
      type: object
    RedlionCrimson:
      additionalProperties: false
      properties:
        configs_exposed:
          type: boolean
        control_engine_status:
          type: string
        current_software_level:
          type: string
        execution_status:
          type: string
        manufacturer:
          type: string
        model:
          type: string
      type: object
    RedlionWeb:
      additionalProperties: false
      properties:
        enhanced_web_server:
          type: boolean
        log_names:
          items:
            type: string
          type:
            - array
            - "null"
        title:
          type: string
      type: object
    Redshift:
      additionalProperties: false
      properties:
        sqlstate:
          type: string
        version:
          type: string
      type: object
    Reject:
      additionalProperties: false
      properties:
        reason:
          type: string
        type:
          enum:
            - ""
            - wrong_version
            - invalid_username
            - wrong_user_pw
            - wrong_server_pw
            - username_in_use
            - server_full
            - no_certificate
            - authenticator_fail
          type: string
      type: object
    ReolinkBaichuan:
      additionalProperties: false
      properties:
        ai_types_observed:
          items:
            type: string
          type:
            - array
            - "null"
        body_length:
          format: int32
          minimum: 0
          type: integer
        channel_count:
          format: int32
          minimum: 0
          type: integer
        channels:
          items:
            $ref: "#/components/schemas/ReolinkBaichuan_AlarmChannel"
          type:
            - array
            - "null"
        command_id:
          format: int32
          minimum: 0
          type: integer
        raw_xml:
          type: string
        status_code:
          format: int32
          minimum: 0
          type: integer
      type: object
    ReolinkBaichuan_AlarmChannel:
      additionalProperties: false
      properties:
        ai_type:
          type: string
        channel_id:
          format: int32
          minimum: 0
          type: integer
        recording:
          format: int32
          minimum: 0
          type: integer
        status:
          type: string
        timestamp:
          format: int64
          minimum: 0
          type: integer
      type: object
    ReplayCapabilities:
      additionalProperties: false
      properties:
        reverse_playback:
          type: boolean
        rtp_rtsp_tcp:
          type: boolean
        session_timeout_range:
          type: string
      type: object
    RepresentativeInfo:
      additionalProperties: false
      properties:
        excluded_ports:
          items:
            format: int32
            minimum: 0
            type: integer
          type:
            - array
            - "null"
        reason:
          enum:
            - ""
            - protocol_port_count
            - incapsula
            - zscaler
          type: string
        represented_ports:
          items:
            format: int32
            minimum: 0
            type: integer
          type:
            - array
            - "null"
        sampled_port:
          format: int32
          minimum: 0
          type: integer
      type: object
    Reputation:
      additionalProperties: false
      properties:
        class_probabilities:
          items:
            $ref: "#/components/schemas/Reputation_ClassProbability"
          type:
            - array
            - "null"
        evidence:
          items:
            $ref: "#/components/schemas/Reputation_Evidence"
          type:
            - array
            - "null"
        label:
          type: string
        model_version:
          type: string
        score:
          format: float
          type: number
        score_level:
          enum:
            - ""
            - benign
            - low_risk
            - medium_risk
            - high_risk
            - malicious
          type: string
        score_suppressed:
          type: boolean
      type: object
    Reputation_ClassProbability:
      additionalProperties: false
      properties:
        label:
          type: string
        probability:
          format: double
          type: number
      type: object
    Reputation_Evidence:
      additionalProperties: false
      properties:
        additional_fields:
          items:
            $ref: "#/components/schemas/Reputation_Evidence_FieldValue"
          type:
            - array
            - "null"
        category:
          type: string
        evidence_score:
          format: float
          type: number
        external_signals:
          items:
            $ref: "#/components/schemas/Reputation_Evidence_ExternalSignal"
          type:
            - array
            - "null"
        feature:
          $ref: "#/components/schemas/Reputation_Evidence_Feature"
        threats:
          items:
            $ref: "#/components/schemas/Reputation_Evidence_Threat"
          type:
            - array
            - "null"
      type: object
    Reputation_Evidence_ExternalSignal:
      additionalProperties: false
      properties:
        description:
          type: string
        source:
          type: string
        tlp:
          enum:
            - ""
            - green
            - amber
            - red
            - white
          type: string
      type: object
    Reputation_Evidence_Feature:
      additionalProperties: false
      properties:
        category:
          type: string
        contribution:
          format: double
          type: number
        id:
          type: string
        name:
          type: string
        value:
          type: string
      type: object
    Reputation_Evidence_FieldValue:
      additionalProperties: false
      properties:
        field:
          type: string
        value:
          type: string
      type: object
    Reputation_Evidence_Threat:
      additionalProperties: false
      properties:
        last_observed_time:
          type: string
        threat_id:
          type: string
        threat_types:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    ResponseEnvelopeAttackSurface:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/AttackSurface"
      type: object
    ResponseEnvelopeAttackSurfaceAggregateResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/AttackSurfaceAggregateResponse"
      type: object
    ResponseEnvelopeAttackSurfaceAssets:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/AttackSurfaceAssets"
      type: object
    ResponseEnvelopeAttackSurfaceAssetsList:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/AttackSurfaceAssetsList"
      type: object
    ResponseEnvelopeAttackSurfaceListRiskEventsResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/AttackSurfaceListRiskEventsResponse"
      type: object
    ResponseEnvelopeAttackSurfaceSearchAssetsResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/AttackSurfaceSearchAssetsResponse"
      type: object
    ResponseEnvelopeAttackSurfacesList:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/AttackSurfacesList"
      type: object
    ResponseEnvelopeAuditLogEventsResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/AuditLogEventsResponse"
      type: object
    ResponseEnvelopeCenseyeJob:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/CenseyeJob"
      type: object
    ResponseEnvelopeCenseyeJobsListResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/CenseyeJobsListResponse"
      type: object
    ResponseEnvelopeCenseyeResultsResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/CenseyeResultsResponse"
      type: object
    ResponseEnvelopeCertificateAsset:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/CertificateAsset"
      type: object
    ResponseEnvelopeCollection:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/Collection"
      type: object
    ResponseEnvelopeCollectionEventsResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/CollectionEventsResponse"
      type: object
    ResponseEnvelopeComment:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/Comment"
      type: object
    ResponseEnvelopeCommentsList:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/CommentsList"
      type: object
    ResponseEnvelopeCreatedInvestigationJob:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/CreatedInvestigationJob"
      type: object
    ResponseEnvelopeCreditUsageReport:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/CreditUsageReport"
      type: object
    ResponseEnvelopeDnsIpResolutionBoundResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/DnsIpResolutionBoundResponse"
      type: object
    ResponseEnvelopeDnsIpResolutionRangeResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/DnsIpResolutionRangeResponse"
      type: object
    ResponseEnvelopeDnsNameResolutionBoundResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/DnsNameResolutionBoundResponse"
      type: object
    ResponseEnvelopeDnsNameResolutionRangeResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/DnsNameResolutionRangeResponse"
      type: object
    ResponseEnvelopeGetSupplierPayload:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/GetSupplierPayload"
      type: object
    ResponseEnvelopeHashObservationsOnHostResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/HashObservationsOnHostResponse"
      type: object
    ResponseEnvelopeHostAsset:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/HostAsset"
      type: object
    ResponseEnvelopeHostEnrichmentAsset:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/HostEnrichmentAsset"
      type: object
    ResponseEnvelopeHostObservationResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/HostObservationResponse"
      type: object
    ResponseEnvelopeHostTimeline:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/HostTimeline"
      type: object
    ResponseEnvelopeInvestigationFileUpload:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/InvestigationFileUpload"
      type: object
    ResponseEnvelopeInvestigationJob:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/InvestigationJob"
      type: object
    ResponseEnvelopeInvestigationJobsList:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/InvestigationJobsList"
      type: object
    ResponseEnvelopeInvestigationUsage:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/InvestigationUsage"
      type: object
    ResponseEnvelopeListCertificateAsset:
      additionalProperties: false
      properties:
        result:
          items:
            $ref: "#/components/schemas/CertificateAsset"
          type:
            - array
            - "null"
      type: object
    ResponseEnvelopeListCollectionsResponseV1:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/ListCollectionsResponseV1"
      type: object
    ResponseEnvelopeListHostAsset:
      additionalProperties: false
      properties:
        result:
          items:
            $ref: "#/components/schemas/HostAsset"
          type:
            - array
            - "null"
      type: object
    ResponseEnvelopeListRawCertificateResponse:
      additionalProperties: false
      properties:
        result:
          items:
            $ref: "#/components/schemas/RawCertificateResponse"
          type:
            - array
            - "null"
      type: object
    ResponseEnvelopeListRiskEventsResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/ListRiskEventsResponse"
      type: object
    ResponseEnvelopeListRisksPayload:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/ListRisksPayload"
      type: object
    ResponseEnvelopeListSearchConvertQueryResponse:
      additionalProperties: false
      properties:
        result:
          items:
            $ref: "#/components/schemas/SearchConvertQueryResponse"
          type:
            - array
            - "null"
      type: object
    ResponseEnvelopeListSuppliersPayload:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/ListSuppliersPayload"
      type: object
    ResponseEnvelopeListWebpropertyAsset:
      additionalProperties: false
      properties:
        result:
          items:
            $ref: "#/components/schemas/WebpropertyAsset"
          type:
            - array
            - "null"
      type: object
    ResponseEnvelopeOrganizationCredits:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/OrganizationCredits"
      type: object
    ResponseEnvelopeOrganizationDetails:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/OrganizationDetails"
      type: object
    ResponseEnvelopeOrganizationMembersList:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/OrganizationMembersList"
      type: object
    ResponseEnvelopeRiskInstance:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/RiskInstance"
      type: object
    ResponseEnvelopeSearchAggregateResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/SearchAggregateResponse"
      type: object
    ResponseEnvelopeSearchQueryResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/SearchQueryResponse"
      type: object
    ResponseEnvelopeSecurityAdvisories:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/SecurityAdvisories"
      type: object
    ResponseEnvelopeServicesOnHostResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/ServicesOnHostResponse"
      type: object
    ResponseEnvelopeSupplyChainAddSuppliersPayload:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/SupplyChainAddSuppliersPayload"
      type: object
    ResponseEnvelopeSupplyChainAggregateResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/SupplyChainAggregateResponse"
      type: object
    ResponseEnvelopeSupplyChainGetPayload:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/SupplyChainGetPayload"
      type: object
    ResponseEnvelopeSupplyChainListPayload:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/SupplyChainListPayload"
      type: object
    ResponseEnvelopeSupplyChainSearchAssetsResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/SupplyChainSearchAssetsResponse"
      type: object
    ResponseEnvelopeSupplyChainSearchRisksResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/SupplyChainSearchRisksResponse"
      type: object
    ResponseEnvelopeSupplyChainSearchSuppliersPayload:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/SupplyChainSearchSuppliersPayload"
      type: object
    ResponseEnvelopeTag:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/Tag"
      type: object
    ResponseEnvelopeTagAssignment:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/TagAssignment"
      type: object
    ResponseEnvelopeTagAssignmentsList:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/TagAssignmentsList"
      type: object
    ResponseEnvelopeTagOperation:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/TagOperation"
      type: object
    ResponseEnvelopeTagOperationsList:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/TagOperationsList"
      type: object
    ResponseEnvelopeTagsList:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/TagsList"
      type: object
    ResponseEnvelopeThreatsListResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/ThreatsListResponse"
      type: object
    ResponseEnvelopeThreatsOnHostResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/ThreatsOnHostResponse"
      type: object
    ResponseEnvelopeThreatsOnWebResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/ThreatsOnWebResponse"
      type: object
    ResponseEnvelopeTrackedScan:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/TrackedScan"
      type: object
    ResponseEnvelopeUserCredits:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/UserCredits"
      type: object
    ResponseEnvelopeValueCountsResponse:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/ValueCountsResponse"
      type: object
    ResponseEnvelopeWebpropertyAsset:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/WebpropertyAsset"
      type: object
    ResponseEnvelopeWebpropertyTimeline:
      additionalProperties: false
      properties:
        result:
          $ref: "#/components/schemas/WebpropertyTimeline"
      type: object
    ReverseDnsResolved:
      additionalProperties: false
      properties:
        names:
          items:
            type: string
          type:
            - array
            - "null"
        resolve_time:
          type: string
      type: object
    Rifatron:
      additionalProperties: false
      properties:
        model:
          type: string
      type: object
    Ripple:
      additionalProperties: false
      properties:
        ripple_clio:
          $ref: "#/components/schemas/RippleClioResults"
        rippled_peer:
          $ref: "#/components/schemas/RipplePeerResults"
        rippled_public:
          $ref: "#/components/schemas/RippledPublicResults"
      type: object
    RippleClioResults:
      additionalProperties: false
      properties:
        clio_version:
          type: string
        rippled_version:
          type: string
        validated:
          type: boolean
        validation_quorum:
          format: int64
          type: integer
      type: object
    RipplePeerResults:
      additionalProperties: false
      properties:
        build_version:
          type: string
        peer_crawler_response_version:
          format: int64
          type: integer
        peers:
          items:
            $ref: "#/components/schemas/Peer"
          type:
            - array
            - "null"
        pubkey_node:
          type: string
        publisher_list:
          items:
            type: string
          type:
            - array
            - "null"
        server_state:
          type: string
        validator_sites:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    RippledPublicResults:
      additionalProperties: false
      properties:
        build_version:
          type: string
        hostid:
          type: string
        network_id:
          format: int64
          type: integer
        peers:
          format: int64
          type: integer
        ports:
          items:
            $ref: "#/components/schemas/Port"
          type:
            - array
            - "null"
        pubkey_node:
          type: string
        server_state:
          type: string
        validation_quorum:
          format: int64
          type: integer
      type: object
    Risk:
      additionalProperties: false
      properties:
        confidence:
          format: double
          type: number
        cvss:
          $ref: "#/components/schemas/CVSS"
        evidence:
          items:
            $ref: "#/components/schemas/Evidence"
          type:
            - array
            - "null"
        id:
          type: string
        metrics:
          $ref: "#/components/schemas/Metrics"
        name:
          type: string
        risk_source:
          enum:
            - ""
            - censys
            - cve
          type: string
        severity:
          enum:
            - ""
            - low
            - medium
            - high
            - critical
          type: string
        source:
          enum:
            - ""
            - censys
            - recog
            - wappalyzer
            - third_party
            - html_meta_extractor
          type: string
        type:
          items:
            type: string
          type:
            - array
            - "null"
        year:
          format: int32
          minimum: 0
          type: integer
      type: object
    RiskEvent:
      additionalProperties: false
      properties:
        change_type:
          description: The kind of change this event represents.
          enum:
            - opened
            - resolved
            - reopened
          type: string
        id:
          description: The unique ID of the event. Used to deduplicate events and, with inserted_at, to continue polling via inserted_after_time and inserted_after_event_id.
          type: string
        inserted_at:
          description: When this event was recorded in Censys. Differs from occurred_at, which is when the change occurred.
          format: date-time
          type: string
        occurred_at:
          description: When this change occurred.
          format: date-time
          type: string
        risk_instance:
          $ref: "#/components/schemas/RiskInstance"
          description: The risk instance as it was at the time of this change.
      required:
        - id
        - change_type
        - occurred_at
        - risk_instance
      type: object
    RiskInstance:
      additionalProperties: false
      properties:
        asset_type:
          description: Which asset type the locus fields describe, e.g. host or web.
          type: string
        confidence:
          description: Confidence that this finding is real, from 0 to 1.
          format: double
          type: number
        created_at:
          description: When the instance record was created in Censys.
          format: date-time
          type: string
        description:
          description: Description of this risk.
          type: string
        evidence:
          description: Evidence supporting the identification of this risk on this asset.
          type: string
        first_detected_at:
          description: When this risk instance was first observed.
          format: date-time
          type: string
        host:
          $ref: "#/components/schemas/SupplyChainRiskInstanceHost"
          description: The host this risk was observed on.
        id:
          description: Unique identifier of this risk instance.
          type: string
        last_detected_at:
          description: Most recent time this risk instance was observed.
          format: date-time
          type: string
        platform_url:
          description: Deep link to the asset this risk was observed on, in the context of this supply chain and supplier, if the asset type is recognized.
          format: uri
          type: string
        rapid_response:
          description: Whether this risk type was authored as a rapid response to an emerging threat.
          type: boolean
        remediations:
          description: Recommended remediation steps for this risk, in the order they should be applied.
          items:
            type: string
          type:
            - array
            - "null"
        resolve_reason:
          description: Why this risk instance resolved. Present only when status is closed.
          enum:
            - finding_removed
            - service_removed
            - web_property_removed
            - asset_removed
          type: string
        resolve_time:
          description: When this risk instance resolved. Present only when status is closed; absent while open, and cleared again if the instance later reopens.
          format: date-time
          type: string
        risk_category:
          description: Category of this risk.
          enum:
            - VULNERABILITY
            - EXPOSURE
            - MISCONFIGURATION
            - THREAT
          type: string
        risk_name:
          description: Human-readable name of this risk, e.g. "Unencrypted HTTP Weak Auth".
          type: string
        risk_type_id:
          description: Risk identifier shared across every instance of this risk, e.g. a CVE ID or a Censys catalog ID.
          type: string
        score:
          description: Priority score from 0.0-10.0, derived from asset importance, severity, and exploitability.
          format: double
          type: number
        service:
          $ref: "#/components/schemas/SupplyChainRiskInstanceService"
          description: The network service this risk was observed on, set alongside host for service-scoped findings.
        severity:
          description: Severity of this risk.
          enum:
            - UNSPECIFIED
            - LOW
            - MEDIUM
            - HIGH
            - CRITICAL
          type: string
        status:
          description: "Status of this risk instance: open or closed."
          enum:
            - open
            - closed
          type: string
        suppliers:
          description: Suppliers this risk instance's asset belongs to.
          items:
            $ref: "#/components/schemas/SupplyChainRiskInstanceSupplier"
          type:
            - array
            - "null"
        supply_chain_id:
          description: The supply chain this risk instance belongs to.
          format: uuid
          type: string
        tags:
          description: Tags applied to the parent asset as of when this risk was last observed.
          items:
            $ref: "#/components/schemas/SearchQueryTagInfo"
          type:
            - array
            - "null"
        web:
          $ref: "#/components/schemas/SupplyChainRiskInstanceWeb"
          description: The web property this risk was observed on.
      required:
        - id
        - supply_chain_id
        - asset_type
        - risk_type_id
        - risk_category
        - severity
        - risk_name
        - status
        - confidence
        - score
        - rapid_response
      type: object
    Rlogin:
      additionalProperties: false
      properties:
        error:
          type: string
        operating_system:
          type: string
        software:
          type: string
        software_version:
          type: string
      type: object
    Rocketmq:
      additionalProperties: false
      properties:
        cluster_info:
          $ref: "#/components/schemas/Rocketmq_ClusterInfo"
        topics:
          $ref: "#/components/schemas/Rocketmq_TopicList"
        version:
          type: string
      type: object
    Rocketmq_ClusterInfo:
      additionalProperties: false
      properties:
        header:
          $ref: "#/components/schemas/Rocketmq_ResponseHeader"
        payload:
          type: string
      type: object
    Rocketmq_ResponseHeader:
      additionalProperties: false
      properties:
        code:
          format: int64
          type: integer
        flag:
          format: int64
          type: integer
        language:
          type: string
        opaque:
          format: int64
          type: integer
        serialize_type_current_rpc:
          type: string
      type: object
    Rocketmq_TopicList:
      additionalProperties: false
      properties:
        header:
          $ref: "#/components/schemas/Rocketmq_ResponseHeader"
        topic_list:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    RootStore:
      additionalProperties: false
      properties:
        chains:
          description: A path of trusted signing certificates up to a root certificate present in a root store, represented as an ordered list of SHA-256 fingerprints.
          items:
            $ref: "#/components/schemas/RootStore_Chain"
          type:
            - array
            - "null"
        ever_valid:
          description: Whether the certificate has ever been considered valid by the root store.
          type: boolean
        had_trusted_path:
          description: Whether there ever existed a trusted path of signing certificates from a certificate present in the root certificate store.
          type: boolean
        has_trusted_path:
          description: Whether there currently exists a trusted path of signing certificates from a certificate present in the root certificate store.
          type: boolean
        in_revocation_set:
          description: Whether the certificate is in the revocation set (e.g. OneCRL) associated with the root store.
          type: boolean
        is_valid:
          description: "Whether the certificate is currently considered valid by the root store: a summary of the trust path, revoked, blocklisted/allowlisted, and expired fields."
          type: boolean
        parents:
          description: The SHA-256 fingerprints of the certificate's immediate parents in its trust path(s).
          items:
            format: hex
            type: string
          type:
            - array
            - "null"
        type:
          description: The certificate's type. Options include root, intermediate, or leaf.
          enum:
            - ""
            - root
            - intermediate
            - leaf
          type: string
      type: object
    RootStore_Chain:
      additionalProperties: false
      properties:
        sha256fp:
          items:
            format: hex
            type: string
          type:
            - array
            - "null"
      type: object
    RouteUpdated:
      additionalProperties: false
      properties:
        diff:
          additionalProperties:
            $ref: "#/components/schemas/FieldDiff"
          type: object
        route:
          $ref: "#/components/schemas/AutonomousSystem"
      type: object
    RouterosApi:
      additionalProperties: false
      properties:
        message:
          type: string
        raw_response:
          format: hex
          type: string
        reply_word:
          type: string
      type: object
    Routing:
      additionalProperties: false
      properties:
        asn:
          description: The ASN (autonomous system number) of the host's autonomous system.
          format: int32
          minimum: 0
          type: integer
        bgp_prefix:
          description: The autonomous system's CIDR.
          type: string
        country_code:
          description: The autonomous system's two-letter ISO 3166-1 alpha-2 country code (US, CN, GB, RU, ...).
          type: string
        description:
          description: Brief description of the autonomous system.
          type: string
        name:
          description: The friendly name of the autonomous system.
          type: string
        organization:
          description: The name of the organization managning the autonomous system.
          type: string
      type: object
    RsaPublicKey:
      additionalProperties: false
      properties:
        exponent:
          description: The RSA key's public exponent (e).
          format: int64
          type: integer
        length:
          description: Bit-length of the RSA modulus.
          format: int64
          type: integer
        modulus:
          description: The RSA key's modulus (n) in big-endian encoding.
          format: hex
          type: string
      type: object
    Rtmp:
      additionalProperties: false
      properties:
        capabilities:
          format: int32
          minimum: 0
          type: integer
        mode:
          format: int32
          minimum: 0
          type: integer
        peer_bandwidth:
          format: int32
          minimum: 0
          type: integer
        protocol_version:
          format: int32
          minimum: 0
          type: integer
        server_software:
          type: string
        status:
          $ref: "#/components/schemas/Rtmp_ConnectStatus"
        window_acknowledgement_size:
          format: int32
          minimum: 0
          type: integer
      type: object
    Rtmp_ConnectStatus:
      additionalProperties: false
      properties:
        code:
          type: string
        description:
          type: string
        level:
          type: string
        object_encoding:
          format: int32
          minimum: 0
          type: integer
      type: object
    Rtsp:
      additionalProperties: false
      properties:
        auth:
          format: utf8
          type: string
        commands:
          items:
            format: utf8
            type: string
          type:
            - array
            - "null"
        server:
          format: utf8
          type: string
        www_auth:
          format: utf8
          type: string
      type: object
    RustdeskHeartbeat:
      additionalProperties: false
      properties:
        message_type:
          type: string
        register_peer_response:
          $ref: "#/components/schemas/RustdeskHeartbeat_RegisterPeerResponse"
      type: object
    RustdeskHeartbeat_RegisterPeerResponse:
      additionalProperties: false
      properties:
        request_public_key:
          type: boolean
      type: object
    RustdeskRelay:
      additionalProperties: false
      properties:
        open_relay:
          type: boolean
      type: object
    RustdeskRendezvous:
      additionalProperties: false
      properties:
        key_exchange:
          $ref: "#/components/schemas/RustdeskRendezvous_KeyExchange"
        message_type:
          type: string
        test_nat_response:
          $ref: "#/components/schemas/RustdeskRendezvous_TestNatResponse"
      type: object
    RustdeskRendezvous_ConfigUpdate:
      additionalProperties: false
      properties:
        rendezvous_servers:
          items:
            type: string
          type:
            - array
            - "null"
        serial:
          format: int32
          type: integer
      type: object
    RustdeskRendezvous_KeyExchange:
      additionalProperties: false
      properties:
        keys:
          items:
            format: hex
            type: string
          type:
            - array
            - "null"
      type: object
    RustdeskRendezvous_TestNatResponse:
      additionalProperties: false
      properties:
        config_update:
          $ref: "#/components/schemas/RustdeskRendezvous_ConfigUpdate"
        port:
          format: int32
          type: integer
      type: object
    S7:
      additionalProperties: false
      properties:
        copyright:
          type: string
        cpu_profile:
          type: string
        firmware:
          type: string
        hardware:
          type: string
        location:
          type: string
        memory_serial_number:
          type: string
        module:
          type: string
        module_id:
          type: string
        module_type:
          type: string
        oem_id:
          type: string
        plant_id:
          type: string
        reserved_for_os:
          type: string
        serial_number:
          type: string
        system:
          type: string
      type: object
    SapRouter:
      additionalProperties: false
      properties:
        router_info:
          $ref: "#/components/schemas/SapRouter_RouterInfo"
        router_version_info:
          $ref: "#/components/schemas/SapRouter_RouterVersionInfo"
      type: object
    SapRouter_ClientInfo:
      additionalProperties: false
      properties:
        connected:
          type: boolean
        connected_on:
          type: string
        id:
          format: int32
          minimum: 0
          type: integer
        routed:
          type: boolean
        service:
          type: string
        traced:
          type: boolean
      type: object
    SapRouter_RouterInfo:
      additionalProperties: false
      properties:
        connected_client_info:
          items:
            $ref: "#/components/schemas/SapRouter_ClientInfo"
          type:
            - array
            - "null"
        num_clients:
          format: int64
          minimum: 0
          type: integer
        parent_pid:
          format: int32
          minimum: 0
          type: integer
        parent_port:
          format: int32
          minimum: 0
          type: integer
        pid:
          format: int32
          minimum: 0
          type: integer
        port:
          format: int32
          minimum: 0
          type: integer
        routtab_relative_directory:
          type: string
        sap_router_absolute_directory:
          type: string
        started_on:
          type: string
      type: object
    SapRouter_RouterVersionInfo:
      additionalProperties: false
      properties:
        name:
          type: string
        release:
          format: int64
          minimum: 0
          type: integer
        version:
          format: int64
          minimum: 0
          type: integer
      type: object
    Sapient:
      additionalProperties: false
      properties:
        error:
          $ref: "#/components/schemas/Sapient_Error"
        payload:
          format: hex
          type: string
        registration_ack:
          $ref: "#/components/schemas/Sapient_RegistrationAck"
        unknown:
          format: hex
          type: string
      type: object
    Sapient_Error:
      additionalProperties: false
      properties:
        error_message:
          items:
            type: string
          type:
            - array
            - "null"
        packet:
          format: hex
          type: string
      type: object
    Sapient_RegistrationAck:
      additionalProperties: false
      properties:
        acceptance:
          type: boolean
        ack_response_reason:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    ScadaView:
      additionalProperties: false
      properties:
        description:
          type: string
        title:
          type: string
      type: object
    ScansDiscoveryInputBody:
      additionalProperties: false
      properties:
        target:
          oneOf:
            - description: Discovery scan against IP:PORT
              properties:
                host_port:
                  additionalProperties: false
                  properties:
                    ip:
                      description: IP address to scan
                      examples:
                        - 8.8.8.8
                      type: string
                    port:
                      description: Port number to scan
                      examples:
                        - 443
                      format: int32
                      maximum: 65535
                      minimum: 1
                      type: integer
                  required:
                    - ip
                    - port
                  type: object
              required:
                - host_port
              type: object
            - description: Discovery scan against hostname:PORT
              properties:
                hostname_port:
                  additionalProperties: false
                  properties:
                    hostname:
                      description: Hostname to scan
                      examples:
                        - censys.io
                      type: string
                    port:
                      description: Port number to scan
                      examples:
                        - 443
                      format: int32
                      maximum: 65535
                      minimum: 1
                      type: integer
                  required:
                    - hostname
                    - port
                  type: object
              required:
                - hostname_port
              type: object
          type: object
      required:
        - target
      type: object
    ScansRescanInputBody:
      additionalProperties: false
      properties:
        target:
          oneOf:
            - description: Rescan of known service
              properties:
                service_id:
                  additionalProperties: false
                  properties:
                    ip:
                      description: IP address of service
                      examples:
                        - 8.8.8.8
                      type: string
                    port:
                      description: Port number of service
                      examples:
                        - 443
                      format: int32
                      maximum: 65535
                      minimum: 1
                      type: integer
                    protocol:
                      description: Name of service protocol
                      examples:
                        - HTTP
                      type: string
                    transport_protocol:
                      enum:
                        - unknown
                        - tcp
                        - udp
                        - icmp
                        - quic
                      type: string
                  required:
                    - ip
                    - port
                    - protocol
                    - transport_protocol
                  type: object
              required:
                - service_id
              type: object
            - description: Rescan of known web property
              properties:
                web_origin:
                  additionalProperties: false
                  properties:
                    hostname:
                      description: Hostname of the web origin
                      examples:
                        - censys.io
                      type: string
                    port:
                      description: Port number of the web origin
                      examples:
                        - 443
                      format: int32
                      maximum: 65535
                      minimum: 1
                      type: integer
                  required:
                    - hostname
                    - port
                  type: object
              required:
                - web_origin
              type: object
          type: object
      required:
        - target
      type: object
    Scpi:
      additionalProperties: false
      properties:
        firmware:
          format: utf8
          type: string
        manufacturer:
          format: utf8
          type: string
        model:
          format: utf8
          type: string
        serial:
          format: utf8
          type: string
      type: object
    Screenshot:
      additionalProperties: false
      properties:
        extracted_text:
          type: string
        handle:
          type: string
        palsimhash:
          format: hex
          type: string
        phash:
          format: hex
          type: string
      type: object
    SearchAggregateInputBody:
      additionalProperties: false
      properties:
        count_by_level:
          description: "Specifies which document level's count is returned per term bucket, primarily for nested fields. This is the same functionality available in the Count By dropdown in the Report Builder UI. When aggregating on nested fields like 'host.services.port': empty string (default) counts documents at the deepest level containing the field; '.' counts root documents (e.g. counts matching 'host'); 'host.services' counts documents at the specified nested level."
          type: string
        field:
          description: field to aggregate by
          examples:
            - host.services.port
          type: string
        filter_by_query:
          default: false
          description: Controls whether aggregation results are limited to values that match the query. When true, only field values that satisfy the query constraints are included in aggregation counts. When false, aggregation includes all field values from records that match the query, even if those specific field values don't match the query constraints. For example, if the query is 'host.services.protocol=SSH' and you are aggregating by 'host.services.port' - when true, only shows SSH ports; when false, shows all ports on hosts that have SSH services.
          type: boolean
        number_of_buckets:
          description: number of buckets to split results into
          examples:
            - "100"
          format: int64
          maximum: 2000
          minimum: 1
          type: integer
        query:
          description: CenQL query string to search upon
          examples:
            - host.services.protocol=SSH
          type: string
      required:
        - query
        - field
        - number_of_buckets
      type: object
    SearchAggregateResponse:
      additionalProperties: false
      properties:
        buckets:
          items:
            $ref: "#/components/schemas/SearchAggregateResponseBucket"
          type:
            - array
            - "null"
        is_more_than_total_hits:
          type: boolean
        other_count:
          format: int64
          type: integer
        query_duration_millis:
          format: int64
          type: integer
        total_count:
          format: int64
          type: integer
      required:
        - total_count
        - other_count
        - query_duration_millis
        - is_more_than_total_hits
        - buckets
      type: object
    SearchAggregateResponseBucket:
      additionalProperties: false
      properties:
        count:
          format: int64
          type: integer
        key:
          type: string
      required:
        - key
        - count
      type: object
    SearchCapabilities:
      additionalProperties: false
      properties:
        general_start_events:
          type: boolean
        metadata_search:
          type: boolean
      type: object
    SearchConvertQueryInputBody:
      additionalProperties: false
      properties:
        queries:
          description: A list of Censys Search Language queries to convert. Limited to 100 queries.
          items:
            type: string
          maxItems: 100
          type:
            - array
            - "null"
      required:
        - queries
      type: object
    SearchConvertQueryResponse:
      additionalProperties: false
      properties:
        alternative_queries:
          description: Alternative queries that may be used. For example, a query that includes web results in addition to host results.
          items:
            $ref: "#/components/schemas/AlternativeQuery"
          type:
            - array
            - "null"
        comments:
          description: Comments about the query conversion.
          items:
            type: string
          type:
            - array
            - "null"
        converted_query:
          description: The original query, converted to CenQL syntax. This may be empty if unable to translate the query.
          type: string
        errors:
          description: The error messages if the query could not be converted.
          items:
            $ref: "#/components/schemas/ConvertQueryError"
          type:
            - array
            - "null"
        original_query:
          description: The original Censys Search Language query.
          type: string
        targets:
          description: "The types of Platform data records (host, cert, and web) that can be targeted by the converted query. Note: Does not include targets that could be returned due to full-document search. This may be empty if the query is a match-all for full-document search query."
          items:
            enum:
              - host
              - web
              - cert
              - unknown
            type: string
          type:
            - array
            - "null"
      required:
        - original_query
        - errors
        - targets
      type: object
    SearchQueryHit:
      additionalProperties: false
      properties:
        certificate_v1:
          $ref: "#/components/schemas/CertificateAsset"
        host_v1:
          $ref: "#/components/schemas/HostAssetWithMatchedServices"
        tags:
          description: Tags applied to this asset.
          items:
            $ref: "#/components/schemas/SearchQueryTagInfo"
          type:
            - array
            - "null"
        webproperty_v1:
          $ref: "#/components/schemas/WebpropertyAsset"
      type: object
    SearchQueryInputBody:
      additionalProperties: false
      properties:
        fields:
          description: 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.
          examples:
            - host.ip
          items:
            type: string
          type:
            - array
            - "null"
        page_size:
          description: Number of results to return to per page. The default and maximum is 100.
          examples:
            - "1"
          format: int64
          minimum: 0
          type:
            - integer
            - "null"
        page_token:
          description: page token for the requested page of search results
          type: string
        query:
          description: CenQL query string to search upon
          examples:
            - "host.services: (protocol=SSH and not port: 22)"
          type: string
      required:
        - query
      type: object
    SearchQueryResponse:
      additionalProperties: false
      properties:
        hits:
          items:
            $ref: "#/components/schemas/SearchQueryHit"
          type:
            - array
            - "null"
        next_page_token:
          type: string
        previous_page_token:
          type: string
        query_duration_millis:
          format: int32
          type: integer
        total_hits:
          format: double
          type: number
      required:
        - total_hits
        - next_page_token
        - previous_page_token
        - query_duration_millis
        - hits
      type: object
    SearchQueryTagInfo:
      additionalProperties: false
      properties:
        display_name:
          description: Name of the tag.
          type: string
        id:
          description: ID of the tag.
          format: uuid
          type: string
      required:
        - display_name
      type: object
    SearchValueCountsInputBody:
      additionalProperties: false
      properties:
        and_count_conditions:
          description: Groups of field-value pairs to count matches for. Each group may contain up to 5 field-value pairs.
          items:
            $ref: "#/components/schemas/CountCondition"
          type:
            - array
            - "null"
        query:
          description: CenQL query string to filter documents
          type: string
      required:
        - and_count_conditions
      type: object
    SecurityAdvisories:
      additionalProperties: false
      properties:
        advisories:
          description: The complete advisory identity catalog, including advisories without findings.
          items:
            $ref: "#/components/schemas/AdvisoryIdentity"
          type: array
        total_count:
          description: The total number of advisories in the catalog.
          format: int64
          type: integer
      required:
        - advisories
        - total_count
      type: object
    SecurityCapabilities:
      additionalProperties: false
      properties:
        access_policy_config:
          type: boolean
        default_access_policy:
          type: boolean
        dot1x:
          type: boolean
        http_digest:
          type: boolean
        kerberos_token:
          type: boolean
        max_password_length:
          format: int32
          minimum: 0
          type: integer
        max_username_length:
          format: int32
          minimum: 0
          type: integer
        max_users:
          format: int32
          minimum: 0
          type: integer
        onboard_key_generation:
          type: boolean
        rel_token:
          type: boolean
        remote_user_handling:
          type: boolean
        saml_token:
          type: boolean
        supported_eap_methods:
          format: int32
          minimum: 0
          type: integer
        tls_1_0:
          type: boolean
        tls_1_1:
          type: boolean
        tls_1_2:
          type: boolean
        username_token:
          type: boolean
        x509_token:
          type: boolean
      type: object
    Ser2Net:
      additionalProperties: false
      properties:
        device:
          type: string
        os:
          type: string
        serial_parameters:
          $ref: "#/components/schemas/Ser2Net_SerialParameters"
        software:
          type: string
        software_version:
          type: string
      type: object
    Ser2Net_SerialParameters:
      additionalProperties: false
      properties:
        baud_rate:
          type: string
        data_bits:
          type: string
        parity:
          type: string
        stop_bits:
          type: string
      type: object
    ServerConfig:
      additionalProperties: false
      properties:
        allow_html:
          type: boolean
        image_message_length:
          format: int32
          minimum: 0
          type: integer
        max_bandwidth:
          format: int32
          minimum: 0
          type: integer
        max_users:
          format: int32
          minimum: 0
          type: integer
        message_length:
          format: int32
          minimum: 0
          type: integer
        recording_allowed:
          type: boolean
        welcome_text:
          type: string
      type: object
    ServerSync:
      additionalProperties: false
      properties:
        max_bandwidth:
          format: int32
          minimum: 0
          type: integer
        permissions:
          items:
            type: string
          type:
            - array
            - "null"
        welcome_text:
          type: string
      type: object
    Service:
      additionalProperties: false
      properties:
        activemq:
          $ref: "#/components/schemas/Activemq"
        amqp:
          $ref: "#/components/schemas/Amqp"
        anerma_cf_forth:
          $ref: "#/components/schemas/AnermaCfForth"
        any_connect:
          $ref: "#/components/schemas/AnyConnect"
        asterisk_manager_interface:
          $ref: "#/components/schemas/AsteriskManagerInterface"
        bacnet:
          $ref: "#/components/schemas/Bacnet"
        banner:
          format: utf8
          type: string
        banner_hash_sha256:
          format: hex
          type: string
        banner_hex:
          type: string
        bluemax_nuttcp:
          $ref: "#/components/schemas/BluemaxNuttcp"
        cert:
          $ref: "#/components/schemas/Certificate"
        checkpoint_topology:
          $ref: "#/components/schemas/CheckpointTopology"
        chromecast:
          $ref: "#/components/schemas/Chromecast"
        cisco_ipsla:
          $ref: "#/components/schemas/CiscoIpsla"
        cisco_sdwan_vdaemon:
          $ref: "#/components/schemas/CiscoSdwanVdaemon"
        clamav:
          $ref: "#/components/schemas/Clamav"
        clickhouse_native:
          $ref: "#/components/schemas/ClickHouseNative"
        cmore:
          $ref: "#/components/schemas/Cmore"
        cnord_security_center:
          $ref: "#/components/schemas/CnordSecurityCenter"
        coap:
          $ref: "#/components/schemas/Coap"
        comelit_icona:
          $ref: "#/components/schemas/ComelitIcona"
        compromises:
          items:
            $ref: "#/components/schemas/Risk"
          type:
            - array
            - "null"
        cortex_xdr_p2p:
          $ref: "#/components/schemas/CortexXdrP2P"
        crestron_cp3:
          $ref: "#/components/schemas/CrestronCp3"
        crestron_din_ap2:
          $ref: "#/components/schemas/CrestronDinAp2"
        cursor_on_target:
          $ref: "#/components/schemas/CursorOnTarget"
        cwmp:
          $ref: "#/components/schemas/Cwmp"
        darkcomet:
          $ref: "#/components/schemas/Darkcomet"
        darkgate:
          $ref: "#/components/schemas/Darkgate"
        dcerpc:
          $ref: "#/components/schemas/Dcerpc"
        denon_heos:
          $ref: "#/components/schemas/DenonHeos"
        dhcpdiscover:
          $ref: "#/components/schemas/Dhcpdiscover"
        dicom:
          $ref: "#/components/schemas/Dicom"
        dlt:
          $ref: "#/components/schemas/Dlt"
        dnp3:
          $ref: "#/components/schemas/Dnp3"
        dns:
          $ref: "#/components/schemas/Dns"
        dotnet_negotiate_stream:
          $ref: "#/components/schemas/DotnetNegotiateStream"
        dtls:
          $ref: "#/components/schemas/Dtls"
        dubbo:
          $ref: "#/components/schemas/Dubbo"
        dvr_ip:
          $ref: "#/components/schemas/DvrIp"
        eip:
          $ref: "#/components/schemas/Eip"
        elasticsearch_transport:
          $ref: "#/components/schemas/ElasticsearchTransport"
        elf_file:
          $ref: "#/components/schemas/ElfFile"
        endpoints:
          items:
            $ref: "#/components/schemas/EndpointScanState"
          type:
            - array
            - "null"
        epmd:
          $ref: "#/components/schemas/Epmd"
        etcd:
          $ref: "#/components/schemas/Etcd"
        ethereum:
          $ref: "#/components/schemas/Ethereum"
        exposures:
          items:
            $ref: "#/components/schemas/Risk"
          type:
            - array
            - "null"
        fins:
          $ref: "#/components/schemas/Fins"
        flash_socket_policy:
          $ref: "#/components/schemas/FlashSocketPolicy"
        fourd_server:
          $ref: "#/components/schemas/FourdServer"
        fox:
          $ref: "#/components/schemas/Fox"
        frps:
          $ref: "#/components/schemas/Frps"
        ftp:
          $ref: "#/components/schemas/Ftp"
        gearman:
          $ref: "#/components/schemas/Gearman"
        gemini:
          $ref: "#/components/schemas/Gemini"
        geovision_audio:
          $ref: "#/components/schemas/GeovisionAudio"
        giop:
          $ref: "#/components/schemas/Giop"
        gopher:
          $ref: "#/components/schemas/Gopher"
        gril_console:
          $ref: "#/components/schemas/GrilConsole"
        hajime:
          $ref: "#/components/schemas/Hajime"
        hardware:
          items:
            $ref: "#/components/schemas/Attribute"
          type:
            - array
            - "null"
        hid_vertx:
          $ref: "#/components/schemas/HidVertx"
        hikvision:
          $ref: "#/components/schemas/Hikvision"
        hoosat_htnd_grpc:
          $ref: "#/components/schemas/HoosatHtndGrpc"
        ibmnje:
          $ref: "#/components/schemas/Ibmnje"
        icap:
          $ref: "#/components/schemas/Icap"
        iec60870_5_104:
          $ref: "#/components/schemas/Iec608705104"
        ike:
          $ref: "#/components/schemas/Ike"
        imap:
          $ref: "#/components/schemas/Imap"
        iota:
          $ref: "#/components/schemas/Iota"
        ip:
          type: string
        iperf3:
          $ref: "#/components/schemas/Iperf3"
        ipmi:
          $ref: "#/components/schemas/Ipmi"
        ipp:
          $ref: "#/components/schemas/Ipp"
        isc_dhcp_omapi:
          $ref: "#/components/schemas/IscDhcpOmapi"
        iscsi:
          $ref: "#/components/schemas/Iscsi"
        ja4tscan:
          $ref: "#/components/schemas/JA4TScanScan"
        jarm:
          $ref: "#/components/schemas/JarmScan"
        java_rmi:
          $ref: "#/components/schemas/JavaRmi"
        kcodes_netusb:
          $ref: "#/components/schemas/KcodesNetusb"
        knxip:
          $ref: "#/components/schemas/Knxip"
        krpc:
          $ref: "#/components/schemas/Krpc"
        l2tp:
          $ref: "#/components/schemas/L2Tp"
        labels:
          items:
            $ref: "#/components/schemas/Label"
          type:
            - array
            - "null"
        ldap:
          $ref: "#/components/schemas/Ldap"
        libp2p:
          $ref: "#/components/schemas/Libp2P"
        lpd:
          $ref: "#/components/schemas/Lpd"
        managesieve:
          $ref: "#/components/schemas/Managesieve"
        manticore_sphinxapi:
          $ref: "#/components/schemas/ManticoreSphinxapi"
        mavlink:
          $ref: "#/components/schemas/Mavlink"
        mdns:
          $ref: "#/components/schemas/Mdns"
        melsec:
          $ref: "#/components/schemas/Melsec"
        memberlist:
          $ref: "#/components/schemas/Memberlist"
        memcached:
          $ref: "#/components/schemas/Memcached"
        mikrotik_winbox:
          $ref: "#/components/schemas/MikrotikWinbox"
        minecraft:
          $ref: "#/components/schemas/Minecraft"
        misconfigs:
          items:
            $ref: "#/components/schemas/Risk"
          type:
            - array
            - "null"
        mms:
          $ref: "#/components/schemas/Mms"
        modbus:
          $ref: "#/components/schemas/Modbus"
        monero_p2p:
          $ref: "#/components/schemas/MoneroP2P"
        mongodb:
          $ref: "#/components/schemas/Mongodb"
        mpls_ldp:
          $ref: "#/components/schemas/MplsLdp"
        mqtt:
          $ref: "#/components/schemas/Mqtt"
        mssql:
          $ref: "#/components/schemas/Mssql"
        murmur:
          $ref: "#/components/schemas/Murmur"
        mysql:
          $ref: "#/components/schemas/Mysql"
        mysqlx:
          $ref: "#/components/schemas/Mysqlx"
        nats_io:
          $ref: "#/components/schemas/NatsIo"
        nbd:
          $ref: "#/components/schemas/Nbd"
        nfs_mountd:
          $ref: "#/components/schemas/NfsMountd"
        nmea:
          $ref: "#/components/schemas/Nmea"
        nrpe:
          $ref: "#/components/schemas/Nrpe"
        ntp:
          $ref: "#/components/schemas/Ntp"
        ntrip:
          $ref: "#/components/schemas/Ntrip"
        onc:
          $ref: "#/components/schemas/Onc"
        onvif:
          $ref: "#/components/schemas/Onvif"
        opc_ua:
          $ref: "#/components/schemas/OpcUa"
        openflow:
          $ref: "#/components/schemas/Openflow"
        openvpn:
          $ref: "#/components/schemas/Openvpn"
        openvpn_mgmt:
          $ref: "#/components/schemas/OpenvpnMgmt"
        operating_systems:
          items:
            $ref: "#/components/schemas/Attribute"
          type:
            - array
            - "null"
        opw_fsc3000:
          $ref: "#/components/schemas/OpwFsc3000"
        oracle:
          $ref: "#/components/schemas/Oracle"
        orenco_atrtu:
          $ref: "#/components/schemas/OrencoAtrtu"
        otlp_grpc:
          $ref: "#/components/schemas/OtlpGrpc"
        pc_anywhere:
          $ref: "#/components/schemas/PcAnywhere"
        perforce_p4d:
          $ref: "#/components/schemas/PerforceP4D"
        pgbouncer:
          $ref: "#/components/schemas/Pgbouncer"
        pigeonhole:
          $ref: "#/components/schemas/Pigeonhole"
        pop3:
          $ref: "#/components/schemas/Pop3"
        port:
          format: int32
          minimum: 0
          type: integer
        portmap:
          $ref: "#/components/schemas/Portmap"
        postgres:
          $ref: "#/components/schemas/Postgres"
        pptp:
          $ref: "#/components/schemas/Pptp"
        profinet_cm:
          $ref: "#/components/schemas/ProfinetCm"
        protocol:
          type: string
        qdrant_grpc:
          $ref: "#/components/schemas/QdrantGrpc"
        r1soft_buagent:
          $ref: "#/components/schemas/R1SoftBuagent"
        rdate:
          $ref: "#/components/schemas/Rdate"
        rdp:
          $ref: "#/components/schemas/Rdp"
        realport:
          $ref: "#/components/schemas/Realport"
        redis:
          $ref: "#/components/schemas/Redis"
        redline:
          $ref: "#/components/schemas/Redline"
        redlion_crimson:
          $ref: "#/components/schemas/RedlionCrimson"
        redshift:
          $ref: "#/components/schemas/Redshift"
        reolink_baichuan:
          $ref: "#/components/schemas/ReolinkBaichuan"
        representative_info:
          $ref: "#/components/schemas/RepresentativeInfo"
        rifatron:
          $ref: "#/components/schemas/Rifatron"
        ripple:
          $ref: "#/components/schemas/Ripple"
        rlogin:
          $ref: "#/components/schemas/Rlogin"
        rocketmq:
          $ref: "#/components/schemas/Rocketmq"
        routeros_api:
          $ref: "#/components/schemas/RouterosApi"
        rtmp:
          $ref: "#/components/schemas/Rtmp"
        rtsp:
          $ref: "#/components/schemas/Rtsp"
        rustdesk_heartbeat:
          $ref: "#/components/schemas/RustdeskHeartbeat"
        rustdesk_relay:
          $ref: "#/components/schemas/RustdeskRelay"
        rustdesk_rendezvous:
          $ref: "#/components/schemas/RustdeskRendezvous"
        s7:
          $ref: "#/components/schemas/S7"
        sap_router:
          $ref: "#/components/schemas/SapRouter"
        sapient:
          $ref: "#/components/schemas/Sapient"
        scan_time:
          type: string
        scpi:
          $ref: "#/components/schemas/Scpi"
        screenshots:
          items:
            $ref: "#/components/schemas/Screenshot"
          type:
            - array
            - "null"
        ser2net:
          $ref: "#/components/schemas/Ser2Net"
        seven_days_to_die:
          $ref: "#/components/schemas/SevenDaysToDie"
        sip:
          $ref: "#/components/schemas/Sip"
        skinny:
          $ref: "#/components/schemas/Skinny"
        smb:
          $ref: "#/components/schemas/Smb"
        smtp:
          $ref: "#/components/schemas/Smtp"
        smux:
          $ref: "#/components/schemas/Smux"
        snmp:
          $ref: "#/components/schemas/Snmp"
        socks:
          $ref: "#/components/schemas/Socks"
        software:
          items:
            $ref: "#/components/schemas/Attribute"
          type:
            - array
            - "null"
        spice:
          $ref: "#/components/schemas/Spice"
        spotify_connect:
          $ref: "#/components/schemas/SpotifyConnect"
        ssdp:
          $ref: "#/components/schemas/Ssdp"
        ssh:
          $ref: "#/components/schemas/Ssh"
        steam:
          $ref: "#/components/schemas/Steam"
        stomp:
          $ref: "#/components/schemas/Stomp"
        stun:
          $ref: "#/components/schemas/Stun"
        syncthing_bep:
          $ref: "#/components/schemas/SyncthingBep"
        synergy:
          $ref: "#/components/schemas/Synergy"
        tacacs_plus:
          $ref: "#/components/schemas/TacacsPlus"
        tarantool:
          $ref: "#/components/schemas/Tarantool"
        taurus_stb:
          $ref: "#/components/schemas/TaurusStb"
        team_viewer:
          $ref: "#/components/schemas/TeamViewer"
        telexper_tlxp:
          $ref: "#/components/schemas/TelexperTlxp"
        telnet:
          $ref: "#/components/schemas/Telnet"
        threats:
          items:
            $ref: "#/components/schemas/Threat"
          type:
            - array
            - "null"
        thrulay:
          $ref: "#/components/schemas/Thrulay"
        tibia:
          $ref: "#/components/schemas/Tibia"
        tls:
          $ref: "#/components/schemas/Tls"
        tplink_kasa:
          $ref: "#/components/schemas/TplinkKasa"
        transport_protocol:
          enum:
            - ""
            - tcp
            - udp
            - icmp
            - quic
          type: string
        tvt_control:
          $ref: "#/components/schemas/TvtControl"
        twamp_control:
          $ref: "#/components/schemas/TwampControl"
        unitronics_pcom:
          $ref: "#/components/schemas/UnitronicsPcom"
        upnp:
          $ref: "#/components/schemas/Upnp"
        utilinet_lpp:
          $ref: "#/components/schemas/UtilinetLpp"
        vantage_infusion:
          $ref: "#/components/schemas/VantageInfusion"
        ventrilo:
          $ref: "#/components/schemas/Ventrilo"
        visionhitech_ipcam:
          $ref: "#/components/schemas/VisionhitechIpcam"
        vnc:
          $ref: "#/components/schemas/Vnc"
        vulns:
          items:
            $ref: "#/components/schemas/Vuln"
          type:
            - array
            - "null"
        weblogic_t3:
          $ref: "#/components/schemas/WeblogicT3"
        wince_cerdisp:
          $ref: "#/components/schemas/WinceCerdisp"
        winrm:
          $ref: "#/components/schemas/Winrm"
        wow_realmd:
          $ref: "#/components/schemas/WowRealmd"
        ws_discovery:
          $ref: "#/components/schemas/WsDiscovery"
        x11:
          $ref: "#/components/schemas/X11"
        zeromq:
          $ref: "#/components/schemas/Zeromq"
      type: object
    ServiceId:
      additionalProperties: false
      properties:
        ip:
          type: string
        port:
          format: int32
          minimum: 0
          type: integer
        protocol:
          type: string
        transport_protocol:
          enum:
            - ""
            - tcp
            - udp
            - icmp
            - quic
          type: string
      type: object
    ServiceOnHostRange:
      additionalProperties: false
      properties:
        end_time:
          description: When the service was last observed
          format: date-time
          type: string
        ip:
          description: IP address where the service was observed
          type: string
        port:
          description: Port number where the service was observed
          type: string
        protocol:
          description: Application protocol (e.g., HTTP, HTTPS)
          type: string
        start_time:
          description: When the service was first observed
          format: date-time
          type: string
        transport_protocol:
          description: Transport protocol (e.g., TCP, UDP, QUIC)
          type: string
      required:
        - ip
        - port
        - protocol
        - transport_protocol
        - start_time
        - end_time
      type: object
    ServiceScan:
      additionalProperties: false
      properties:
        activemq:
          $ref: "#/components/schemas/Activemq"
        amqp:
          $ref: "#/components/schemas/Amqp"
        anerma_cf_forth:
          $ref: "#/components/schemas/AnermaCfForth"
        any_connect:
          $ref: "#/components/schemas/AnyConnect"
        asterisk_manager_interface:
          $ref: "#/components/schemas/AsteriskManagerInterface"
        bacnet:
          $ref: "#/components/schemas/Bacnet"
        banner:
          format: utf8
          type: string
        banner_hash_sha256:
          format: hex
          type: string
        bluemax_nuttcp:
          $ref: "#/components/schemas/BluemaxNuttcp"
        checkpoint_topology:
          $ref: "#/components/schemas/CheckpointTopology"
        chromecast:
          $ref: "#/components/schemas/Chromecast"
        cisco_ipsla:
          $ref: "#/components/schemas/CiscoIpsla"
        cisco_sdwan_vdaemon:
          $ref: "#/components/schemas/CiscoSdwanVdaemon"
        clamav:
          $ref: "#/components/schemas/Clamav"
        clickhouse_native:
          $ref: "#/components/schemas/ClickHouseNative"
        cmore:
          $ref: "#/components/schemas/Cmore"
        cnord_security_center:
          $ref: "#/components/schemas/CnordSecurityCenter"
        coap:
          $ref: "#/components/schemas/Coap"
        comelit_icona:
          $ref: "#/components/schemas/ComelitIcona"
        cortex_xdr_p2p:
          $ref: "#/components/schemas/CortexXdrP2P"
        crestron_cp3:
          $ref: "#/components/schemas/CrestronCp3"
        crestron_din_ap2:
          $ref: "#/components/schemas/CrestronDinAp2"
        cursor_on_target:
          $ref: "#/components/schemas/CursorOnTarget"
        cwmp:
          $ref: "#/components/schemas/Cwmp"
        darkcomet:
          $ref: "#/components/schemas/Darkcomet"
        darkgate:
          $ref: "#/components/schemas/Darkgate"
        dcerpc:
          $ref: "#/components/schemas/Dcerpc"
        denon_heos:
          $ref: "#/components/schemas/DenonHeos"
        dhcpdiscover:
          $ref: "#/components/schemas/Dhcpdiscover"
        dicom:
          $ref: "#/components/schemas/Dicom"
        dlt:
          $ref: "#/components/schemas/Dlt"
        dnp3:
          $ref: "#/components/schemas/Dnp3"
        dns:
          $ref: "#/components/schemas/Dns"
        dotnet_negotiate_stream:
          $ref: "#/components/schemas/DotnetNegotiateStream"
        dtls:
          $ref: "#/components/schemas/Dtls"
        dubbo:
          $ref: "#/components/schemas/Dubbo"
        dvr_ip:
          $ref: "#/components/schemas/DvrIp"
        eip:
          $ref: "#/components/schemas/Eip"
        elasticsearch_transport:
          $ref: "#/components/schemas/ElasticsearchTransport"
        elf_file:
          $ref: "#/components/schemas/ElfFile"
        epmd:
          $ref: "#/components/schemas/Epmd"
        etcd:
          $ref: "#/components/schemas/Etcd"
        ethereum:
          $ref: "#/components/schemas/Ethereum"
        fins:
          $ref: "#/components/schemas/Fins"
        flash_socket_policy:
          $ref: "#/components/schemas/FlashSocketPolicy"
        fourd_server:
          $ref: "#/components/schemas/FourdServer"
        fox:
          $ref: "#/components/schemas/Fox"
        frps:
          $ref: "#/components/schemas/Frps"
        ftp:
          $ref: "#/components/schemas/Ftp"
        gearman:
          $ref: "#/components/schemas/Gearman"
        gemini:
          $ref: "#/components/schemas/Gemini"
        geovision_audio:
          $ref: "#/components/schemas/GeovisionAudio"
        giop:
          $ref: "#/components/schemas/Giop"
        gopher:
          $ref: "#/components/schemas/Gopher"
        gril_console:
          $ref: "#/components/schemas/GrilConsole"
        hajime:
          $ref: "#/components/schemas/Hajime"
        hid_vertx:
          $ref: "#/components/schemas/HidVertx"
        hikvision:
          $ref: "#/components/schemas/Hikvision"
        hoosat_htnd_grpc:
          $ref: "#/components/schemas/HoosatHtndGrpc"
        ibmnje:
          $ref: "#/components/schemas/Ibmnje"
        icap:
          $ref: "#/components/schemas/Icap"
        iec60870_5_104:
          $ref: "#/components/schemas/Iec608705104"
        ike:
          $ref: "#/components/schemas/Ike"
        imap:
          $ref: "#/components/schemas/Imap"
        iota:
          $ref: "#/components/schemas/Iota"
        ip:
          type: string
        iperf3:
          $ref: "#/components/schemas/Iperf3"
        ipmi:
          $ref: "#/components/schemas/Ipmi"
        ipp:
          $ref: "#/components/schemas/Ipp"
        is_success:
          type: boolean
        isc_dhcp_omapi:
          $ref: "#/components/schemas/IscDhcpOmapi"
        iscsi:
          $ref: "#/components/schemas/Iscsi"
        java_rmi:
          $ref: "#/components/schemas/JavaRmi"
        kcodes_netusb:
          $ref: "#/components/schemas/KcodesNetusb"
        knxip:
          $ref: "#/components/schemas/Knxip"
        krpc:
          $ref: "#/components/schemas/Krpc"
        l2tp:
          $ref: "#/components/schemas/L2Tp"
        ldap:
          $ref: "#/components/schemas/Ldap"
        libp2p:
          $ref: "#/components/schemas/Libp2P"
        lpd:
          $ref: "#/components/schemas/Lpd"
        managesieve:
          $ref: "#/components/schemas/Managesieve"
        manticore_sphinxapi:
          $ref: "#/components/schemas/ManticoreSphinxapi"
        mavlink:
          $ref: "#/components/schemas/Mavlink"
        mdns:
          $ref: "#/components/schemas/Mdns"
        melsec:
          $ref: "#/components/schemas/Melsec"
        memberlist:
          $ref: "#/components/schemas/Memberlist"
        memcached:
          $ref: "#/components/schemas/Memcached"
        mikrotik_winbox:
          $ref: "#/components/schemas/MikrotikWinbox"
        minecraft:
          $ref: "#/components/schemas/Minecraft"
        mms:
          $ref: "#/components/schemas/Mms"
        modbus:
          $ref: "#/components/schemas/Modbus"
        monero_p2p:
          $ref: "#/components/schemas/MoneroP2P"
        mongodb:
          $ref: "#/components/schemas/Mongodb"
        mpls_ldp:
          $ref: "#/components/schemas/MplsLdp"
        mqtt:
          $ref: "#/components/schemas/Mqtt"
        mssql:
          $ref: "#/components/schemas/Mssql"
        murmur:
          $ref: "#/components/schemas/Murmur"
        mysql:
          $ref: "#/components/schemas/Mysql"
        mysqlx:
          $ref: "#/components/schemas/Mysqlx"
        nats_io:
          $ref: "#/components/schemas/NatsIo"
        nbd:
          $ref: "#/components/schemas/Nbd"
        nfs_mountd:
          $ref: "#/components/schemas/NfsMountd"
        nmea:
          $ref: "#/components/schemas/Nmea"
        nrpe:
          $ref: "#/components/schemas/Nrpe"
        ntp:
          $ref: "#/components/schemas/Ntp"
        ntrip:
          $ref: "#/components/schemas/Ntrip"
        onc:
          $ref: "#/components/schemas/Onc"
        onvif:
          $ref: "#/components/schemas/Onvif"
        opc_ua:
          $ref: "#/components/schemas/OpcUa"
        openflow:
          $ref: "#/components/schemas/Openflow"
        openvpn:
          $ref: "#/components/schemas/Openvpn"
        openvpn_mgmt:
          $ref: "#/components/schemas/OpenvpnMgmt"
        opw_fsc3000:
          $ref: "#/components/schemas/OpwFsc3000"
        oracle:
          $ref: "#/components/schemas/Oracle"
        orenco_atrtu:
          $ref: "#/components/schemas/OrencoAtrtu"
        otlp_grpc:
          $ref: "#/components/schemas/OtlpGrpc"
        pc_anywhere:
          $ref: "#/components/schemas/PcAnywhere"
        perforce_p4d:
          $ref: "#/components/schemas/PerforceP4D"
        pgbouncer:
          $ref: "#/components/schemas/Pgbouncer"
        pigeonhole:
          $ref: "#/components/schemas/Pigeonhole"
        pop3:
          $ref: "#/components/schemas/Pop3"
        port:
          format: int32
          minimum: 0
          type: integer
        portmap:
          $ref: "#/components/schemas/Portmap"
        postgres:
          $ref: "#/components/schemas/Postgres"
        pptp:
          $ref: "#/components/schemas/Pptp"
        profinet_cm:
          $ref: "#/components/schemas/ProfinetCm"
        protocol:
          type: string
        qdrant_grpc:
          $ref: "#/components/schemas/QdrantGrpc"
        r1soft_buagent:
          $ref: "#/components/schemas/R1SoftBuagent"
        rdate:
          $ref: "#/components/schemas/Rdate"
        rdp:
          $ref: "#/components/schemas/Rdp"
        realport:
          $ref: "#/components/schemas/Realport"
        redis:
          $ref: "#/components/schemas/Redis"
        redline:
          $ref: "#/components/schemas/Redline"
        redlion_crimson:
          $ref: "#/components/schemas/RedlionCrimson"
        redshift:
          $ref: "#/components/schemas/Redshift"
        reolink_baichuan:
          $ref: "#/components/schemas/ReolinkBaichuan"
        representative_info:
          $ref: "#/components/schemas/RepresentativeInfo"
        rifatron:
          $ref: "#/components/schemas/Rifatron"
        ripple:
          $ref: "#/components/schemas/Ripple"
        rlogin:
          $ref: "#/components/schemas/Rlogin"
        rocketmq:
          $ref: "#/components/schemas/Rocketmq"
        routeros_api:
          $ref: "#/components/schemas/RouterosApi"
        rtmp:
          $ref: "#/components/schemas/Rtmp"
        rtsp:
          $ref: "#/components/schemas/Rtsp"
        rustdesk_heartbeat:
          $ref: "#/components/schemas/RustdeskHeartbeat"
        rustdesk_relay:
          $ref: "#/components/schemas/RustdeskRelay"
        rustdesk_rendezvous:
          $ref: "#/components/schemas/RustdeskRendezvous"
        s7:
          $ref: "#/components/schemas/S7"
        sap_router:
          $ref: "#/components/schemas/SapRouter"
        sapient:
          $ref: "#/components/schemas/Sapient"
        scan_time:
          type: string
        scpi:
          $ref: "#/components/schemas/Scpi"
        screenshots:
          items:
            $ref: "#/components/schemas/Screenshot"
          type:
            - array
            - "null"
        ser2net:
          $ref: "#/components/schemas/Ser2Net"
        seven_days_to_die:
          $ref: "#/components/schemas/SevenDaysToDie"
        sip:
          $ref: "#/components/schemas/Sip"
        skinny:
          $ref: "#/components/schemas/Skinny"
        smb:
          $ref: "#/components/schemas/Smb"
        smtp:
          $ref: "#/components/schemas/Smtp"
        smux:
          $ref: "#/components/schemas/Smux"
        snmp:
          $ref: "#/components/schemas/Snmp"
        socks:
          $ref: "#/components/schemas/Socks"
        spice:
          $ref: "#/components/schemas/Spice"
        spotify_connect:
          $ref: "#/components/schemas/SpotifyConnect"
        ssdp:
          $ref: "#/components/schemas/Ssdp"
        ssh:
          $ref: "#/components/schemas/Ssh"
        steam:
          $ref: "#/components/schemas/Steam"
        stomp:
          $ref: "#/components/schemas/Stomp"
        stun:
          $ref: "#/components/schemas/Stun"
        syncthing_bep:
          $ref: "#/components/schemas/SyncthingBep"
        synergy:
          $ref: "#/components/schemas/Synergy"
        tacacs_plus:
          $ref: "#/components/schemas/TacacsPlus"
        tarantool:
          $ref: "#/components/schemas/Tarantool"
        taurus_stb:
          $ref: "#/components/schemas/TaurusStb"
        team_viewer:
          $ref: "#/components/schemas/TeamViewer"
        telexper_tlxp:
          $ref: "#/components/schemas/TelexperTlxp"
        telnet:
          $ref: "#/components/schemas/Telnet"
        thrulay:
          $ref: "#/components/schemas/Thrulay"
        tibia:
          $ref: "#/components/schemas/Tibia"
        tls:
          $ref: "#/components/schemas/Tls"
        tplink_kasa:
          $ref: "#/components/schemas/TplinkKasa"
        transport_protocol:
          enum:
            - ""
            - tcp
            - udp
            - icmp
            - quic
          type: string
        tvt_control:
          $ref: "#/components/schemas/TvtControl"
        twamp_control:
          $ref: "#/components/schemas/TwampControl"
        unitronics_pcom:
          $ref: "#/components/schemas/UnitronicsPcom"
        upnp:
          $ref: "#/components/schemas/Upnp"
        utilinet_lpp:
          $ref: "#/components/schemas/UtilinetLpp"
        vantage_infusion:
          $ref: "#/components/schemas/VantageInfusion"
        ventrilo:
          $ref: "#/components/schemas/Ventrilo"
        visionhitech_ipcam:
          $ref: "#/components/schemas/VisionhitechIpcam"
        vnc:
          $ref: "#/components/schemas/Vnc"
        weblogic_t3:
          $ref: "#/components/schemas/WeblogicT3"
        wince_cerdisp:
          $ref: "#/components/schemas/WinceCerdisp"
        winrm:
          $ref: "#/components/schemas/Winrm"
        wow_realmd:
          $ref: "#/components/schemas/WowRealmd"
        ws_discovery:
          $ref: "#/components/schemas/WsDiscovery"
        x11:
          $ref: "#/components/schemas/X11"
        zeromq:
          $ref: "#/components/schemas/Zeromq"
      type: object
    ServiceScanned:
      additionalProperties: false
      properties:
        diff:
          additionalProperties:
            $ref: "#/components/schemas/FieldDiff"
          type: object
        scan:
          $ref: "#/components/schemas/ServiceScan"
      type: object
    ServicesOnHostResponse:
      additionalProperties: false
      properties:
        next_page_token:
          description: A token that can be used to retrieve the next page of ranges.
          type: string
        ranges:
          description: The list of requested services.
          items:
            $ref: "#/components/schemas/ServiceOnHostRange"
          type:
            - array
            - "null"
      required:
        - ranges
        - next_page_token
      type: object
    SetMemberModuleRoleInputBody:
      additionalProperties: false
      properties:
        role:
          description: The role to assign in this module, for example gs_analyst.
          minLength: 1
          type: string
      required:
        - role
      type: object
    SevenDaysToDie:
      additionalProperties: false
      properties:
        game_name:
          type: string
        game_type:
          type: string
        region:
          type: string
        server_url:
          type: string
        server_version:
          type: string
        steam_id:
          type: string
        version:
          type: string
      type: object
    Signature:
      additionalProperties: false
      properties:
        self_signed:
          description: Whether the certificate was signed by its own key.
          type: boolean
        signature_algorithm:
          $ref: "#/components/schemas/KeyAlgorithm"
        valid:
          description: Whether the signature is valid.
          type: boolean
        value:
          description: Contents of the signature.
          format: hex
          type: string
      type: object
    SignedCertificateTimestamp:
      additionalProperties: false
      properties:
        log_id:
          format: hex
          type: string
        signature:
          $ref: "#/components/schemas/SignedCertificateTimestamp_Signature"
        timestamp:
          type: string
        version:
          format: int32
          type: integer
      type: object
    SignedCertificateTimestamp_Signature:
      additionalProperties: false
      properties:
        hash_algorithm:
          type: string
        signature:
          format: hex
          type: string
        signature_algorithm:
          type: string
      type: object
    Sip:
      additionalProperties: false
      properties:
        code:
          format: int32
          type: integer
        server:
          description: Server software reported by service
          type: string
        status:
          type: string
        version:
          description: SIP version
          type: string
      type: object
    Skinny:
      additionalProperties: false
      properties:
        response:
          format: hex
          type: string
      type: object
    Smb:
      additionalProperties: false
      properties:
        group_name:
          description: Default group name
          type: string
        has_ntlm:
          description: Server supports the NTLM authentication method
          type: boolean
        native_os:
          description: Server-identified operating system
          type: string
        negotiation_log:
          $ref: "#/components/schemas/Smb_NegotiationLog"
        ntlm:
          description: Native LAN manager
          type: string
        session_setup_log:
          $ref: "#/components/schemas/Smb_SessionSetupLog"
        smb_capabilities:
          $ref: "#/components/schemas/Smb_SmbCapabilities"
          description: Capabilities flags for the connection. See [MS-SMB2] Sect. 2.2.4.
        smb_version:
          $ref: "#/components/schemas/Smb_SmbVersions"
        smbv1_support:
          type: boolean
      type: object
    Smb_HeaderLog:
      additionalProperties: false
      properties:
        command:
          format: int32
          minimum: 0
          type: integer
        credits:
          format: int32
          minimum: 0
          type: integer
        flags:
          format: int32
          minimum: 0
          type: integer
        protocol_id:
          format: hex
          type: string
        status:
          format: int32
          minimum: 0
          type: integer
      type: object
    Smb_NegotiationLog:
      additionalProperties: false
      properties:
        authentication_types:
          items:
            type: string
          type:
            - array
            - "null"
        capabilities:
          format: int32
          minimum: 0
          type: integer
        dialect_revision:
          format: int32
          minimum: 0
          type: integer
        header_log:
          $ref: "#/components/schemas/Smb_HeaderLog"
        security_mode:
          format: int32
          minimum: 0
          type: integer
        server_guid:
          format: hex
          type: string
        server_start_time:
          format: int32
          minimum: 0
          type: integer
        system_time:
          format: int32
          minimum: 0
          type: integer
      type: object
    Smb_SessionSetupLog:
      additionalProperties: false
      properties:
        header_log:
          $ref: "#/components/schemas/Smb_HeaderLog"
        negotiate_flags:
          format: int32
          minimum: 0
          type: integer
        setup_flags:
          format: int32
          minimum: 0
          type: integer
        target_name:
          type: string
      type: object
    Smb_SmbCapabilities:
      additionalProperties: false
      properties:
        smb_dfs_support:
          description: Server supports Distributed File System
          type: boolean
        smb_directory_leasing_support:
          description: Server supports directory leasing
          type: boolean
        smb_encryption_support:
          description: Server supports encryption
          type: boolean
        smb_leasing_support:
          description: Server supports Leasing
          type: boolean
        smb_multichan_support:
          description: Server supports multiple channels per session
          type: boolean
        smb_multicredit_support:
          description: Server supports multi-credit operations
          type: boolean
        smb_persistent_handle_support:
          description: Server supports persistent handles
          type: boolean
      type: object
    Smb_SmbVersions:
      additionalProperties: false
      properties:
        major:
          description: Major version
          format: int32
          minimum: 0
          type: integer
        minor:
          description: Minor version
          format: int32
          minimum: 0
          type: integer
        revision:
          description: Protocol Revision
          format: int32
          minimum: 0
          type: integer
        version_string:
          description: Full SMB Version String
          type: string
      type: object
    Smtp:
      additionalProperties: false
      properties:
        ehlo:
          description: The server's response to the EHLO command.
          format: utf8
          type: string
        start_tls:
          description: The server's response to the STARTTLS command.
          format: utf8
          type: string
      type: object
    Smux:
      additionalProperties: false
      properties:
        close_reason_name:
          type: string
      type: object
    Snmp:
      additionalProperties: false
      properties:
        engine:
          $ref: "#/components/schemas/Snmp_Engine"
        oid_interfaces:
          $ref: "#/components/schemas/Snmp_Interfaces"
          description: 1.3.6.1.2.1.2 - Interfaces
        oid_physical:
          $ref: "#/components/schemas/Snmp_Physical"
          description: 1.3.6.1.2.1.47.1.1.1.1 - Entity Physical
        oid_system:
          $ref: "#/components/schemas/Snmp_System"
          description: 1.3.6.1.2.1.1 - System Variables
        versions:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    Snmp_Engine:
      additionalProperties: false
      properties:
        description:
          type: string
        engine_boots:
          format: int32
          minimum: 0
          type: integer
        engine_time:
          format: int32
          minimum: 0
          type: integer
        format:
          type: string
        format_data:
          format: hex
          type: string
        organization:
          type: string
        pen:
          format: int32
          minimum: 0
          type: integer
        raw_id:
          type: string
        rfc3411:
          type: boolean
      type: object
    Snmp_Interfaces:
      additionalProperties: false
      properties:
        num_ifaces:
          description: 1.3.6.1.2.1.2.1 - Number of network interfaces
          format: int32
          minimum: 0
          type: integer
      type: object
    Snmp_Physical:
      additionalProperties: false
      properties:
        firmware_rev:
          description: 1.3.6.1.2.1.47.1.1.1.1.9 - Firmware revision string
          type: string
        hardware_rev:
          description: 1.3.6.1.2.1.47.1.1.1.1.8 - Hardware revision string
          type: string
        mfg_name:
          description: 1.3.6.1.2.1.47.1.1.1.1.12 - Name of mfg
          type: string
        model_name:
          description: 1.3.6.1.2.1.47.1.1.1.1.13 - Model name of component
          type: string
        name:
          description: 1.3.6.1.2.1.47.1.1.1.1.7 - Entity name
          type: string
        serial_num:
          description: 1.3.6.1.2.1.47.1.1.1.1.11 - Serial number string
          type: string
        software_rev:
          description: 1.3.6.1.2.1.47.1.1.1.1.10 - Software revision string
          type: string
      type: object
    Snmp_System:
      additionalProperties: false
      properties:
        contact:
          description: 1.3.6.1.2.1.1.4 - Contact info
          type: string
        desc:
          description: 1.3.6.1.2.1.1.1 - Description of entity
          type: string
        init_time:
          description: 1.3.6.1.2.1.1.3 - 1/100ths of sec
          format: int32
          minimum: 0
          type: integer
        location:
          description: 1.3.6.1.2.1.1.6 - Physical location
          type: string
        name:
          description: 1.3.6.1.2.1.1.5 - Name, usually FQDN
          type: string
        object_id:
          description: 1.3.6.1.2.1.1.2 - Vendor ID
          type: string
        services:
          $ref: "#/components/schemas/Snmp_System_Services"
          description: 1.3.6.1.2.1.1.7 - Set of services offered by entity
      type: object
    Snmp_System_Services:
      additionalProperties: false
      properties:
        layer_1:
          description: Physical (e.g. repeaters)
          type: boolean
        layer_2:
          description: Datalink/subnetwork (e.g. bridges)
          type: boolean
        layer_3:
          description: Internet (e.g. IP gateways)
          type: boolean
        layer_4:
          description: End-to-end (e.g. IP hosts)
          type: boolean
        layer_5:
          description: OSI layer 5
          type: boolean
        layer_6:
          description: OSI layer 6
          type: boolean
        layer_7:
          description: Applications (e.g. mail relays)
          type: boolean
      type: object
    Socks:
      additionalProperties: false
      properties:
        no_authentication_required:
          type: boolean
        preferred_authentication:
          type: string
        preferred_authentication_value:
          format: int32
          minimum: 0
          type: integer
        socks_version:
          format: int64
          type: integer
        supported_versions:
          items:
            format: int64
            type: integer
          type:
            - array
            - "null"
      type: object
    SourceUsageBreakdown:
      additionalProperties: false
      properties:
        api:
          description: The amount of credits consumed through the Platform API.
          format: int64
          type: integer
        auto_replenishment:
          description: The amount of credits consumed through auto-replenishment.
          format: int64
          type: integer
        other:
          description: The amount of credits consumed through other operations.
          format: int64
          type: integer
        ui:
          description: The amount of credits consumed through the Platform UI.
          format: int64
          type: integer
      required:
        - ui
        - api
      type: object
    Spice:
      additionalProperties: false
      properties:
        major_version:
          format: int32
          minimum: 0
          type: integer
        minor_version:
          format: int32
          minimum: 0
          type: integer
        tls_only:
          type: boolean
        x509_public_key:
          format: base64
          type: string
      type: object
    SpotifyConnect:
      additionalProperties: false
      properties:
        account_req:
          type: string
        availability:
          type: string
        device_id:
          type: string
        group_status:
          type: string
        model_display_name:
          type: string
        public_key:
          format: hex
          type: string
        remote_name:
          type: string
        resolver_version:
          type: string
        scope:
          type: string
        status:
          type: string
        token_type:
          type: string
        version:
          type: string
        voice_support:
          type: boolean
      type: object
    Ssdp:
      additionalProperties: false
      properties:
        headers:
          additionalProperties:
            $ref: "#/components/schemas/Http_RepeatedHeaders"
          type: object
        upnp_url:
          type: string
      type: object
    Ssh:
      additionalProperties: false
      properties:
        algorithm_selection:
          $ref: "#/components/schemas/Ssh_AlgorithmSelection"
        endpoint_id:
          $ref: "#/components/schemas/Ssh_EndpointId"
        hassh_fingerprint:
          type: string
        kex_init_message:
          $ref: "#/components/schemas/Ssh_KexInitMessage"
        server_host_key:
          $ref: "#/components/schemas/Ssh_ServerHostKey"
      type: object
    Ssh_AlgorithmSelection:
      additionalProperties: false
      properties:
        client_to_server_alg_group:
          $ref: "#/components/schemas/Ssh_AlgorithmSelection_DirectionAlgorithms"
        host_key_algorithm:
          type: string
        kex_algorithm:
          type: string
        server_to_client_alg_group:
          $ref: "#/components/schemas/Ssh_AlgorithmSelection_DirectionAlgorithms"
      type: object
    Ssh_AlgorithmSelection_DirectionAlgorithms:
      additionalProperties: false
      properties:
        cipher:
          type: string
        compression:
          type: string
        mac:
          type: string
      type: object
    Ssh_EndpointId:
      additionalProperties: false
      properties:
        comment:
          type: string
        protocol_version:
          type: string
        raw:
          format: utf8
          type: string
        software_version:
          type: string
      type: object
    Ssh_KexInitMessage:
      additionalProperties: false
      properties:
        client_to_server_ciphers:
          description: A list of ssh cipher algorithm identifiers, named according to section 6 of https://www.ietf.org/rfc/rfc4251.txt; see https://www.iana.org/assignments/ssh-parameters/ssh-parameters.xhtml#ssh-parameters-16 for standard values.
          items:
            type: string
          type:
            - array
            - "null"
        client_to_server_compression:
          description: A list of ssh compression algorithm identifiers, named according to section 6 of https://www.ietf.org/rfc/rfc4251.txt; see https://www.iana.org/assignments/ssh-parameters/ssh-parameters.xhtml#ssh-parameters-20 for standard values.
          items:
            type: string
          type:
            - array
            - "null"
        client_to_server_languages:
          description: A name-list of language tags in order of preference. As Defined in https://www.ietf.org/rfc/rfc3066.txt.
          items:
            type: string
          type:
            - array
            - "null"
        client_to_server_macs:
          description: A list of ssh MAC algorithm identifiers, named according to section 6 of https://www.ietf.org/rfc/rfc4251.txt; see https://www.iana.org/assignments/ssh-parameters/ssh-parameters.xhtml#ssh-parameters-18 for standard values.
          items:
            type: string
          type:
            - array
            - "null"
        first_kex_follows:
          type: boolean
        host_key_algorithms:
          description: Asymmetric key algorithms for the host key supported by the client.
          items:
            type: string
          type:
            - array
            - "null"
        kex_algorithms:
          description: Key exchange algorithms used in the handshake.
          items:
            type: string
          type:
            - array
            - "null"
        server_to_client_ciphers:
          description: A list of ssh cipher algorithm identifiers, named according to section 6 of https://www.ietf.org/rfc/rfc4251.txt; see https://www.iana.org/assignments/ssh-parameters/ssh-parameters.xhtml#ssh-parameters-16 for standard values.
          items:
            type: string
          type:
            - array
            - "null"
        server_to_client_compression:
          description: A list of ssh compression algorithm identifiers, named according to section 6 of https://www.ietf.org/rfc/rfc4251.txt; see https://www.iana.org/assignments/ssh-parameters/ssh-parameters.xhtml#ssh-parameters-20 for standard values.
          items:
            type: string
          type:
            - array
            - "null"
        server_to_client_languages:
          description: A name-list of language tags in order of preference. As Defined in https://www.ietf.org/rfc/rfc3066.txt.
          items:
            type: string
          type:
            - array
            - "null"
        server_to_client_macs:
          description: A list of ssh MAC algorithm identifiers, named according to section 6 of https://www.ietf.org/rfc/rfc4251.txt; see https://www.iana.org/assignments/ssh-parameters/ssh-parameters.xhtml#ssh-parameters-18 for standard values.
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    Ssh_ServerHostKey:
      additionalProperties: false
      properties:
        certkey_public_key:
          format: utf8
          type: string
        dsa_public_key:
          $ref: "#/components/schemas/DSACryptographicKey"
        ecdsa_public_key:
          $ref: "#/components/schemas/ECDSACryptographicKey"
        ed25519_public_key:
          $ref: "#/components/schemas/ED25519CryptographicKey"
        fingerprint_sha256:
          format: hex
          type: string
        rsa_public_key:
          $ref: "#/components/schemas/RSACryptographicKey"
      type: object
    Status:
      additionalProperties: false
      properties:
        available_workers:
          format: int32
          type: integer
        function:
          type: string
        running:
          format: int32
          type: integer
        total:
          format: int32
          type: integer
      type: object
    Steam:
      additionalProperties: false
      properties:
        broadcasting_active:
          type: boolean
        connect_port:
          format: int32
          minimum: 0
          type: integer
        content_cache_port:
          format: int32
          minimum: 0
          type: integer
        download_lan_peer_group:
          format: int32
          minimum: 0
          type: integer
        enabled_services:
          format: int32
          minimum: 0
          type: integer
        euniverse:
          format: int32
          type: integer
        games_running:
          type: boolean
        hostname:
          type: string
        ip_addresses:
          items:
            type: string
          type:
            - array
            - "null"
        is64bit:
          type: boolean
        mac_addresses:
          items:
            type: string
          type:
            - array
            - "null"
        min_version:
          format: int32
          type: integer
        ostype:
          format: int32
          type: integer
        public_ip_address:
          type: string
        remoteplay_active:
          type: boolean
        screen_locked:
          type: boolean
        steam_deck:
          type: boolean
        steam_version:
          type: string
        supported_services:
          format: int32
          minimum: 0
          type: integer
        users:
          items:
            $ref: "#/components/schemas/User"
          type:
            - array
            - "null"
        version:
          format: int32
          type: integer
        vr_active:
          type: boolean
        vr_link_caps:
          type: string
      type: object
    Stomp:
      additionalProperties: false
      properties:
        error_message:
          type: string
        frame_type:
          type: string
        protocol_version:
          type: string
        server:
          type: string
        session:
          type: string
      type: object
    Stun:
      additionalProperties: false
      properties:
        binding_error_response:
          $ref: "#/components/schemas/Stun_BindingErrorResponse"
        binding_success_response:
          $ref: "#/components/schemas/Stun_BindingSuccessResponse"
        response_type:
          format: int32
          minimum: 0
          type: integer
        response_type_name:
          type: string
        turn:
          $ref: "#/components/schemas/Stun_Turn"
      type: object
    Stun_BindingErrorResponse:
      additionalProperties: false
      properties:
        error_code:
          format: int32
          type: integer
        error_reason:
          type: string
        has_fingerprint:
          type: boolean
        software:
          type: string
      type: object
    Stun_BindingSuccessResponse:
      additionalProperties: false
      properties:
        has_fingerprint:
          type: boolean
        other_address:
          $ref: "#/components/schemas/Stun_MappedAddress"
        software:
          type: string
      type: object
    Stun_MappedAddress:
      additionalProperties: false
      properties:
        ip:
          type: string
        port:
          format: int32
          minimum: 0
          type: integer
      type: object
    Stun_Turn:
      additionalProperties: false
      properties:
        allocate_error_response:
          $ref: "#/components/schemas/Stun_Turn_AllocateErrorResponse"
        allocate_success_response:
          $ref: "#/components/schemas/Stun_Turn_AllocateSuccessResponse"
        response_type:
          format: int32
          minimum: 0
          type: integer
        response_type_name:
          type: string
      type: object
    Stun_Turn_AllocateErrorResponse:
      additionalProperties: false
      properties:
        error_code:
          format: int32
          type: integer
        error_reason:
          type: string
        has_fingerprint:
          type: boolean
        nonce:
          type: string
        realm:
          type: string
        software:
          type: string
      type: object
    Stun_Turn_AllocateSuccessResponse:
      additionalProperties: false
      properties:
        has_fingerprint:
          type: boolean
        relay_address:
          $ref: "#/components/schemas/Stun_MappedAddress"
        software:
          type: string
      type: object
    SubjectInfo:
      additionalProperties: false
      properties:
        display_name:
          description: A human-readable name for the subject resource, if available. The value and format depend on the subject type and may be omitted if not applicable.
          type: string
        id:
          description: The unique identifier of the subject resource. The identifier format depends on the subject type (for example, a Censys user ID or ASM workspace ID). Not all events will have a subject ID.
          type: string
        type:
          description: The type of resource that was affected by the audited action.
          enum:
            - organization
            - user
            - saml_config
            - pat
            - collection
            - organization_membership
            - organization_invitation
            - asm_workspace
            - asm_seed
            - asm_exclude
            - asm_risk_type
            - asm_risk_instance
            - global_data
            - tag
            - comment
            - module_assignment
            - service_account
          type: string
      required:
        - type
      type: object
    SubjectKeyInfo:
      additionalProperties: false
      properties:
        dsa:
          $ref: "#/components/schemas/DsaPublicKey"
          description: A record containing the public portion of a DSA asymmetric key.
        ecdsa:
          $ref: "#/components/schemas/EcdsaPublicKey"
          description: A record containing the public portion of an ECDSA asymmetric key.
        fingerprint_sha256:
          description: The SHA-256 digest of the certificate's DER-encoded SubjectPublicKeyInfo.
          format: hex
          type: string
        key_algorithm:
          $ref: "#/components/schemas/KeyAlgorithm"
          description: A record containing information about the type of subject key algorithm and any relevant parameters.
        rsa:
          $ref: "#/components/schemas/RsaPublicKey"
          description: A record containing the public portion of an RSA asymmetric key.
        unrecognized:
          $ref: "#/components/schemas/UnrecognizedPublicKey"
          description: A record containing known information about an unrecognized key type.
      type: object
    SupplyChain:
      additionalProperties: false
      properties:
        id:
          description: Supply Chain ID.
          examples:
            - 11111111-2222-3333-4444-555555555555
          format: uuid
          type: string
        summary:
          $ref: "#/components/schemas/SupplyChainSummary"
          description: Summary of risks of all suppliers in the supply chain
        total_suppliers:
          description: Count of total suppliers in the supply chain
          format: int32
          type: integer
      required:
        - id
        - total_suppliers
      type: object
    SupplyChainAddSuppliersBody:
      additionalProperties: false
      properties:
        supplier_ids:
          description: The IDs of the Censys suppliers to add to the supply chain, each as a unique UUID string. Use the Search suppliers endpoint to find supplier IDs.
          examples:
            - - 11111111-2222-3333-4444-555555555555
          items:
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          maxItems: 1000
          minItems: 1
          type:
            - array
            - "null"
      required:
        - supplier_ids
      type: object
    SupplyChainAddSuppliersPayload:
      additionalProperties: false
      properties:
        added:
          description: The IDs of the suppliers that were added to the supply chain.
          items:
            type: string
          type:
            - array
            - "null"
      required:
        - added
      type: object
    SupplyChainAggregateAssetsBody:
      additionalProperties: false
      properties:
        count_by_level:
          description: "Specifies which document level's count is returned per term bucket, primarily for nested fields. This is the same functionality available in the Count By dropdown in the Report Builder UI. When aggregating on nested fields like 'host.services.port': empty string (default) counts documents at the deepest level containing the field; '.' counts root documents (e.g. counts matching 'host'); 'host.services' counts documents at the specified nested level."
          type: string
        field:
          description: field to aggregate by
          examples:
            - host.services.port
          type: string
        filter_by_query:
          default: false
          description: Controls whether aggregation results are limited to values that match the query. When true, only field values that satisfy the query constraints are included in aggregation counts. When false, aggregation includes all field values from records that match the query, even if those specific field values don't match the query constraints. For example, if the query is 'host.services.protocol=SSH' and you are aggregating by 'host.services.port' - when true, only shows SSH ports; when false, shows all ports on hosts that have SSH services.
          type: boolean
        number_of_buckets:
          description: number of buckets to split results into
          examples:
            - "100"
          format: int64
          maximum: 2000
          minimum: 1
          type: integer
        query:
          description: CenQL query string to search upon
          examples:
            - host.services.protocol=SSH
          type: string
        supplier_ids:
          description: The IDs of Censys suppliers in the supply chain to narrow the aggregation to, each as a unique UUID string. When omitted, the entire supply chain is aggregated.
          examples:
            - - 11111111-2222-3333-4444-555555555555
          items:
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          maxItems: 1000
          minItems: 1
          type:
            - array
            - "null"
      required:
        - query
        - field
        - number_of_buckets
      type: object
    SupplyChainAggregateBucket:
      additionalProperties: false
      properties:
        count:
          description: The number of assets in this bucket.
          format: int64
          type: integer
        key:
          description: The value of the aggregated field for this bucket.
          type: string
      required:
        - key
        - count
      type: object
    SupplyChainAggregateResponse:
      additionalProperties: false
      properties:
        buckets:
          description: The aggregated buckets, one per distinct field value.
          items:
            $ref: "#/components/schemas/SupplyChainAggregateBucket"
          type:
            - array
            - "null"
        is_more_than_total_hits:
          description: Whether the number of matching assets exceeds the accurately tracked hit count, meaning total_count is a lower bound rather than an exact value.
          type: boolean
        other_count:
          description: The number of matching assets not represented in the returned buckets.
          format: int64
          type: integer
        query_duration_millis:
          description: The time, in milliseconds, the query took to execute.
          format: int32
          type: integer
        total_count:
          description: The total number of assets matching the query.
          format: int64
          type: integer
      required:
        - total_count
        - other_count
        - query_duration_millis
        - is_more_than_total_hits
        - buckets
      type: object
    SupplyChainAssetDiscoveryPathSegment:
      additionalProperties: false
      properties:
        end:
          description: End asset for segment.
          type: string
        relationship:
          description: Explanation of how start entity is related to end entity.
          type: string
        start:
          description: Start asset for segment.
          type: string
      required:
        - start
        - end
        - relationship
      type: object
    SupplyChainAssetHit:
      additionalProperties: false
      properties:
        certificate_v1:
          $ref: "#/components/schemas/CertificateAsset"
        host_v1:
          $ref: "#/components/schemas/HostAssetWithMatchedServices"
        risk:
          $ref: "#/components/schemas/RiskInstance"
          description: Set when the hit is a risk instance, i.e. the query references risk.* fields.
        suppliers:
          description: Suppliers this asset is associated with.
          items:
            $ref: "#/components/schemas/SupplyChainAssetHitSupplier"
          type:
            - array
            - "null"
        tags:
          description: Tags applied to this asset.
          items:
            $ref: "#/components/schemas/SearchQueryTagInfo"
          type:
            - array
            - "null"
        webproperty_v1:
          $ref: "#/components/schemas/WebpropertyAsset"
      required:
        - suppliers
      type: object
    SupplyChainAssetHitSupplier:
      additionalProperties: false
      properties:
        discovery_paths:
          description: Lists of steps taken to show how an asset was discovered and attributed.
          items:
            items:
              $ref: "#/components/schemas/SupplyChainAssetDiscoveryPathSegment"
            type:
              - array
              - "null"
          type:
            - array
            - "null"
        display_name:
          description: Display name of the supplier.
          type: string
      required:
        - display_name
        - discovery_paths
      type: object
    SupplyChainGetPayload:
      additionalProperties: false
      properties:
        supply_chain:
          $ref: "#/components/schemas/SupplyChain"
          description: Supply chain for the organization.
      required:
        - supply_chain
      type: object
    SupplyChainListItem:
      additionalProperties: false
      properties:
        id:
          description: The ID of the supply chain.
          format: uuid
          type: string
        summary:
          $ref: "#/components/schemas/SupplyChainSummary"
          description: An AI-generated summary of the supply chain.
        total_suppliers:
          description: The number of suppliers in the supply chain.
          format: int32
          type: integer
      required:
        - id
        - total_suppliers
      type: object
    SupplyChainListPayload:
      additionalProperties: false
      properties:
        next_page_token:
          description: Pagination token for the next page of results, if any.
          type: string
        supply_chains:
          description: Supply chains for the organization.
          items:
            $ref: "#/components/schemas/SupplyChainListItem"
          type:
            - array
            - "null"
      required:
        - supply_chains
      type: object
    SupplyChainRisk:
      additionalProperties: false
      properties:
        asset_count:
          description: Total number of assets affected by this risk.
          format: int64
          type: integer
        confidence:
          description: Confidence score, from 0 to 1, that this risk is present.
          format: double
          type: number
        description:
          description: Description of the risk.
          type: string
        evidence:
          description: Evidence supporting the identification of this risk.
          type: string
        id:
          description: Unique identifier for the risk, e.g. a CVE ID.
          examples:
            - CVE-2016-20012
          type: string
        name:
          description: Human-readable name of the risk.
          type: string
        remediation:
          $ref: "#/components/schemas/SupplyChainRiskRemediation"
          description: Recommended remediation steps for the risk.
        severity:
          description: Severity of the risk.
          enum:
            - UNSPECIFIED
            - LOW
            - MEDIUM
            - HIGH
            - CRITICAL
          type: string
        type:
          description: "Risk category: vulns, misconfigs, or exposures."
          type: string
      required:
        - id
        - type
        - name
        - description
        - severity
        - remediation
        - confidence
        - asset_count
      type: object
    SupplyChainRiskInstanceHost:
      additionalProperties: false
      properties:
        ip:
          description: IP address of the host this risk was observed on.
          type: string
      required:
        - ip
      type: object
    SupplyChainRiskInstanceService:
      additionalProperties: false
      properties:
        port:
          description: Port the service runs on.
          format: int32
          minimum: 0
          type: integer
        protocol:
          description: Application protocol identified on the service, e.g. SSH, HTTP.
          type: string
        transport_protocol:
          description: Transport protocol of the service, e.g. TCP, UDP, ICMP, QUIC.
          type: string
      required:
        - transport_protocol
        - port
        - protocol
      type: object
    SupplyChainRiskInstanceSupplier:
      additionalProperties: false
      properties:
        display_name:
          description: Display name of the supplier.
          type: string
        id:
          description: Unique ID of the supplier.
          format: uuid
          type: string
      required:
        - id
      type: object
    SupplyChainRiskInstanceWeb:
      additionalProperties: false
      properties:
        hostname:
          description: Hostname of the web property this risk was observed on.
          type: string
        port:
          description: Port of the web property this risk was observed on.
          format: int32
          minimum: 0
          type: integer
      required:
        - hostname
        - port
      type: object
    SupplyChainRiskRemediation:
      additionalProperties: false
      properties:
        primary:
          description: Primary recommended remediation step.
          type: string
        secondary:
          description: Additional recommended remediation steps.
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    SupplyChainSearchAssetsBody:
      additionalProperties: false
      properties:
        fields:
          description: 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.
          examples:
            - host.ip
          items:
            type: string
          type:
            - array
            - "null"
        page_size:
          description: Number of results to return to per page. The default and maximum is 100.
          examples:
            - "1"
          format: int64
          minimum: 0
          type:
            - integer
            - "null"
        page_token:
          description: page token for the requested page of search results
          type: string
        query:
          description: CenQL query string to search upon
          examples:
            - "host.services: (protocol=SSH and not port: 22)"
          type: string
        supplier_ids:
          description: The IDs of Censys suppliers in the supply chain to narrow the search to, each as a unique UUID string. When omitted, the entire supply chain is searched.
          examples:
            - - 11111111-2222-3333-4444-555555555555
          items:
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          maxItems: 10000
          minItems: 1
          type:
            - array
            - "null"
      required:
        - query
      type: object
    SupplyChainSearchAssetsResponse:
      additionalProperties: false
      properties:
        hits:
          description: Assets matching the search.
          items:
            $ref: "#/components/schemas/SupplyChainAssetHit"
          type:
            - array
            - "null"
        next_page_token:
          description: Pagination token for the next page of results, if any.
          type: string
        previous_page_token:
          description: Pagination token for the previous page of results, if any.
          type: string
        query_duration_millis:
          description: The amount of time, in milliseconds, the search took to run.
          format: int32
          type: integer
        total_hits:
          description: Total number of assets matching the search.
          format: int64
          type: integer
      required:
        - total_hits
        - query_duration_millis
        - hits
      type: object
    SupplyChainSearchRisksResponse:
      additionalProperties: false
      properties:
        next_page_token:
          description: Pagination token for the next page of results, if any.
          type: string
        previous_page_token:
          description: Pagination token for the previous page of results, if any.
          type: string
        query_duration_millis:
          description: The amount of time, in milliseconds, the search took to run.
          format: int32
          type: integer
        risk_instances:
          description: Risk instances matching the search.
          items:
            $ref: "#/components/schemas/RiskInstance"
          type:
            - array
            - "null"
        supply_chain_id:
          description: The supply chain that was searched, resolved from 'default' if that was given.
          format: uuid
          type: string
        total_hits:
          description: Total number of risk instances matching the search.
          format: int64
          type: integer
      required:
        - supply_chain_id
        - total_hits
        - query_duration_millis
        - risk_instances
      type: object
    SupplyChainSearchSuppliersPayload:
      additionalProperties: false
      properties:
        suppliers:
          description: Suppliers matching the search keywords.
          items:
            $ref: "#/components/schemas/SupplyChainSupplier"
          type:
            - array
            - "null"
      required:
        - suppliers
      type: object
    SupplyChainSummary:
      additionalProperties: false
      properties:
        generated_at:
          description: Time stamp that corresponding AI summary was generated.
          format: date-time
          type: string
        text:
          description: AI generated summary.
          type: string
      required:
        - text
        - generated_at
      type: object
    SupplyChainSupplier:
      additionalProperties: false
      properties:
        city:
          description: Supplier headquarters city.
          type:
            - string
            - "null"
        continent:
          description: Supplier headquarters continent.
          type:
            - string
            - "null"
        country:
          description: Supplier headquarters country.
          type:
            - string
            - "null"
        created_at:
          description: Time stamp of when a supplier was added to a supply chain. This may not be present if the supplier has not been added to the supply chain.
          format: date-time
          type:
            - string
            - "null"
        description:
          description: Supplier description.
          type:
            - string
            - "null"
        display_name:
          description: Supplier display name.
          type:
            - string
            - "null"
        exposure_count:
          description: Number of exposures affecting the supplier's assets.
          format: int64
          type:
            - integer
            - "null"
        id:
          description: Supplier ID.
          examples:
            - 11111111-2222-3333-4444-555555555555
          format: uuid
          type: string
        legal_name:
          description: Supplier legal name.
          type:
            - string
            - "null"
        long_summary:
          $ref: "#/components/schemas/SupplyChainSummary"
          description: Long form summary of risks of a supplier
        matched_assets:
          description: Number of assets associated with the supplier.
          format: int64
          type:
            - integer
            - "null"
        misconfig_count:
          description: Number of misconfigurations affecting the supplier's assets.
          format: int64
          type:
            - integer
            - "null"
        region:
          description: Supplier headquarters region or state.
          type:
            - string
            - "null"
        short_summary:
          $ref: "#/components/schemas/SupplyChainSummary"
          description: Short form summary of risks of a supplier
        status:
          description: Status of populating available assets for a Supplier
          type:
            - string
            - "null"
        total_assets:
          description: Count of total assets used to build a risk profile for the supplier
          format: int64
          type:
            - integer
            - "null"
        updated_at:
          description: Time stamp of when a supplier's tracked assets may have been most recently updated. This may not be present if the supplier has not been added to the supply chain.
          format: date-time
          type:
            - string
            - "null"
        vuln_count:
          description: Number of vulnerabilities affecting the supplier's assets.
          format: int64
          type:
            - integer
            - "null"
        website:
          description: Supplier website URL.
          type:
            - string
            - "null"
      required:
        - id
      type: object
    SyncthingBep:
      additionalProperties: false
      properties:
        device_name:
          type: string
        num_connections:
          format: int32
          type: integer
        server_name:
          type: string
        timestamp:
          format: int64
          type: integer
        version:
          type: string
      type: object
    Synergy:
      additionalProperties: false
      properties:
        protocol_major:
          format: int32
          minimum: 0
          type: integer
        protocol_minor:
          format: int32
          minimum: 0
          type: integer
        protocol_version:
          type: string
      type: object
    SynologyDsm:
      additionalProperties: false
      properties:
        apis:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    SystemCapabilities:
      additionalProperties: false
      properties:
        discovery_bye:
          type: boolean
        discovery_resolve:
          type: boolean
        firmware_upgrade:
          type: boolean
        http_firmware_upgrade:
          type: boolean
        http_support_information:
          type: boolean
        http_system_backup:
          type: boolean
        http_system_logging:
          type: boolean
        remote_discovery:
          type: boolean
        storage_configuration:
          type: boolean
        system_backup:
          type: boolean
        system_logging:
          type: boolean
      type: object
    TacacsPlus:
      additionalProperties: false
      properties:
        data_length:
          format: int32
          minimum: 0
          type: integer
        flags:
          format: int32
          minimum: 0
          type: integer
        obfuscated:
          format: base64
          type: string
        seq_num:
          format: int32
          minimum: 0
          type: integer
        session_id:
          format: int32
          minimum: 0
          type: integer
        type:
          format: int32
          minimum: 0
          type: integer
        version:
          format: int32
          minimum: 0
          type: integer
      type: object
    Tag:
      additionalProperties: false
      properties:
        created_at:
          description: RFC3339 timestamp when the tag was created.
          format: date-time
          type: string
        created_by:
          description: The ID of the user or service account that created the tag.
          format: uuid
          type: string
        description:
          description: A human-readable description of the tag.
          type: string
        id:
          description: The unique ID of the tag.
          format: uuid
          type: string
        name:
          description: The display name of the tag.
          type: string
        privacy:
          description: 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.
          enum:
            - private
            - shared
          type: string
        updated_at:
          description: RFC3339 timestamp when the tag was last updated.
          format: date-time
          type: string
      required:
        - id
        - name
        - privacy
        - created_at
        - updated_at
        - created_by
      type: object
    TagAssignment:
      additionalProperties: false
      properties:
        asset_id:
          description: The identifier of the tagged asset (host IP, certificate SHA-256 fingerprint, or web property domain/IP:port).
          type: string
        asset_type:
          description: The inferred type of the asset.
          enum:
            - host
            - certificate
            - web_property
            - unknown
          type: string
        created_at:
          description: RFC3339 timestamp when the assignment was created.
          format: date-time
          type: string
        created_by:
          description: The ID of the user or service account that created the assignment.
          format: uuid
          type: string
        id:
          description: The unique ID of the assignment.
          format: uuid
          type: string
        platform_ref:
          description: A direct URL to the asset in the Censys platform.
          type: string
        tag_id:
          description: The ID of the tag.
          format: uuid
          type: string
      required:
        - id
        - tag_id
        - asset_id
        - asset_type
        - platform_ref
        - created_at
        - created_by
      type: object
    TagAssignmentsList:
      additionalProperties: false
      properties:
        assignments:
          description: The list of tag assignments.
          items:
            $ref: "#/components/schemas/TagAssignment"
          type:
            - array
            - "null"
        next_page_token:
          description: Token to retrieve the next page of results. Omitted when there are no more results.
          type: string
        total_size:
          description: Total number of assignments matching the filters.
          format: int64
          type: integer
      required:
        - assignments
        - total_size
      type: object
    TagOperation:
      additionalProperties: false
      properties:
        created_at:
          description: RFC3339 timestamp when the operation was created.
          format: date-time
          type: string
        ended_at:
          description: RFC3339 timestamp when the operation completed. Omitted while the operation is still in progress.
          format: date-time
          type: string
        error_message:
          description: Failure detail. Only set when the operation failed.
          type: string
        id:
          description: The unique ID of the operation.
          format: uuid
          type: string
        processed_count:
          description: The number of assets that have been processed so far.
          format: int64
          type: integer
        query:
          description: The CenQL query used to identify the assets to tag. Only set for bulk create operations.
          type: string
        status:
          description: The current status of the operation.
          enum:
            - pending
            - running
            - succeeded
            - limit_reached
            - failed
            - cancelled
          type: string
        status_message:
          description: A human-readable explanation of the operation's outcome, set once the operation finishes — for example, how many assets were assigned, or that the tag's plan asset limit was reached. For failed operations it mirrors error_message.
          type: string
        successful_count:
          description: The number of assets that have been successfully processed so far.
          format: int64
          type: integer
        tag_id:
          description: The ID of the tag the operation applies to.
          format: uuid
          type: string
        tag_name:
          description: Snapshot of the tag's display name at the time the operation was created.
          type: string
        total_count:
          description: The total number of assets the operation will process. For bulk create operations this is an approximate value set at the start; for bulk delete operations it is set at completion.
          format: int64
          type: integer
        type:
          description: Whether the operation creates or deletes tag assignments.
          enum:
            - bulk_create
            - bulk_delete
          type: string
      required:
        - id
        - tag_id
        - tag_name
        - type
        - status
        - total_count
        - processed_count
        - successful_count
        - created_at
      type: object
    TagOperationsList:
      additionalProperties: false
      properties:
        next_page_token:
          description: Token to retrieve the next page of results. Omitted when there are no more results.
          type: string
        operations:
          description: The list of tag operations.
          items:
            $ref: "#/components/schemas/TagOperation"
          type:
            - array
            - "null"
        total_size:
          description: Total number of operations matching the filters.
          format: int64
          type: integer
      required:
        - operations
        - total_size
      type: object
    TagsList:
      additionalProperties: false
      properties:
        next_page_token:
          description: Token to retrieve the next page of results. Omitted when there are no more results.
          type: string
        tags:
          description: The list of tags.
          items:
            $ref: "#/components/schemas/Tag"
          type:
            - array
            - "null"
        total_size:
          description: Total number of tags visible to the caller in this organization.
          format: int64
          type: integer
      required:
        - tags
        - total_size
      type: object
    TailscaleDerp:
      additionalProperties: false
      properties:
        public_key:
          format: hex
          type: string
      type: object
    Tarantool:
      additionalProperties: false
      properties:
        auth_type:
          type: string
        error_code:
          format: int64
          type: integer
        error_file:
          type: string
        error_message:
          type: string
        error_type:
          type: string
        instance_uuid:
          type: string
        mode:
          type: string
        response_error:
          type: string
        server_features:
          items:
            type: string
          type:
            - array
            - "null"
        server_iproto_version:
          format: int64
          minimum: 0
          type: integer
        version:
          type: string
      type: object
    Target:
      additionalProperties: false
      properties:
        alias:
          type: string
        auths:
          items:
            type: string
          type:
            - array
            - "null"
        dns_portals:
          items:
            type: string
          type:
            - array
            - "null"
        errors:
          items:
            type: string
          type:
            - array
            - "null"
        name:
          type: string
        private_portals:
          items:
            type: string
          type:
            - array
            - "null"
        public_portals:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    TaurusStb:
      additionalProperties: false
      properties:
        groups:
          items:
            $ref: "#/components/schemas/TaurusStb_Group"
          type:
            - array
            - "null"
      type: object
    TaurusStb_Group:
      additionalProperties: false
      properties:
        commands:
          items:
            type: string
          type:
            - array
            - "null"
        name:
          type: string
      type: object
    TeamViewer:
      additionalProperties: false
      properties:
        response:
          format: hex
          type: string
      type: object
    TelexperTlxp:
      additionalProperties: false
      properties:
        frame_type:
          type: string
        image_height_px:
          format: int32
          minimum: 0
          type: integer
        image_width_px:
          format: int32
          minimum: 0
          type: integer
      type: object
    Telnet:
      additionalProperties: false
      properties:
        do:
          additionalProperties:
            type:
              - string
              - "null"
          type: object
        dont:
          additionalProperties:
            type:
              - string
              - "null"
          type: object
        will:
          additionalProperties:
            type:
              - string
              - "null"
          type: object
        wont:
          additionalProperties:
            type:
              - string
              - "null"
          type: object
      type: object
    TextMessage:
      additionalProperties: false
      properties:
        actor:
          format: int32
          minimum: 0
          type: integer
        channel_id:
          items:
            format: int32
            minimum: 0
            type: integer
          type:
            - array
            - "null"
        message:
          type: string
        session:
          items:
            format: int32
            minimum: 0
            type: integer
          type:
            - array
            - "null"
        tree_id:
          items:
            format: int32
            minimum: 0
            type: integer
          type:
            - array
            - "null"
      type: object
    ThirdParty:
      additionalProperties: false
      properties:
        mallory:
          description: Threat intelligence records from MalloryAI.
          items:
            $ref: "#/components/schemas/MalloryAI"
          type:
            - array
            - "null"
      type: object
    Threat:
      additionalProperties: false
      properties:
        actors:
          items:
            $ref: "#/components/schemas/Threat_Actor"
          type:
            - array
            - "null"
        confidence:
          format: double
          type: number
        details:
          $ref: "#/components/schemas/Threat_Details"
        evidence:
          items:
            $ref: "#/components/schemas/Evidence"
          type:
            - array
            - "null"
        id:
          type: string
        malware:
          $ref: "#/components/schemas/Threat_Malware"
        name:
          type: string
        source:
          enum:
            - ""
            - censys
            - recog
            - wappalyzer
            - third_party
            - html_meta_extractor
          type: string
        tactic:
          items:
            type: string
          type:
            - array
            - "null"
        type:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    ThreatListItem:
      additionalProperties: false
      properties:
        added_at:
          description: The date and time when the threat was added.
          format: date-time
          type: string
        count:
          description: Total count of assets affected by this threat.
          format: int64
          type: integer
        description:
          description: Detailed description of the threat.
          type: string
        host_count:
          description: Number of hosts affected by this threat.
          format: int64
          type: integer
        id:
          description: Unique identifier of the threat.
          type: string
        name:
          description: Human-readable name of the threat.
          type: string
        references:
          description: External reference links for the threat.
          items:
            $ref: "#/components/schemas/ThreatReference"
          type:
            - array
            - "null"
        web_count:
          description: Number of web properties affected by this threat.
          format: int64
          type: integer
      required:
        - id
        - count
        - host_count
        - web_count
      type: object
    ThreatOnHostRange:
      additionalProperties: false
      properties:
        end_time:
          description: When the threat was last observed
          format: date-time
          type: string
        ip:
          description: IP address where the threat was observed
          type: string
        port:
          description: Port number where the threat was observed
          type: string
        protocol:
          description: Application protocol (e.g., HTTP, HTTPS)
          type: string
        start_time:
          description: When the threat was first observed
          format: date-time
          type: string
        threat_name:
          description: Name of the detected threat
          type: string
        transport_protocol:
          description: Transport protocol (TCP or UDP)
          type: string
      required:
        - threat_name
        - ip
        - port
        - protocol
        - transport_protocol
        - start_time
        - end_time
      type: object
    ThreatOnWebRange:
      additionalProperties: false
      properties:
        end_time:
          description: When the threat was last observed
          format: date-time
          type: string
        start_time:
          description: When the threat was first observed
          format: date-time
          type: string
        threat_name:
          description: Name of the detected threat
          type: string
      required:
        - threat_name
        - start_time
        - end_time
      type: object
    ThreatReference:
      additionalProperties: false
      properties:
        link:
          description: URL reference link for the threat.
          type: string
      required:
        - link
      type: object
    Threat_Actor:
      additionalProperties: false
      properties:
        all_names:
          items:
            type: string
          type:
            - array
            - "null"
        id:
          type: string
        malpedia_group_id:
          type: string
        mitre_group_id:
          type: string
        primary_name:
          type: string
      type: object
    Threat_Details:
      additionalProperties: false
      properties:
        campaign_id:
          type: string
        campaign_theme:
          type: string
        control_servers:
          items:
            type: string
          type:
            - array
            - "null"
        version:
          type: string
      type: object
    Threat_Malware:
      additionalProperties: false
      properties:
        all_names:
          items:
            type: string
          type:
            - array
            - "null"
        id:
          type: string
        last_updated_at:
          type: string
        malpedia_id:
          type: string
        primary_name:
          type: string
      type: object
    ThreatsListResponse:
      additionalProperties: false
      properties:
        threats:
          description: List of active threats observed on the platform.
          items:
            $ref: "#/components/schemas/ThreatListItem"
          type:
            - array
            - "null"
      required:
        - threats
      type: object
    ThreatsOnHostResponse:
      additionalProperties: false
      properties:
        NextPageToken:
          type: string
        Ranges:
          items:
            $ref: "#/components/schemas/ThreatOnHostRange"
          type:
            - array
            - "null"
      required:
        - Ranges
        - NextPageToken
      type: object
    ThreatsOnWebResponse:
      additionalProperties: false
      properties:
        NextPageToken:
          type: string
        Ranges:
          items:
            $ref: "#/components/schemas/ThreatOnWebRange"
          type:
            - array
            - "null"
      required:
        - Ranges
        - NextPageToken
      type: object
    Thrulay:
      additionalProperties: false
      properties:
        negotiated_window_bytes:
          format: int32
          minimum: 0
          type: integer
        negotiation_reject_reason:
          type: string
        protocol_version:
          type: string
      type: object
    Tibia:
      additionalProperties: false
      properties:
        client_version:
          type: string
        location:
          type: string
        login_ip:
          type: string
        login_port:
          type: string
        name:
          type: string
        server:
          type: string
        url:
          type: string
        version:
          type: string
      type: object
    Tls:
      additionalProperties: false
      properties:
        cipher_selected:
          description: Cipher suite chosen for the exchange.
          type: string
        fingerprint_sha256:
          description: The SHA-256 digest of the entire raw certificate. Its unique identifier, which Censys uses to index certificates records.
          format: hex
          type: string
        ja3s:
          description: The JA3S fingerprint for this service.
          format: hex
          type: string
        ja4s:
          type: string
        key_exchange_group:
          description: "Key exchange group selected by the server: the TLS 1.3 key_share group or the TLS 1.2 ECDHE curve, e.g. X25519MLKEM768."
          type: string
        pqc_groups:
          description: Post-quantum TLS 1.3 key exchange groups the server accepts, e.g. X25519MLKEM768.
          items:
            type: string
          type:
            - array
            - "null"
        presented_chain:
          description: Certificate chain information.
          items:
            $ref: "#/components/schemas/Tls_Chain"
          type:
            - array
            - "null"
        version_selected:
          description: Certificate version v1(0), v2(1), v3(2).
          enum:
            - ""
            - ss_lv_2
            - ss_lv_3
            - tlsv1_0
            - tlsv1_1
            - tlsv1_2
            - tlsv1_3
            - dtlsv1_0
            - dtlsv1_2
            - dtlsv1_3
          type: string
        versions:
          items:
            $ref: "#/components/schemas/Tls_VersionData"
          type:
            - array
            - "null"
      type: object
    Tls_Chain:
      additionalProperties: false
      properties:
        fingerprint_sha256:
          description: SHA 256 fingerprint of the certificate in the certificate chain.
          format: hex
          type: string
        issuer_dn:
          description: Distinguished name of the entity that has signed and issued the certificate.
          type: string
        subject_dn:
          description: Distinguished name of the entity that the certificate belongs to.
          type: string
      type: object
    Tls_VersionData:
      additionalProperties: false
      properties:
        ja3s:
          format: hex
          type: string
        ja4s:
          type: string
        version:
          enum:
            - ""
            - ss_lv_2
            - ss_lv_3
            - tlsv1_0
            - tlsv1_1
            - tlsv1_2
            - tlsv1_3
            - dtlsv1_0
            - dtlsv1_2
            - dtlsv1_3
          type: string
      type: object
    TorServiceDescriptor:
      additionalProperties: false
      properties:
        algorithm_name:
          type: string
        hash:
          format: hex
          type: string
        hash_bits:
          format: int32
          type: integer
        onion:
          type: string
      type: object
    TplinkKasa:
      additionalProperties: false
      properties:
        active_mode:
          type: string
        brightness:
          format: int64
          type: integer
        dev_name:
          type: string
        err_code:
          format: int64
          type: integer
        feature:
          type: string
        hw_ver:
          type: string
        icon_hash:
          type: string
        led_off:
          format: int64
          type: integer
        mic_type:
          type: string
        model:
          type: string
        on_time:
          format: int64
          type: integer
        relay_state:
          format: int64
          type: integer
        rssi:
          format: int64
          type: integer
        sw_ver:
          type: string
        updating:
          format: int64
          type: integer
      type: object
    TrackedScan:
      additionalProperties: false
      properties:
        completed:
          type: boolean
        create_time:
          type: string
        target:
          $ref: "#/components/schemas/TrackedScan_ScanTarget"
        tasks:
          items:
            $ref: "#/components/schemas/TrackedScan_Task"
          type:
            - array
            - "null"
        tracked_scan_id:
          type: string
      type: object
    TrackedScan_ScanTarget:
      additionalProperties: false
      properties:
        host_port:
          $ref: "#/components/schemas/TrackedScan_ScanTarget_HostPort"
        hostname_port:
          $ref: "#/components/schemas/TrackedScan_ScanTarget_HostnamePort"
        service_id:
          $ref: "#/components/schemas/ServiceId"
        web_origin:
          $ref: "#/components/schemas/WebOrigin"
      type: object
    TrackedScan_ScanTarget_HostPort:
      additionalProperties: false
      properties:
        ip:
          type: string
        port:
          format: int32
          minimum: 0
          type: integer
      type: object
    TrackedScan_ScanTarget_HostnamePort:
      additionalProperties: false
      properties:
        hostname:
          type: string
        port:
          format: int32
          minimum: 0
          type: integer
      type: object
    TrackedScan_Task:
      additionalProperties: false
      properties:
        description:
          type: string
        status:
          enum:
            - ""
            - scanning
            - scanned
            - rejected
            - timed_out
            - completed
            - ignored
          type: string
        update_time:
          type: string
      type: object
    TvtControl:
      additionalProperties: false
      properties:
        mac_address:
          type: string
        vendor:
          type: string
      type: object
    TwampControl:
      additionalProperties: false
      properties:
        modes:
          items:
            type: string
          type:
            - array
            - "null"
        process_start_time:
          format: int64
          type: integer
      type: object
    UnitronicsPcom:
      additionalProperties: false
      properties:
        buffer_size:
          type: string
        hardware_version:
          type: string
        model:
          type: string
        model_executor:
          type: string
        model_op_executor:
          type: string
        name:
          type: string
        os_build:
          type: string
        os_version:
          type: string
        unique_id:
          format: int64
          type: integer
        unit_id:
          type: string
      type: object
    UnrecognizedPublicKey:
      additionalProperties: false
      properties:
        raw:
          format: hex
          type: string
      type: object
    UpdateCommentInputBody:
      additionalProperties: false
      properties:
        body:
          description: The updated comment body text.
          maxLength: 10000
          minLength: 1
          type: string
      required:
        - body
      type: object
    UpdateMemberRoleInputBody:
      additionalProperties: false
      properties:
        roles:
          description: The Platform-wide roles to assign to the user.
          items:
            enum:
              - admin
              - api_access
            type: string
          minItems: 0
          type:
            - array
            - "null"
      required:
        - roles
      type: object
    UpdateTagInputBody:
      additionalProperties: false
      properties:
        description:
          description: New description.
          maxLength: 1000
          type: string
        name:
          description: New display name. Must be unique within the organization.
          maxLength: 255
          minLength: 1
          type: string
        privacy:
          description: 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.
          enum:
            - private
            - shared
          type: string
      type: object
    Upnp:
      additionalProperties: false
      properties:
        devices:
          items:
            $ref: "#/components/schemas/Upnp_Device"
          type:
            - array
            - "null"
        endpoint:
          type: string
        headers:
          additionalProperties:
            $ref: "#/components/schemas/Http_RepeatedHeaders"
          type: object
        spec:
          $ref: "#/components/schemas/Upnp_SpecVersion"
      type: object
    Upnp_Device:
      additionalProperties: false
      properties:
        device_type:
          type: string
        friendly_name:
          type: string
        id:
          description: Censys-generated IDs representing a device tree
          format: int32
          type: integer
        manufacturer:
          type: string
        manufacturer_url:
          type: string
        model_description:
          type: string
        model_name:
          type: string
        model_number:
          type: string
        model_url:
          type: string
        parent_id:
          format: int32
          type: integer
        presentation_url:
          type: string
        serial_number:
          type: string
        service_list:
          items:
            $ref: "#/components/schemas/Upnp_Service"
          type:
            - array
            - "null"
        udn:
          type: string
        upc:
          type: string
      type: object
    Upnp_Service:
      additionalProperties: false
      properties:
        control_url:
          type: string
        event_sub_url:
          type: string
        scpd_url:
          type: string
        service_id:
          type: string
        service_type:
          type: string
      type: object
    Upnp_SpecVersion:
      additionalProperties: false
      properties:
        major:
          type: string
        minor:
          type: string
      type: object
    User:
      additionalProperties: false
      properties:
        auth_key_id:
          type: string
        steamid:
          type: string
      type: object
    UserCredits:
      additionalProperties: false
      properties:
        balance:
          description: The current credit balance for the user.
          format: int64
          type: integer
        resets_at:
          description: The date that the user's credits will be reset.
          format: date-time
          type: string
      required:
        - balance
      type: object
    UserNotice:
      additionalProperties: false
      properties:
        explicit_text:
          type: string
        notice_reference:
          $ref: "#/components/schemas/NoticeReference"
      type: object
    UtilinetLpp:
      additionalProperties: false
      properties:
        firmware_version:
          type: string
        local_radios:
          items:
            type: string
          type:
            - array
            - "null"
        logical_port_count:
          format: int32
          minimum: 0
          type: integer
        network_id:
          type: string
        security_level:
          format: int32
          minimum: 0
          type: integer
        security_modes:
          items:
            type: string
          type:
            - array
            - "null"
        wan_address:
          type: string
      type: object
    Validation:
      additionalProperties: false
      properties:
        apple:
          $ref: "#/components/schemas/RootStore"
          description: A record containing validation information about the certificate from the Apple root store.
        chrome:
          $ref: "#/components/schemas/RootStore"
          description: A record containing validation information about the certificate from the Chrome root store.
        microsoft:
          $ref: "#/components/schemas/RootStore"
          description: A record containing validation information about the certificate from the Microsoft root store.
        nss:
          $ref: "#/components/schemas/RootStore"
          description: A record containing validation information about the certificate from the Mozilla NSS root store.
      type: object
    ValidityPeriod:
      additionalProperties: false
      properties:
        length_seconds:
          description: The duration of the certificate's validity period, in seconds.
          format: int64
          type: integer
        not_after:
          description: An RFC-3339-formatted timestamp after which the certificate is no longer valid.
          type: string
        not_before:
          description: An RFC-3339-formatted timestamp before which the certificate is not valid.
          type: string
      type: object
    ValueCountsResponse:
      additionalProperties: false
      properties:
        and_count_results:
          items:
            format: double
            type: number
          type:
            - array
            - "null"
      required:
        - and_count_results
      type: object
    VantageInfusion:
      additionalProperties: false
      properties:
        equinox_message_type:
          type: string
        firmware_version:
          type: string
        host_command_error:
          type: string
      type: object
    Vault:
      additionalProperties: false
      properties:
        cluster_name:
          type: string
        enterprise:
          type: boolean
        initialized:
          type: boolean
        license_state:
          type: string
        sealed:
          type: boolean
        version:
          type: string
      type: object
    Ventrilo:
      additionalProperties: false
      properties:
        attributes:
          items:
            type: string
          type:
            - array
            - "null"
        messages:
          items:
            $ref: "#/components/schemas/Ventrilo_Message"
          type:
            - array
            - "null"
      type: object
    Ventrilo_Header:
      additionalProperties: false
      properties:
        cmd:
          format: int32
          minimum: 0
          type: integer
        data_key:
          format: int32
          minimum: 0
          type: integer
        header_key:
          format: int32
          minimum: 0
          type: integer
        id:
          format: int32
          minimum: 0
          type: integer
        total_length:
          format: int32
          minimum: 0
          type: integer
      type: object
    Ventrilo_Message:
      additionalProperties: false
      properties:
        body:
          format: base64
          type: string
        error:
          type: string
        header:
          $ref: "#/components/schemas/Ventrilo_Header"
      type: object
    VisionhitechIpcam:
      additionalProperties: false
      properties:
        codec:
          type: string
        constraint_set_flags:
          format: int32
          minimum: 0
          type: integer
        height:
          format: int32
          minimum: 0
          type: integer
        level_idc:
          type: string
        nal_type:
          items:
            type: string
          type:
            - array
            - "null"
        profile_idc:
          type: string
        sei_user_data:
          items:
            $ref: "#/components/schemas/VisionhitechIpcam_SeiUserData"
          type:
            - array
            - "null"
        width:
          format: int32
          minimum: 0
          type: integer
      type: object
    VisionhitechIpcam_SeiUserData:
      additionalProperties: false
      properties:
        data:
          format: hex
          type: string
        uuid:
          type: string
        uuid_name:
          type: string
      type: object
    Vnc:
      additionalProperties: false
      properties:
        connection_failed_reason:
          description: If server terminates handshake, the reason offered (if any)
          format: utf8
          type: string
        desktop_name:
          description: Desktop name provided by the server, capped at 255 bytes
          format: utf8
          type: string
        pixel_encoding:
          $ref: "#/components/schemas/Vnc_KeyValue"
        screen_info:
          $ref: "#/components/schemas/DesktopInfo"
        security_types:
          description: server-specified security options
          items:
            $ref: "#/components/schemas/Vnc_KeyValue"
          type:
            - array
            - "null"
        version:
          format: hex
          type: string
      type: object
    Vnc_KeyValue:
      additionalProperties: false
      properties:
        name:
          format: utf8
          type: string
        value:
          format: int32
          type: integer
      type: object
    Vuln:
      additionalProperties: false
      properties:
        confidence:
          format: double
          type: number
        cwes:
          items:
            $ref: "#/components/schemas/CWE"
          type:
            - array
            - "null"
        evidence:
          items:
            $ref: "#/components/schemas/Evidence"
          type:
            - array
            - "null"
        id:
          type: string
        kev:
          items:
            $ref: "#/components/schemas/KEV"
          type:
            - array
            - "null"
        metrics:
          $ref: "#/components/schemas/Metrics"
        name:
          type: string
        risk_source:
          enum:
            - ""
            - censys
            - cve
          type: string
        severity:
          enum:
            - ""
            - low
            - medium
            - high
            - critical
          type: string
        source:
          enum:
            - ""
            - censys
            - recog
            - wappalyzer
            - third_party
            - html_meta_extractor
          type: string
        type:
          items:
            type: string
          type:
            - array
            - "null"
        year:
          format: int32
          minimum: 0
          type: integer
      type: object
    WebOrigin:
      additionalProperties: false
      properties:
        hostname:
          type: string
        port:
          format: int32
          minimum: 0
          type: integer
      type: object
    WebTimelineEvent:
      additionalProperties: false
      properties:
        endpoint_scanned:
          $ref: "#/components/schemas/EndpointScanned"
        event_time:
          type: string
        jarm_scanned:
          $ref: "#/components/schemas/JarmScanned"
      type: object
    WebTimelineEventAsset:
      additionalProperties: false
      properties:
        extensions:
          additionalProperties: {}
          type: object
        resource:
          $ref: "#/components/schemas/WebTimelineEvent"
      required:
        - resource
        - extensions
      type: object
    WeblogicT3:
      additionalProperties: false
      properties:
        error:
          type: string
        error_message:
          type: string
        weblogic_version:
          type: string
      type: object
    Webproperty:
      additionalProperties: false
      properties:
        cert:
          $ref: "#/components/schemas/Certificate"
        compromises:
          items:
            $ref: "#/components/schemas/Risk"
          type:
            - array
            - "null"
        endpoints:
          items:
            $ref: "#/components/schemas/EndpointScanState"
          type:
            - array
            - "null"
        exposures:
          items:
            $ref: "#/components/schemas/Risk"
          type:
            - array
            - "null"
        hardware:
          items:
            $ref: "#/components/schemas/Attribute"
          type:
            - array
            - "null"
        hostname:
          type: string
        jarm:
          $ref: "#/components/schemas/JarmScan"
        labels:
          items:
            $ref: "#/components/schemas/Label"
          type:
            - array
            - "null"
        misconfigs:
          items:
            $ref: "#/components/schemas/Risk"
          type:
            - array
            - "null"
        operating_systems:
          items:
            $ref: "#/components/schemas/Attribute"
          type:
            - array
            - "null"
        port:
          format: int32
          minimum: 0
          type: integer
        scan_time:
          type: string
        software:
          items:
            $ref: "#/components/schemas/Attribute"
          type:
            - array
            - "null"
        threats:
          items:
            $ref: "#/components/schemas/Threat"
          type:
            - array
            - "null"
        tls:
          $ref: "#/components/schemas/Tls"
        vulns:
          items:
            $ref: "#/components/schemas/Vuln"
          type:
            - array
            - "null"
      type: object
    WebpropertyAsset:
      additionalProperties: false
      properties:
        extensions:
          additionalProperties: {}
          type: object
        resource:
          $ref: "#/components/schemas/Webproperty"
      required:
        - resource
        - extensions
      type: object
    WebpropertyTimeline:
      additionalProperties: false
      properties:
        events:
          items:
            $ref: "#/components/schemas/WebTimelineEventAsset"
          type:
            - array
            - "null"
        scanned_to:
          format: date-time
          type: string
      required:
        - events
        - scanned_to
      type: object
    Whois:
      additionalProperties: false
      properties:
        network:
          $ref: "#/components/schemas/Network"
        organization:
          $ref: "#/components/schemas/Organization"
      type: object
    WhoisUpdated:
      additionalProperties: false
      properties:
        diff:
          additionalProperties:
            $ref: "#/components/schemas/FieldDiff"
          type: object
        whois:
          $ref: "#/components/schemas/Whois"
      type: object
    WinceCerdisp:
      additionalProperties: false
      properties:
        color_depth_bpp:
          format: int32
          minimum: 0
          type: integer
        device_family:
          type: string
        device_id:
          type: string
        flags:
          format: int32
          minimum: 0
          type: integer
        manufacturer:
          type: string
        screen_height:
          format: int32
          minimum: 0
          type: integer
        screen_width:
          format: int32
          minimum: 0
          type: integer
        selector:
          format: int32
          minimum: 0
          type: integer
      type: object
    Winrm:
      additionalProperties: false
      properties:
        auth_types:
          items:
            type: string
          type:
            - array
            - "null"
        ntlm_info:
          $ref: "#/components/schemas/NtlmInfo"
      type: object
    Wordpress:
      additionalProperties: false
      properties:
        description:
          type: string
        gmt_offset:
          type: string
        home:
          type: string
        name:
          type: string
        namespaces:
          items:
            type: string
          type:
            - array
            - "null"
        timezone_string:
          type: string
      type: object
    Worker:
      additionalProperties: false
      properties:
        client_id:
          type: string
        fd:
          type: string
        functions:
          type: string
        ip:
          type: string
      type: object
    WowRealmd:
      additionalProperties: false
      properties:
        response_type:
          type: string
        result_name:
          type: string
      type: object
    WsDiscovery:
      additionalProperties: false
      properties:
        addresses:
          items:
            type: string
          type:
            - array
            - "null"
        metadata_version:
          format: int32
          minimum: 0
          type: integer
        scopes:
          items:
            type: string
          type:
            - array
            - "null"
        types:
          items:
            type: string
          type:
            - array
            - "null"
      type: object
    X11:
      additionalProperties: false
      properties:
        refusal_reason:
          type: string
        requires_authentication:
          type: boolean
        vendor:
          type: string
        version:
          type: string
      type: object
    ZLint:
      additionalProperties: false
      properties:
        errors_present:
          description: Whether the certificate's attributes triggered any error lints for non-conformance to the X.509 standard.
          type: boolean
        failed_lints:
          description: A list of lint names which failed, if applicable.
          items:
            type: string
          type:
            - array
            - "null"
        fatals_present:
          description: Whether the certificate's attributes triggered any fatal lints for non-conformance to the X.509 standard.
          type: boolean
        notices_present:
          description: Whether the certificate's attributes triggered any notice lints for non-conformance to the X.509 standard.
          type: boolean
        timestamp:
          description: An RFC-3339-formated timestamp indicating when the certificate was linted.
          type: string
        version:
          description: The version of Zlint used to lint the certificate.
          format: int64
          type: integer
        warnings_present:
          description: Whether the certificate's attributes triggered any warning lints for non-conformance to the X.509 standard.
          type: boolean
      type: object
    Zeromq:
      additionalProperties: false
      properties:
        greeting:
          $ref: "#/components/schemas/Zeromq_Greeting"
        handshake:
          $ref: "#/components/schemas/Zeromq_Handshake"
        subscription_data:
          format: hex
          type: string
        subscription_match:
          additionalProperties:
            type: boolean
          type: object
      type: object
    Zeromq_Greeting:
      additionalProperties: false
      properties:
        as_server:
          type: boolean
        mechanism:
          format: hex
          type: string
        signature:
          format: hex
          type: string
        version_major:
          format: int32
          minimum: 0
          type: integer
        version_minor:
          format: int32
          minimum: 0
          type: integer
      type: object
    Zeromq_Handshake:
      additionalProperties: false
      properties:
        raw:
          format: hex
          type: string
        ready:
          type: boolean
        socket_type:
          type: string
      type: object
  securitySchemes:
    PersonalAccessToken:
      description: Your Censys personal access token. These are managed in your [Account Settings](https://accounts.censys.io/settings/personal-access-tokens)
      scheme: bearer
      type: http
info:
  contact:
    email: support@censys.com
    name: Censys Inc.
    url: https://censys.com
  title: Censys Platform API
  version: 1.0.163
openapi: 3.1.0
paths:
  /v1/attacksurfaces:
    get:
      description: Retrieve the attack surfaces for your organization. Most organizations will have only one.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-attack-surface-list-attack-surfaces
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Maximum number of attack surfaces to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Maximum number of attack surfaces to return per page.
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from a previous response to retrieve the next page of results.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results.
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeAttackSurfacesList"
          description: Attack surfaces listed successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid page token
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, or the operation conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List attack surfaces
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListAttackSurfaces
    post:
      description: Create the attack surface for your organization. An organization can have only one attack surface. Censys begins discovering its assets as you add seeds to it.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-attack-surface-create-attack-surface
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeAttackSurface"
          description: Attack surface created successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, your organization already has an attack surface, or the request conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Create an attack surface
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: CreateAttackSurface
  /v1/attacksurfaces/{attack_surface_id}:
    delete:
      description: Delete an attack surface, including its seeds and exclusions. This cannot be undone. The attack surface must be named by its ID; the literal 'default' is not accepted.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-attack-surface-delete-attack-surface
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys attack surface. Obtain the attack surface ID using the [list attack surfaces endpoint](https://docs.censys.com/reference/v1-attack-surface-list-attack-surfaces#/).
          in: path
          name: attack_surface_id
          required: true
          schema:
            description: The ID of a Censys attack surface. Obtain the attack surface ID using the [list attack surfaces endpoint](https://docs.censys.com/reference/v1-attack-surface-list-attack-surfaces#/).
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
      responses:
        "204":
          description: Attack surface deleted successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Attack surface not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, or the operation conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Delete an attack surface
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: DeleteAttackSurface
    get:
      description: Retrieve an attack surface for your organization. Use the literal 'default' in place of the attack surface ID to retrieve your organization's attack surface.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-attack-surface-get-attack-surface
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
          in: path
          name: attack_surface_id
          required: true
          schema:
            description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeAttackSurface"
          description: Attack surface retrieved successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Attack surface not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, or the operation conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get an attack surface
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: GetAttackSurface
  /v1/attacksurfaces/{attack_surface_id}/aggregate:
    post:
      description: Aggregate the assets of your attack surface by a given field.<br><br>This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder/) in the Platform UI.
      operationId: v1-attack-surface-aggregate-assets
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
          in: path
          name: attack_surface_id
          required: true
          schema:
            description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SearchAggregateInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeAttackSurfaceAggregateResponse"
          description: Assets aggregated successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Attack surface not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, or the operation conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid query or inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Aggregate attack surface assets
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: AggregateAssets
  /v1/attacksurfaces/{attack_surface_id}/assets:
    get:
      description: Retrieve the assets that were added to an attack surface as seeds. Each `asset` is in the form you would send to add or remove it, except for types that cannot be named in a request (see `type`).<br><br>This endpoint does not cost credits to execute.
      operationId: v1-attack-surface-list-assets
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
          in: path
          name: attack_surface_id
          required: true
          schema:
            description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
        - description: Maximum number of assets to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 50
            description: Maximum number of assets to return per page.
            format: int32
            maximum: 200
            minimum: 1
            type: integer
        - description: Pagination token from a previous response to retrieve the next page of results.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results.
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeAttackSurfaceAssetsList"
          description: Assets listed successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid page token
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Attack surface not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, or the operation conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List the assets of an attack surface
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListAttackSurfaceAssets
    post:
      description: Add assets as seeds, the starting points from which Censys discovers the rest of your attack surface. Name each asset as an IP address, CIDR block, ASN (for example AS15169), domain, or certificate SHA-256 fingerprint. <br><br>You may submit up to 50 assets per request. Inputting an asset that you have previously added will not return an error.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-attack-surface-add-assets
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
          in: path
          name: attack_surface_id
          required: true
          schema:
            description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/AttackSurfaceAssetsRequest"
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeAttackSurfaceAssets"
          description: Assets applied successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Attack surface not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, or the operation conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs, such as an asset that is not an IP address, CIDR block, ASN, domain, or certificate SHA-256 fingerprint
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Add assets to an attack surface
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: AddAttackSurfaceAssets
  /v1/attacksurfaces/{attack_surface_id}/assets/{asset}:
    delete:
      description: Remove an asset that was added to an attack surface as a seed. Removing an asset that is not present is not an error.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-attack-surface-remove-asset
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
          in: path
          name: attack_surface_id
          required: true
          schema:
            description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
        - description: The asset to remove, as an IP address, CIDR block, ASN, domain, or certificate SHA-256 fingerprint, the same way it was added and listed (for example 8.8.8.8, 8.8.8.0/24, AS15169 or censys.io). A '/' in the value must be URL-encoded as '%2F'.
          in: path
          name: asset
          required: true
          schema:
            description: The asset to remove, as an IP address, CIDR block, ASN, domain, or certificate SHA-256 fingerprint, the same way it was added and listed (for example 8.8.8.8, 8.8.8.0/24, AS15169 or censys.io). A '/' in the value must be URL-encoded as '%2F'.
            examples:
              - 8.8.8.8
              - 8.8.8.0/24
              - AS15169
              - censys.io
            type: string
      responses:
        "204":
          description: Asset removed successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Attack surface not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, or the operation conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs, such as an asset that is not an IP address, CIDR block, ASN, domain, or certificate SHA-256 fingerprint
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Remove an asset from an attack surface
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: RemoveAttackSurfaceAsset
  /v1/attacksurfaces/{attack_surface_id}/excludes:
    get:
      description: Retrieve the assets that were excluded from an attack surface. Each `asset` is in the form you would send to add or remove it, except for types that cannot be named in a request (see `type`).<br><br>This endpoint does not cost credits to execute.
      operationId: v1-attack-surface-list-exclusions
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
          in: path
          name: attack_surface_id
          required: true
          schema:
            description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
        - description: Maximum number of assets to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 50
            description: Maximum number of assets to return per page.
            format: int32
            maximum: 200
            minimum: 1
            type: integer
        - description: Pagination token from a previous response to retrieve the next page of results.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results.
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeAttackSurfaceAssetsList"
          description: Assets listed successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid page token
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Attack surface not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, or the operation conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List the exclusions of an attack surface
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListAttackSurfaceExclusions
    post:
      description: Exclude assets so that Censys keeps them out of your attack surface. Name each asset as an IP address, CIDR block, ASN (for example AS15169), domain, or certificate SHA-256 fingerprint. <br><br>You may submit up to 50 assets per request. Inputting an asset that you have previously excluded will not return an error.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-attack-surface-exclude-assets
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
          in: path
          name: attack_surface_id
          required: true
          schema:
            description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/AttackSurfaceAssetsRequest"
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeAttackSurfaceAssets"
          description: Assets applied successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Attack surface not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, or the operation conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs, such as an asset that is not an IP address, CIDR block, ASN, domain, or certificate SHA-256 fingerprint
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Exclude assets from an attack surface
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ExcludeAttackSurfaceAssets
  /v1/attacksurfaces/{attack_surface_id}/excludes/{asset}:
    delete:
      description: Remove an exclusion, so that the asset is no longer kept out of an attack surface. Removing an asset that is not present is not an error.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-attack-surface-remove-exclusion
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
          in: path
          name: attack_surface_id
          required: true
          schema:
            description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
        - description: The asset to remove, as an IP address, CIDR block, ASN, domain, or certificate SHA-256 fingerprint, the same way it was added and listed (for example 8.8.8.8, 8.8.8.0/24, AS15169 or censys.io). A '/' in the value must be URL-encoded as '%2F'.
          in: path
          name: asset
          required: true
          schema:
            description: The asset to remove, as an IP address, CIDR block, ASN, domain, or certificate SHA-256 fingerprint, the same way it was added and listed (for example 8.8.8.8, 8.8.8.0/24, AS15169 or censys.io). A '/' in the value must be URL-encoded as '%2F'.
            examples:
              - 8.8.8.8
              - 8.8.8.0/24
              - AS15169
              - censys.io
            type: string
      responses:
        "204":
          description: Asset removed successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Attack surface not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, or the operation conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs, such as an asset that is not an IP address, CIDR block, ASN, domain, or certificate SHA-256 fingerprint
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Remove an exclusion from an attack surface
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: RemoveAttackSurfaceExclusion
  /v1/attacksurfaces/{attack_surface_id}/risk-events:
    get:
      description: Retrieve risk state-transition events (opened, resolved, reopened) of your attack surface. Events are returned in commit order. When polling for new events, always pass inserted_after_time, starting from the time the sync begins (or 1970-01-01T00:00:00Z for full history), and follow next_page_token until it is empty; events are then returned in insert order. For the next poll, pass the inserted_at and id of the last event processed as inserted_after_time and inserted_after_event_id. Without inserted_after_time, events are not returned in insert order, so the last event is not a reliable cursor. Restarting from an earlier event returns events again, so events should be deduplicated by id.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-attack-surface-list-risk-events
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
          in: path
          name: attack_surface_id
          required: true
          schema:
            description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
        - description: Filter to one or more change types. For multiple values, include comma-separated values.
          explode: false
          in: query
          name: change_types
          schema:
            description: Filter to one or more change types. For multiple values, include comma-separated values.
            items:
              enum:
                - opened
                - resolved
                - reopened
              type: string
            type:
              - array
              - "null"
            uniqueItems: true
        - description: Filter to one or more severities. For multiple values, include comma-separated values. Connectors are expected to default to HIGH,CRITICAL for alerting use cases.
          explode: false
          in: query
          name: severity
          schema:
            description: Filter to one or more severities. For multiple values, include comma-separated values. Connectors are expected to default to HIGH,CRITICAL for alerting use cases.
            items:
              enum:
                - LOW
                - MEDIUM
                - HIGH
                - CRITICAL
              type: string
            type:
              - array
              - "null"
            uniqueItems: true
        - description: Filter to one or more risk type IDs, up to 100, e.g. CVE-2021-44228. For multiple values, include comma-separated values.
          explode: false
          in: query
          name: risk_type_ids
          schema:
            description: Filter to one or more risk type IDs, up to 100, e.g. CVE-2021-44228. For multiple values, include comma-separated values.
            examples:
              - - CVE-2021-44228
            items:
              examples:
                - CVE-2021-44228
              maxLength: 512
              minLength: 1
              type: string
            maxItems: 100
            type:
              - array
              - "null"
            uniqueItems: true
        - description: Filter to risk events flagged (or not flagged) for rapid response. Omit to include both.
          explode: false
          in: query
          name: rapid_response
          schema:
            description: Filter to risk events flagged (or not flagged) for rapid response. Omit to include both.
            enum:
              - "true"
              - "false"
            type: string
        - description: Maximum number of risk events to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Maximum number of risk events to return per page.
            format: int32
            maximum: 1000
            minimum: 1
            type: integer
        - description: Only return events that occurred at or after this time. Must be a valid RFC3339 string, must be provided together with end_time, and cannot be combined with inserted_after_time.
          explode: false
          in: query
          name: start_time
          schema:
            description: Only return events that occurred at or after this time. Must be a valid RFC3339 string, must be provided together with end_time, and cannot be combined with inserted_after_time.
            examples:
              - "2026-09-01T00:00:00Z"
            format: date-time
            type: string
        - description: Only return events that occurred at or before this time. Must be a valid RFC3339 string, must be provided together with start_time, must not be before start_time, and cannot be combined with inserted_after_time.
          explode: false
          in: query
          name: end_time
          schema:
            description: Only return events that occurred at or before this time. Must be a valid RFC3339 string, must be provided together with start_time, must not be before start_time, and cannot be combined with inserted_after_time.
            examples:
              - "2026-10-01T00:00:00Z"
            format: date-time
            type: string
        - description: Pagination token from a previous response to retrieve the next page of results. When paginating, provide the same filters, start_time, end_time, inserted_after_time and inserted_after_event_id as the request that returned the token.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results. When paginating, provide the same filters, start_time, end_time, inserted_after_time and inserted_after_event_id as the request that returned the token.
            type: string
        - description: Only return events inserted after this time. Must be a valid RFC3339 string. When polling for new events, always include this, starting from the time the sync begins (or 1970-01-01T00:00:00Z for full history), then continue from the inserted_at of the last event processed. Cannot be combined with start_time and end_time.
          explode: false
          in: query
          name: inserted_after_time
          schema:
            description: Only return events inserted after this time. Must be a valid RFC3339 string. When polling for new events, always include this, starting from the time the sync begins (or 1970-01-01T00:00:00Z for full history), then continue from the inserted_at of the last event processed. Cannot be combined with start_time and end_time.
            examples:
              - "2026-10-01T00:00:00Z"
            format: date-time
            type: string
        - description: The id of the last event processed, used together with inserted_after_time. Of the events inserted at exactly inserted_after_time, only those whose id sorts after this one are returned. Requires inserted_after_time.
          explode: false
          in: query
          name: inserted_after_event_id
          schema:
            description: The id of the last event processed, used together with inserted_after_time. Of the events inserted at exactly inserted_after_time, only those whose id sorts after this one are returned. Requires inserted_after_time.
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeAttackSurfaceListRiskEventsResponse"
          description: Risk events returned successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid page token
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Attack surface not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, or the operation conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List attack surface risk events
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListRiskEvents
  /v1/attacksurfaces/{attack_surface_id}/search:
    post:
      description: Search the hosts, web properties and certificates of your attack surface. A query that references `risk.*` fields returns risk instances instead of assets. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax.
      operationId: v1-attack-surface-search-assets
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
          in: path
          name: attack_surface_id
          required: true
          schema:
            description: The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SearchQueryInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeAttackSurfaceSearchAssetsResponse"
          description: Assets found successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid page token
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Attack surface not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: The Exposure Management API is not enabled, or the operation conflicts with the attack surface's current state.
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid query or inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Search attack surface assets
      tags:
        - Exposure Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: SearchAssets
  /v1/supplychains:
    get:
      description: Retrieve the supply chain ID, supplier count, and summary for your organization.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-supply-chain-list-supply-chains
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Maximum number of supply chains to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Maximum number of supply chains to return per page.
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from a previous response to retrieve the next page of results.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results.
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeSupplyChainListPayload"
          description: Supply chains listed successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List supply chains
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListSupplyChains
  /v1/supplychains/suppliers:
    get:
      description: Search the list of available suppliers by display name, domain, and legal name keywords and retrieve their information (including `supplier_id`). This endpoint will return a maximum of 25 results and responses are not paginated.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-supply-chain-search-suppliers
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Search keywords matched against supplier names and metadata. For multiple values, include comma-separated values. Must be at least 3 characters; keywords longer than 256 characters are truncated.
          explode: false
          in: query
          name: keywords
          schema:
            description: Search keywords matched against supplier names and metadata. For multiple values, include comma-separated values. Must be at least 3 characters; keywords longer than 256 characters are truncated.
            examples:
              - - Censys
            items:
              type: string
            type:
              - array
              - "null"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeSupplyChainSearchSuppliersPayload"
          description: Suppliers found successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Search suppliers
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: SearchSuppliers
  /v1/supplychains/{supply_chain_id}:
    get:
      description: Retrieve a supply chain for an organization. Most organizations will only have one supply chain ID.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-supply-chain-get-supply-chain
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
          in: path
          name: supply_chain_id
          required: true
          schema:
            description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeSupplyChainGetPayload"
          description: Supply chain listed successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get supply chain
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: GetSupplyChain
  /v1/supplychains/{supply_chain_id}/assets/aggregate:
    post:
      description: Aggregate assets across your supply chain by a given field. By default, the aggregation covers every supplier in your supply chain. Provide `supplier_ids` to narrow it to specific suppliers. Use `default` as the supply chain ID to target your organization's primary supply chain.<br><br>This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder/) in the Platform UI.
      operationId: v1-supply-chain-aggregate-assets
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
          in: path
          name: supply_chain_id
          required: true
          schema:
            description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SupplyChainAggregateAssetsBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeSupplyChainAggregateResponse"
          description: Assets aggregated successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Aggregate supply chain assets
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: AggregateAssets
  /v1/supplychains/{supply_chain_id}/assets/search:
    post:
      description: Search for assets across your supply chain. By default the search covers every supplier in the supply chain. Provide `supplier_ids` to narrow your search. Use `default` as the supply chain ID to target your organization's primary supply chain. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax.
      operationId: v1-supply-chain-search-assets
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
          in: path
          name: supply_chain_id
          required: true
          schema:
            description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SupplyChainSearchAssetsBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeSupplyChainSearchAssetsResponse"
          description: Assets found successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Search supply chain assets
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: SearchAssets
  /v1/supplychains/{supply_chain_id}/risk-events:
    get:
      description: Retrieve risk state-transition events (`opened`, `resolved`, and `reopened`).<br><br>When polling for new events, always pass `inserted_after_time`, starting from the time the sync begins (or `1970-01-01T00:00:00Z` for full history), and follow `next_page_token` until it is empty. For the next poll, pass the `inserted_at` and `id` of the last event processed as `inserted_after_time` and `inserted_after_event_id`. Without `inserted_after_time`, events are not returned in insert order, so the last event is not a reliable cursor. Restarting from an earlier event returns events again, so events should be deduplicated by `id`.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-supply-chain-list-risk-events
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
          in: path
          name: supply_chain_id
          required: true
          schema:
            description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
        - description: Narrow results to one or more Censys suppliers. For multiple values, include comma-separated values. When omitted, every supplier in the supply chain is included.
          explode: false
          in: query
          name: supplier_ids
          schema:
            description: Narrow results to one or more Censys suppliers. For multiple values, include comma-separated values. When omitted, every supplier in the supply chain is included.
            examples:
              - - 11111111-2222-3333-4444-555555555555
            items:
              examples:
                - 11111111-2222-3333-4444-555555555555
              format: uuid
              type: string
            maxItems: 10000
            minItems: 1
            type:
              - array
              - "null"
            uniqueItems: true
        - description: Filter to one or more change types. For multiple values, include comma-separated values.
          explode: false
          in: query
          name: change_types
          schema:
            description: Filter to one or more change types. For multiple values, include comma-separated values.
            items:
              enum:
                - opened
                - resolved
                - reopened
              type: string
            type:
              - array
              - "null"
            uniqueItems: true
        - description: Filter to one or more severities. For multiple values, include comma-separated values. Connectors are expected to default to HIGH,CRITICAL for alerting use cases.
          explode: false
          in: query
          name: severity
          schema:
            description: Filter to one or more severities. For multiple values, include comma-separated values. Connectors are expected to default to HIGH,CRITICAL for alerting use cases.
            items:
              enum:
                - LOW
                - MEDIUM
                - HIGH
                - CRITICAL
              type: string
            type:
              - array
              - "null"
            uniqueItems: true
        - description: Filter to one or more risk type IDs, up to 100, e.g. CVE-2021-44228. For multiple values, include comma-separated values.
          explode: false
          in: query
          name: risk_type_ids
          schema:
            description: Filter to one or more risk type IDs, up to 100, e.g. CVE-2021-44228. For multiple values, include comma-separated values.
            examples:
              - - CVE-2021-44228
            items:
              examples:
                - CVE-2021-44228
              maxLength: 512
              minLength: 1
              type: string
            maxItems: 100
            type:
              - array
              - "null"
            uniqueItems: true
        - description: Filter to risk events flagged (or not flagged) for rapid response. Omit to include both.
          explode: false
          in: query
          name: rapid_response
          schema:
            description: Filter to risk events flagged (or not flagged) for rapid response. Omit to include both.
            enum:
              - "true"
              - "false"
            type: string
        - description: Maximum number of risk events to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Maximum number of risk events to return per page.
            format: int32
            maximum: 1000
            minimum: 1
            type: integer
        - description: Only return events that occurred at or after this time. Must be a valid RFC3339 string, must be provided together with end_time, and cannot be combined with inserted_after_time.
          explode: false
          in: query
          name: start_time
          schema:
            description: Only return events that occurred at or after this time. Must be a valid RFC3339 string, must be provided together with end_time, and cannot be combined with inserted_after_time.
            examples:
              - "2026-09-01T00:00:00Z"
            format: date-time
            type: string
        - description: Only return events that occurred at or before this time. Must be a valid RFC3339 string, must be provided together with start_time, must not be before start_time, and cannot be combined with inserted_after_time.
          explode: false
          in: query
          name: end_time
          schema:
            description: Only return events that occurred at or before this time. Must be a valid RFC3339 string, must be provided together with start_time, must not be before start_time, and cannot be combined with inserted_after_time.
            examples:
              - "2026-10-01T00:00:00Z"
            format: date-time
            type: string
        - description: Pagination token from a previous response to retrieve the next page of results. When paginating, provide the same filters, start_time, end_time, inserted_after_time and inserted_after_event_id as the request that returned the token.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results. When paginating, provide the same filters, start_time, end_time, inserted_after_time and inserted_after_event_id as the request that returned the token.
            type: string
        - description: Only return events inserted after this time. Must be a valid RFC3339 string. When polling for new events, always include this, starting from the time the sync begins (or 1970-01-01T00:00:00Z for full history), then continue from the inserted_at of the last event processed. Cannot be combined with start_time and end_time.
          explode: false
          in: query
          name: inserted_after_time
          schema:
            description: Only return events inserted after this time. Must be a valid RFC3339 string. When polling for new events, always include this, starting from the time the sync begins (or 1970-01-01T00:00:00Z for full history), then continue from the inserted_at of the last event processed. Cannot be combined with start_time and end_time.
            examples:
              - "2026-10-01T00:00:00Z"
            format: date-time
            type: string
        - description: The id of the last event processed, used together with inserted_after_time. Of the events inserted at exactly inserted_after_time, only those whose id sorts after this one are returned. Requires inserted_after_time.
          explode: false
          in: query
          name: inserted_after_event_id
          schema:
            description: The id of the last event processed, used together with inserted_after_time. Of the events inserted at exactly inserted_after_time, only those whose id sorts after this one are returned. Requires inserted_after_time.
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListRiskEventsResponse"
          description: Risk events returned successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List risk events
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListRiskEvents
  /v1/supplychains/{supply_chain_id}/risk-instances:
    get:
      description: Retrieve individual risk instances (one risk type observed on one asset belonging to one supplier) across your supply chain. By default the entire supply chain is searched. Provide `supplier_ids` to narrow your search.<br><br>For risk-type aggregations, use the [list risks endpoint](https://docs.censys.com/reference/v1-supply-chain-list-risks).
      operationId: v1-supply-chain-list-risk-instances
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
          in: path
          name: supply_chain_id
          required: true
          schema:
            description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
        - description: Narrow the search to one or more Censys suppliers in the supply chain. For multiple values, include comma-separated values. When omitted, the entire supply chain is searched.
          explode: false
          in: query
          name: supplier_ids
          schema:
            description: Narrow the search to one or more Censys suppliers in the supply chain. For multiple values, include comma-separated values. When omitted, the entire supply chain is searched.
            examples:
              - - 11111111-2222-3333-4444-555555555555
            items:
              examples:
                - 11111111-2222-3333-4444-555555555555
              format: uuid
              type: string
            maxItems: 10000
            minItems: 1
            type:
              - array
              - "null"
        - description: A CenQL query. When provided, must reference at least one risk field, for example risk.severity. Combined with severity/risk_type/resource_type/rapid_response, if set, using AND.
          explode: false
          in: query
          name: query
          schema:
            description: A CenQL query. When provided, must reference at least one risk field, for example risk.severity. Combined with severity/risk_type/resource_type/rapid_response, if set, using AND.
            type: string
        - description: Filter to a single risk severity. When omitted, every severity is included.
          explode: false
          in: query
          name: severity
          schema:
            description: Filter to a single risk severity. When omitted, every severity is included.
            enum:
              - UNSPECIFIED
              - LOW
              - MEDIUM
              - HIGH
              - CRITICAL
            type: string
        - description: Filter to a single risk category. When omitted, misconfigurations, vulnerabilities, exposures, and threats are all included.
          explode: false
          in: query
          name: risk_type
          schema:
            description: Filter to a single risk category. When omitted, misconfigurations, vulnerabilities, exposures, and threats are all included.
            enum:
              - misconfigs
              - vulns
              - exposures
              - threats
            type: string
        - description: Filter to risks observed on a single asset resource type. When omitted, hosts and web are both included.
          explode: false
          in: query
          name: resource_type
          schema:
            description: Filter to risks observed on a single asset resource type. When omitted, hosts and web are both included.
            enum:
              - hosts
              - web
            type: string
        - description: When true, filter to risk instances flagged for rapid response. When omitted or false, no filter is applied on this field.
          explode: false
          in: query
          name: rapid_response
          schema:
            default: false
            description: When true, filter to risk instances flagged for rapid response. When omitted or false, no filter is applied on this field.
            type: boolean
        - description: Sort order. When omitted, results are returned in the backend's default order.
          explode: false
          in: query
          name: order_by
          schema:
            description: Sort order. When omitted, results are returned in the backend's default order.
            enum:
              - last_detected_at_asc
              - last_detected_at_desc
              - created_at_asc
              - created_at_desc
            type: string
        - description: Maximum number of risk instances to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Maximum number of risk instances to return per page.
            format: int32
            maximum: 1000
            minimum: 1
            type: integer
        - description: Pagination token from a previous response to retrieve the next page of results.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results.
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeSupplyChainSearchRisksResponse"
          description: Risk instances returned successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List risk instances
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListRiskInstances
  /v1/supplychains/{supply_chain_id}/risk-instances/{risk_instance_id}:
    get:
      description: Retrieve a single risk instance using its `risk_instance_ID` and `supplier_id`. Use the [list risk instances](https://docs.censys.com/reference/v1-supply-chain-list-risk-instances) and [list risk events](https://docs.censys.com/reference/v1-supply-chain-list-risk-events) endpoints to retrieve risk instance IDs.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-supply-chain-get-risk-instance
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
          in: path
          name: supply_chain_id
          required: true
          schema:
            description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
        - description: The ID of the risk instance to retrieve.
          in: path
          name: risk_instance_id
          required: true
          schema:
            description: The ID of the risk instance to retrieve.
            format: uuid
            type: string
        - description: The ID of the Censys supplier the risk instance was found on.
          explode: false
          in: query
          name: supplier_id
          required: true
          schema:
            description: The ID of the Censys supplier the risk instance was found on.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeRiskInstance"
          description: Risk instance returned successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get risk instance
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: GetRiskInstance
  /v1/supplychains/{supply_chain_id}/risks:
    get:
      description: Retrieve the risks (vulnerabilities, misconfigurations, and exposures) present in your supply chain. By default the entire supply chain is searched. Provide `supplier_ids` to narrow your search. Use `default` as the supply chain ID to target your organization's primary supply chain.
      operationId: v1-supply-chain-list-risks
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
          in: path
          name: supply_chain_id
          required: true
          schema:
            description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
        - description: Narrow the search to one or more Censys suppliers in the supply chain. For multiple values, include comma-separated values. When omitted, the entire supply chain is searched.
          explode: false
          in: query
          name: supplier_ids
          schema:
            description: Narrow the search to one or more Censys suppliers in the supply chain. For multiple values, include comma-separated values. When omitted, the entire supply chain is searched.
            examples:
              - - 11111111-2222-3333-4444-555555555555
            items:
              examples:
                - 11111111-2222-3333-4444-555555555555
              format: uuid
              type: string
            maxItems: 1000
            minItems: 1
            type:
              - array
              - "null"
        - description: A CenQL query. When set, only risks present on assets matching this query are returned.
          explode: false
          in: query
          name: query
          schema:
            description: A CenQL query. When set, only risks present on assets matching this query are returned.
            type: string
        - description: Filter to a single risk category. When omitted, misconfigurations, vulnerabilities, and exposures are all included.
          explode: false
          in: query
          name: risk_type
          schema:
            description: Filter to a single risk category. When omitted, misconfigurations, vulnerabilities, and exposures are all included.
            enum:
              - misconfigs
              - vulns
              - exposures
            type: string
        - description: Filter to risks observed on a single asset resource type. When omitted, hosts and web are both included.
          explode: false
          in: query
          name: resource_type
          schema:
            description: Filter to risks observed on a single asset resource type. When omitted, hosts and web are both included.
            enum:
              - hosts
              - web
            type: string
        - description: Maximum number of risks to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Maximum number of risks to return per page.
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from a previous response to retrieve the next page of results.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results.
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListRisksPayload"
          description: Risk information returned successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List risks
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListRisks
  /v1/supplychains/{supply_chain_id}/security-advisories:
    get:
      description: Retrieve the complete catalog of Censys ARC Rapid Response advisory risks, including advisories without findings. You can use the returned `risk_query` in the `query` parameter in the [list risk instances endpoint](https://docs.censys.com/reference/v1-supply-chain-list-risk-instances) to determine whether your supply chain or a specific supplier is impacted by a Rapid Response risk.<br><br>If a Rapid Response risk does not have a `risk_query`, then no risk query is available  for it.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-supply-chain-list-security-advisories
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
          in: path
          name: supply_chain_id
          required: true
          schema:
            description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeSecurityAdvisories"
          description: OK
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List supply chain security advisories
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListSecurityAdvisories
  /v1/supplychains/{supply_chain_id}/suppliers:
    get:
      description: Retrieve a paginated list of all suppliers in your supply chain. Use `default` as the supply chain ID to target your organization's primary supply chain.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-supply-chain-list-suppliers
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
          in: path
          name: supply_chain_id
          required: true
          schema:
            description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
        - description: Maximum number of suppliers to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Maximum number of suppliers to return per page.
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from a previous response to retrieve the next page of results.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results.
            type: string
        - description: Returned values ordering. Can sort by name and created at time and can order by ascending and descending results.
          explode: false
          in: query
          name: order_by
          schema:
            default: name_asc
            description: Returned values ordering. Can sort by name and created at time and can order by ascending and descending results.
            enum:
              - name_asc
              - name_desc
              - created_at_asc
              - created_at_desc
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListSuppliersPayload"
          description: Supplier information returned successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List suppliers
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListSuppliers
    post:
      description: Add suppliers to your supply chain. Use the [search suppliers endpoint](https://docs.censys.com/reference/v1-supply-chain-search-suppliers#/) to find the IDs of suppliers to add. Use `default` as the supply chain ID to target your organization's primary supply chain.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-supply-chain-add-suppliers
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
          in: path
          name: supply_chain_id
          required: true
          schema:
            description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SupplyChainAddSuppliersBody"
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeSupplyChainAddSuppliersPayload"
          description: Suppliers added to the supply chain successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Supplier/supply chain not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid Inputs
        "429":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: A request or resource limit was reached
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Add suppliers to a supply chain
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: AddSuppliers
  /v1/supplychains/{supply_chain_id}/suppliers/{supplier_id}:
    delete:
      description: Remove a supplier from your supply chain. Use `default` as the supply chain ID to target your organization's primary supply chain.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-supply-chain-remove-supplier
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
          in: path
          name: supply_chain_id
          required: true
          schema:
            description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
        - description: The ID of a Censys supplier to remove from the given supply chain.
          in: path
          name: supplier_id
          required: true
          schema:
            description: The ID of a Censys supplier to remove from the given supply chain.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
      responses:
        "204":
          description: Supplier removed from supply chain successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Supplier/supply chain not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Remove a supplier from your supply chain
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: RemoveSupplier
    get:
      description: Retrieve information about a supplier in your supply chain. Use `default` as the supply chain ID to target your organization's primary supply chain.<br><br>This endpoint does not cost credits to execute.
      operationId: v1-supply-chain-get-supplier
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
          in: path
          name: supply_chain_id
          required: true
          schema:
            description: The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the [list supply chains endpoint](https://docs.censys.com/reference/v1-supply-chain-list-supply-chains#/) or from the Supplier Risk URL in the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
              - default
            type: string
        - description: The ID of a Censys supplier from the given supply chain.
          in: path
          name: supplier_id
          required: true
          schema:
            description: The ID of a Censys supplier from the given supply chain.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeGetSupplierPayload"
          description: Supplier information returned successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid arguments
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid inputs
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get supplier
      tags:
        - Supplier Risk
      x-speakeasy-ignore: true
      x-speakeasy-name-override: GetSupplier
  /v3/accounts/organizations/{organization_id}:
    get:
      description: Retrieve an organization's details, including the count of users broken down by [Platform-wide role](https://docs.censys.com/docs/role-based-access-control#platform-wide-roles) and organization settings such as AI training and MFA requirements. Set `include_modules` to true to include entitled modules, available roles, and seat capacity.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-org-details
      parameters:
        - description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          in: path
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: Whether to include the organization's entitled modules, available roles, and seat capacity.
          explode: false
          in: query
          name: include_modules
          schema:
            default: false
            description: Whether to include the organization's entitled modules, available roles, and seat capacity.
            type: boolean
        - description: Whether to include how many users are in this organization, split by Platform-wide role.
          explode: false
          in: query
          name: include_member_counts
          schema:
            default: false
            description: Whether to include how many users are in this organization, split by Platform-wide role.
            type: boolean
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeOrganizationDetails"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Organization not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid organization ID
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get organization details
      tags:
        - Account Management
      x-speakeasy-name-override: GetOrganizationDetails
  /v3/accounts/organizations/{organization_id}/audit-log-events:
    get:
      description: Retrieve audit log events for an organization. Use query parameters to filter events by time range, user, and event type.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-org-audit-log-events
      parameters:
        - description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          in: path
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: Amount of events to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 10
            description: Amount of events to return per page.
            examples:
              - 1
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Page token for the requested page of audit log events.
          explode: false
          in: query
          name: page_token
          schema:
            description: Page token for the requested page of audit log events.
            type: string
        - description: Only return events that occurred after this time. This value must be on or after 2026-01-01T00:00:00Z. If not provided, will default to the earliest possible date.
          explode: false
          in: query
          name: start_time
          schema:
            description: Only return events that occurred after this time. This value must be on or after 2026-01-01T00:00:00Z. If not provided, will default to the earliest possible date.
            examples:
              - "2026-01-01T00:00:00Z"
            format: date-time
            type: string
        - description: Only return events that occurred before this time. This value must not be in the future. If not provided, it defaults to the current time.
          explode: false
          in: query
          name: end_time
          schema:
            description: Only return events that occurred before this time. This value must not be in the future. If not provided, it defaults to the current time.
            examples:
              - "2026-02-01T00:00:00Z"
            format: date-time
            type: string
        - description: Only return events of this type. This field is deprecated and will be removed in a future version. Use event_types instead.
          explode: false
          in: query
          name: event_type
          schema:
            deprecated: true
            description: Only return events of this type. This field is deprecated and will be removed in a future version. Use event_types instead.
            enum:
              - user_created
              - user_login
              - user_login_failed
              - user_password_changed
              - user_password_reset
              - user_mfa_changed
              - user_settings_changed
              - user_enabled
              - user_disabled
              - invitation_created
              - invitation_resent
              - invitation_accepted
              - invitation_deleted
              - membership_created
              - membership_updated
              - membership_removed
              - org_created
              - org_updated
              - org_deleted
              - saml_config_created
              - saml_config_updated
              - saml_config_deleted
              - saml_config_domain_verified
              - pat_created
              - pat_deleted
              - global_data_search_executed
              - global_data_lookup_executed
              - global_data_aggregation_executed
              - asm_seed_created
              - asm_seed_deleted
              - asm_exclude_created
              - asm_exclude_deleted
              - asm_risk_instance_severity_changed
              - asm_risk_instance_accepted
              - asm_risk_instance_unaccepted
              - asm_risk_type_severity_changed
              - asm_risk_type_enabled
              - asm_risk_type_disabled
              - asm_risk_type_default_enabled
              - tag_created
              - tag_updated
              - tag_deleted
              - tag_assigned
              - tag_unassigned
              - tag_bulk_operation_started
              - tag_bulk_operation_completed
              - tag_bulk_operation_cancelled
              - comment_created
              - comment_updated
              - comment_deleted
              - scim_token_generated
              - scim_token_revoked
              - scim_user_provisioned
              - scim_user_updated
              - scim_user_deprovisioned
              - module_assignment_granted
              - module_assignment_revoked
              - module_assignment_updated
              - service_account_created
              - service_account_secret_rotated
              - service_account_deleted
              - service_account_updated
            type: string
        - description: Only return events of these types.
          explode: false
          in: query
          name: event_types
          schema:
            description: Only return events of these types.
            examples:
              - - user_login
                - pat_created
            items:
              enum:
                - user_created
                - user_login
                - user_login_failed
                - user_password_changed
                - user_password_reset
                - user_mfa_changed
                - user_settings_changed
                - user_enabled
                - user_disabled
                - invitation_created
                - invitation_resent
                - invitation_accepted
                - invitation_deleted
                - membership_created
                - membership_updated
                - membership_removed
                - org_created
                - org_updated
                - org_deleted
                - saml_config_created
                - saml_config_updated
                - saml_config_deleted
                - saml_config_domain_verified
                - pat_created
                - pat_deleted
                - global_data_search_executed
                - global_data_lookup_executed
                - global_data_aggregation_executed
                - asm_seed_created
                - asm_seed_deleted
                - asm_exclude_created
                - asm_exclude_deleted
                - asm_risk_instance_severity_changed
                - asm_risk_instance_accepted
                - asm_risk_instance_unaccepted
                - asm_risk_type_severity_changed
                - asm_risk_type_enabled
                - asm_risk_type_disabled
                - asm_risk_type_default_enabled
                - tag_created
                - tag_updated
                - tag_deleted
                - tag_assigned
                - tag_unassigned
                - tag_bulk_operation_started
                - tag_bulk_operation_completed
                - tag_bulk_operation_cancelled
                - comment_created
                - comment_updated
                - comment_deleted
                - scim_token_generated
                - scim_token_revoked
                - scim_user_provisioned
                - scim_user_updated
                - scim_user_deprovisioned
                - module_assignment_granted
                - module_assignment_revoked
                - module_assignment_updated
                - service_account_created
                - service_account_secret_rotated
                - service_account_deleted
                - service_account_updated
              type: string
            maxItems: 10
            type:
              - array
              - "null"
        - description: Exclude events of these types.
          explode: false
          in: query
          name: exclude_event_types
          schema:
            description: Exclude events of these types.
            examples:
              - - user_login
                - pat_created
            items:
              enum:
                - user_created
                - user_login
                - user_login_failed
                - user_password_changed
                - user_password_reset
                - user_mfa_changed
                - user_settings_changed
                - user_enabled
                - user_disabled
                - invitation_created
                - invitation_resent
                - invitation_accepted
                - invitation_deleted
                - membership_created
                - membership_updated
                - membership_removed
                - org_created
                - org_updated
                - org_deleted
                - saml_config_created
                - saml_config_updated
                - saml_config_deleted
                - saml_config_domain_verified
                - pat_created
                - pat_deleted
                - global_data_search_executed
                - global_data_lookup_executed
                - global_data_aggregation_executed
                - asm_seed_created
                - asm_seed_deleted
                - asm_exclude_created
                - asm_exclude_deleted
                - asm_risk_instance_severity_changed
                - asm_risk_instance_accepted
                - asm_risk_instance_unaccepted
                - asm_risk_type_severity_changed
                - asm_risk_type_enabled
                - asm_risk_type_disabled
                - asm_risk_type_default_enabled
                - tag_created
                - tag_updated
                - tag_deleted
                - tag_assigned
                - tag_unassigned
                - tag_bulk_operation_started
                - tag_bulk_operation_completed
                - tag_bulk_operation_cancelled
                - comment_created
                - comment_updated
                - comment_deleted
                - scim_token_generated
                - scim_token_revoked
                - scim_user_provisioned
                - scim_user_updated
                - scim_user_deprovisioned
                - module_assignment_granted
                - module_assignment_revoked
                - module_assignment_updated
                - service_account_created
                - service_account_secret_rotated
                - service_account_deleted
                - service_account_updated
              type: string
            maxItems: 10
            type:
              - array
              - "null"
        - description: Only return events performed by this user.
          explode: false
          in: query
          name: user_email
          schema:
            description: Only return events performed by this user.
            examples:
              - user@example.com
            type: string
        - description: Order events by this field.
          explode: false
          in: query
          name: order_by
          schema:
            default: timestamp_desc
            description: Order events by this field.
            enum:
              - timestamp_desc
              - timestamp_asc
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeAuditLogEventsResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid request parameters
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List audit log events
      tags:
        - Account Management
      x-speakeasy-ignore: true
      x-speakeasy-name-override: GetOrganizationAuditLogEvents
  /v3/accounts/organizations/{organization_id}/credits:
    get:
      description: Retrieve credit balance and expiration information for an organization. <br><br>Credits expire 12 months after they are acquired.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-org-credits
      parameters:
        - description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          in: path
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeOrganizationCredits"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Organization not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid organization ID
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get organization credit balance
      tags:
        - Account Management
      x-speakeasy-name-override: GetOrganizationCredits
  /v3/accounts/organizations/{organization_id}/credits/usage:
    get:
      description: Retrieve credit information for an organization over a specific date range. You must include a start date in your request.<br><br>Users with the Platform Admin role can obtain credit usage information for all users in their organization. Other users may only retrieve usage information for their own account.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-org-credits-usage
      parameters:
        - description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          in: path
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: The date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-06). This field is deprecated and will be removed in a future version. Use start_date and end_date instead. The date must be on or after 2025-01-01 (the earliest date available for credit usage reports).
          explode: false
          in: query
          name: date
          schema:
            deprecated: true
            description: The date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-06). This field is deprecated and will be removed in a future version. Use start_date and end_date instead. The date must be on or after 2025-01-01 (the earliest date available for credit usage reports).
            examples:
              - "2025-11-01"
            type: string
        - description: The start date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-01). Must be on or after 2025-01-01 (the earliest date available for credit usage reports).
          explode: false
          in: query
          name: start_date
          schema:
            description: The start date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-01). Must be on or after 2025-01-01 (the earliest date available for credit usage reports).
            examples:
              - "2025-11-01"
            format: date
            type: string
        - description: The end date for the credit usage report in YYYY-MM-DD format (e.g., 2025-12-01). If omitted, will default to today's date. The date range (end_date - start_date) cannot exceed 365 days (1 year).
          explode: false
          in: query
          name: end_date
          schema:
            description: The end date for the credit usage report in YYYY-MM-DD format (e.g., 2025-12-01). If omitted, will default to today's date. The date range (end_date - start_date) cannot exceed 365 days (1 year).
            examples:
              - "2025-12-01"
            format: date
            type: string
        - description: Whether to break down credit usage on a daily or monthly basis.
          explode: false
          in: query
          name: granularity
          required: true
          schema:
            default: daily
            description: Whether to break down credit usage on a daily or monthly basis.
            enum:
              - daily
              - monthly
            examples:
              - daily
            type: string
        - description: Whether to include a breakdown of individual users' consumption in the credit usage report.
          explode: false
          in: query
          name: include_consumer_breakdown
          schema:
            default: false
            description: Whether to include a breakdown of individual users' consumption in the credit usage report.
            type: boolean
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCreditUsageReport"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid date format
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Organization not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid organization ID or date
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get organization credit usage
      tags:
        - Account Management
      x-speakeasy-name-override: GetOrganizationCreditUsage
  /v3/accounts/organizations/{organization_id}/invitations:
    post:
      description: Invite a user to an organization. The user will receive an email to join the organization. This is equivalent to [adding a new user via the UI](https://docs.censys.com/docs/platform-org-management#invite-members).<br><br>Only users with the Platform Admin role in the provided organization can perform this operation.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-invite-user-to-org
      parameters:
        - description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          in: path
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/InviteMemberInputBody"
        required: true
      responses:
        "201":
          description: Invitation sent successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission or organization has reached maximum seat capacity
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Organization not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User is already in this organization or an invitation already exists
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid email address
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Invite user to organization
      tags:
        - Account Management
      x-speakeasy-name-override: InviteUserToOrganization
  /v3/accounts/organizations/{organization_id}/members:
    get:
      description: Retrieve a paginated list of an organization's users and their details, including their user ID, email, name, creation time, [Platform-wide roles](https://docs.censys.com/docs/role-based-access-control#platform-wide-roles), and [module roles](https://docs.censys.com/docs/role-based-access-control#module-roles).<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-list-org-members
      parameters:
        - description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          in: path
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: Number of users to return per page
          explode: false
          in: query
          name: page_size
          schema:
            default: 10
            description: Number of users to return per page
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token for retrieving the next page of results
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token for retrieving the next page of results
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeOrganizationMembersList"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Organization not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List organization users
      tags:
        - Account Management
      x-speakeasy-name-override: ListOrganizationMembers
  /v3/accounts/organizations/{organization_id}/members/{user_id}:
    delete:
      description: Remove a user from an organization. This is equivalent to [removing a user via the UI](https://docs.censys.com/docs/platform-org-management#remove-members).<br><br>Only users with the Platform Admin role in the provided organization can perform this operation.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-remove-org-member
      parameters:
        - description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          in: path
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: The ID of a Censys user. You can obtain a user's ID by listing users in an organization.
          in: path
          name: user_id
          required: true
          schema:
            description: The ID of a Censys user. You can obtain a user's ID by listing users in an organization.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
      responses:
        "204":
          description: User removed successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Organization not found or user not found in the organization
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Cannot remove the last user with the Platform Admin role from the organization
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid organization ID or user ID
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Remove user from organization
      tags:
        - Account Management
      x-speakeasy-name-override: RemoveOrganizationMember
    patch:
      description: Update the [Platform-wide roles](https://docs.censys.com/docs/role-based-access-control#platform-wide-roles) assigned to a user in an organization. This operation replaces a user's Platform-wide roles with the list provided in the request body. To remove all assigned Platform-wide roles from a user, provide an empty list. To completely remove a user from an organization, use the [remove user endpoint](https://docs.censys.com/reference/v3-accountmanagement-remove-org-member).<br><br>Only users with the Platform Admin role in the provided organization can perform this operation.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-update-org-member
      parameters:
        - description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          in: path
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: The ID of a Censys user. You can obtain a user's ID by listing users in an organization.
          in: path
          name: user_id
          required: true
          schema:
            description: The ID of a Censys user. You can obtain a user's ID by listing users in an organization.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/UpdateMemberRoleInputBody"
        required: true
      responses:
        "204":
          description: User's Platform-wide roles updated successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid role identifiers or user/organization ID
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Organization not found or user not found in the organization
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid organization ID or user ID
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Update a user's Platform-wide roles in an organization
      tags:
        - Account Management
      x-speakeasy-name-override: UpdateOrganizationMember
  /v3/accounts/organizations/{organization_id}/members/{user_id}/credits/usage:
    get:
      description: Retrieve credit consumption information for a user in an organization over a specific date range. You must include a start date in your request.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-member-credits-usage
      parameters:
        - description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          in: path
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: The ID of a Censys user. You can obtain a user's ID by listing users in an organization.
          in: path
          name: user_id
          required: true
          schema:
            description: The ID of a Censys user. You can obtain a user's ID by listing users in an organization.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: The date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-06). This field is deprecated and will be removed in a future version. Use start_date and end_date instead. The date must be on or after 2025-01-01 (the earliest date available for credit usage reports).
          explode: false
          in: query
          name: date
          schema:
            deprecated: true
            description: The date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-06). This field is deprecated and will be removed in a future version. Use start_date and end_date instead. The date must be on or after 2025-01-01 (the earliest date available for credit usage reports).
            examples:
              - "2025-11-01"
            type: string
        - description: The start date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-01). Must be on or after 2025-01-01 (the earliest date available for credit usage reports).
          explode: false
          in: query
          name: start_date
          schema:
            description: The start date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-01). Must be on or after 2025-01-01 (the earliest date available for credit usage reports).
            examples:
              - "2025-11-01"
            format: date
            type: string
        - description: The end date for the credit usage report in YYYY-MM-DD format (e.g., 2025-12-01). If omitted, will default to today's date. The date range (end_date - start_date) cannot exceed 365 days (1 year).
          explode: false
          in: query
          name: end_date
          schema:
            description: The end date for the credit usage report in YYYY-MM-DD format (e.g., 2025-12-01). If omitted, will default to today's date. The date range (end_date - start_date) cannot exceed 365 days (1 year).
            examples:
              - "2025-12-01"
            format: date
            type: string
        - description: Whether to break down credit usage on a daily or monthly basis.
          explode: false
          in: query
          name: granularity
          required: true
          schema:
            default: daily
            description: Whether to break down credit usage on a daily or monthly basis.
            enum:
              - daily
              - monthly
            examples:
              - daily
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCreditUsageReport"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid date format
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Organization not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid user ID or organization ID
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get organization user credit usage
      tags:
        - Account Management
      x-speakeasy-name-override: GetMemberCreditUsage
  /v3/accounts/organizations/{organization_id}/members/{user_id}/modules/{module}:
    delete:
      description: Remove a user's access to the specified module. Only users with the Platform Admin role in the organization can perform this operation. This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-remove-member-module
      parameters:
        - description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          in: path
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: The ID of a Censys user. You can obtain a user's ID by listing users in an organization.
          in: path
          name: user_id
          required: true
          schema:
            description: The ID of a Censys user. You can obtain a user's ID by listing users in an organization.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: The module identifier, for example platform-search.
          in: path
          name: module
          required: true
          schema:
            description: The module identifier, for example platform-search.
            type: string
      responses:
        "204":
          description: User's module access removed successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Module or organization not found, or user not found in the organization
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Remove a user's module access
      tags:
        - Account Management
      x-speakeasy-name-override: RemoveOrganizationMemberModule
    put:
      description: Assign a [module role](https://docs.censys.com/docs/role-based-access-control#module-roles) to a user in an organization or replace their existing role in that module. Only users with the Platform Admin role in the organization can perform this operation. This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-set-member-module-role
      parameters:
        - description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          in: path
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: The ID of a Censys user. You can obtain a user's ID by listing users in an organization.
          in: path
          name: user_id
          required: true
          schema:
            description: The ID of a Censys user. You can obtain a user's ID by listing users in an organization.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: The module identifier, for example platform-search.
          in: path
          name: module
          required: true
          schema:
            description: The module identifier, for example platform-search.
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SetMemberModuleRoleInputBody"
        required: true
      responses:
        "204":
          description: User's module role set successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Request body is required
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Module unavailable to the organization, organization not found, or user not found in the organization
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled, module seat limit reached, or module assignment conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Set a user's module role
      tags:
        - Account Management
      x-speakeasy-name-override: SetOrganizationMemberModuleRole
  /v3/accounts/users/credits:
    get:
      description: Retrieve your Free user account credit balance and refresh information. To retrieve the credit balance for a Starter or Enterprise account, use the [get organization credit balance endpoint](https://docs.censys.com/reference/v3-accountmanagement-org-credits).<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-user-credits
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeUserCredits"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User not found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get Free user credit balance
      tags:
        - Account Management
      x-speakeasy-name-override: GetUserCredits
  /v3/accounts/users/credits/usage:
    get:
      description: Retrieve your Free user account credit consumption information over a specific date range. You must include a start date in your request.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-accountmanagement-user-credits-usage
      parameters:
        - description: The date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-06). This field is deprecated and will be removed in a future version. Use start_date and end_date instead. The date must be on or after 2025-01-01 (the earliest date available for credit usage reports).
          explode: false
          in: query
          name: date
          schema:
            deprecated: true
            description: The date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-06). This field is deprecated and will be removed in a future version. Use start_date and end_date instead. The date must be on or after 2025-01-01 (the earliest date available for credit usage reports).
            examples:
              - "2025-11-01"
            type: string
        - description: The start date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-01). Must be on or after 2025-01-01 (the earliest date available for credit usage reports).
          explode: false
          in: query
          name: start_date
          schema:
            description: The start date for the credit usage report in YYYY-MM-DD format (e.g., 2025-11-01). Must be on or after 2025-01-01 (the earliest date available for credit usage reports).
            examples:
              - "2025-11-01"
            format: date
            type: string
        - description: The end date for the credit usage report in YYYY-MM-DD format (e.g., 2025-12-01). If omitted, will default to today's date. The date range (end_date - start_date) cannot exceed 365 days (1 year).
          explode: false
          in: query
          name: end_date
          schema:
            description: The end date for the credit usage report in YYYY-MM-DD format (e.g., 2025-12-01). If omitted, will default to today's date. The date range (end_date - start_date) cannot exceed 365 days (1 year).
            examples:
              - "2025-12-01"
            format: date
            type: string
        - description: Whether to break down credit usage on a daily or monthly basis.
          explode: false
          in: query
          name: granularity
          required: true
          schema:
            default: daily
            description: Whether to break down credit usage on a daily or monthly basis.
            enum:
              - daily
              - monthly
            examples:
              - daily
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCreditUsageReport"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User not found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get Free user credit usage
      tags:
        - Account Management
      x-speakeasy-name-override: GetUserCreditsUsage
  /v3/collections:
    get:
      description: List all collections for an organization. Retrieved information includes collection ID, name, query, description, status, and asset count.<br><br>This endpoint does not cost credits to execute.
      operationId: v3-collections-crud-list
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: page token for the requested page of collection results
          explode: false
          in: query
          name: page_token
          schema:
            description: page token for the requested page of collection results
            type: string
        - description: amount of results to return per page
          explode: false
          in: query
          name: page_size
          schema:
            description: amount of results to return per page
            examples:
              - 1
            format: int64
            minimum: 0
            type: integer
        - description: statuses of collection for results to be filtered on.
          explode: false
          in: query
          name: collection_statuses
          schema:
            description: statuses of collection for results to be filtered on.
            examples:
              - - populating
                - active
            items:
              enum:
                - populating
                - active
                - paused
                - archived
              type: string
            maxItems: 4
            type:
              - array
              - "null"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListCollectionsResponseV1"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List collections
      tags:
        - Collections
      x-speakeasy-name-override: List
    post:
      description: Create a new [collection](https://docs.censys.com/docs/platform-collections).<br><br>In a SOC environment, use this endpoint to save a query as a dynamic asset group, such as all internet-facing RDP hosts or a threat's footprint, so SOC monitoring and reporting stay scoped as assets change.<br><br>This endpoint does not cost credits to execute.
      operationId: v3-collections-crud-create
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CrudCreateInputBody"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCollection"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "412":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Collection limit exceeded
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Create a collection
      tags:
        - Collections
      x-speakeasy-name-override: Create
  /v3/collections/{collection_uid}:
    delete:
      description: Delete a collection.<br><br>This endpoint does not cost credits to execute.
      operationId: v3-collections-crud-delete
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The UID for the collection. Obtain the collection ID using the [list collections endpoint](https://docs.censys.com/reference/v3-collections-crud-list#/) or via the collection URL when using the web console.
          in: path
          name: collection_uid
          required: true
          schema:
            description: The UID for the collection. Obtain the collection ID using the [list collections endpoint](https://docs.censys.com/reference/v3-collections-crud-list#/) or via the collection URL when using the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
      responses:
        "204":
          description: Empty response body when the deletion is successful
          headers:
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No collection found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Delete a collection
      tags:
        - Collections
      x-speakeasy-name-override: Delete
    get:
      description: Retrieve information about a collection. Retrieved information includes its name, query, description, status, and asset count. Use it to confirm it still reflects the scope you intend to monitor.<br><br>This endpoint does not cost credits to execute.
      operationId: v3-collections-crud-get
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The UID for the collection. Obtain the collection ID using the [list collections endpoint](https://docs.censys.com/reference/v3-collections-crud-list#/) or via the collection URL when using the web console.
          in: path
          name: collection_uid
          required: true
          schema:
            description: The UID for the collection. Obtain the collection ID using the [list collections endpoint](https://docs.censys.com/reference/v3-collections-crud-list#/) or via the collection URL when using the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCollection"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No collection found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get a collection
      tags:
        - Collections
      x-speakeasy-name-override: Get
    put:
      description: Update a collection's name, description, query, and/or privacy.<br><br>This endpoint does not cost credits to execute.
      operationId: v3-collections-crud-update
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The UID for the collection
          in: path
          name: collection_uid
          required: true
          schema:
            description: The UID for the collection
            examples:
              - 11111111-2222-3333-4444-555555555555
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CrudUpdateInputBody"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCollection"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No collection found
        "412":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Collection is paused or archived
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Update a collection
      tags:
        - Collections
      x-speakeasy-name-override: Update
  /v3/collections/{collection_uid}/events:
    get:
      description: Retrieve the event history for a collection. This includes the addition or removal of assets as well as collection status changes.<br><br>In a SOC environment, use this endpoint to see which assets were added or removed and when, to catch new exposure or unexpected changes in a monitored scope.<br><br>This endpoint does not cost credits to execute.
      operationId: v3-collections-list-events
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The UID for the collection. Obtain the collection ID using the [list collections endpoint](https://docs.censys.com/reference/v3-collections-crud-list#/) or via the collection URL when using the web console.
          in: path
          name: collection_uid
          required: true
          schema:
            description: The UID for the collection. Obtain the collection ID using the [list collections endpoint](https://docs.censys.com/reference/v3-collections-crud-list#/) or via the collection URL when using the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: Amount of results to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            description: Amount of results to return per page.
            examples:
              - 1
            format: int32
            minimum: 0
            type: integer
        - description: Page token for the requested page of collection results.
          explode: false
          in: query
          name: page_token
          schema:
            description: Page token for the requested page of collection results.
            type: string
        - description: Change types
          explode: false
          in: query
          name: change_types
          schema:
            description: Change types
            items:
              enum:
                - asset
                - status
              type: string
            type:
              - array
              - "null"
        - description: Asset change types
          explode: false
          in: query
          name: asset_change_types
          schema:
            description: Asset change types
            items:
              enum:
                - added
                - removed
              type: string
            type:
              - array
              - "null"
        - description: Status change types
          explode: false
          in: query
          name: status_change_types
          schema:
            description: Status change types
            items:
              enum:
                - active
                - archived
                - paused
                - populating
              type: string
            type:
              - array
              - "null"
        - description: Start time of the host timeline
          explode: false
          in: query
          name: start_time
          schema:
            description: Start time of the host timeline
            examples:
              - "2025-01-01T00:00:00Z"
            format: date-time
            type: string
        - description: End time of the host timeline
          explode: false
          in: query
          name: end_time
          schema:
            description: End time of the host timeline
            examples:
              - "2025-01-02T00:00:00Z"
            format: date-time
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCollectionEventsResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No collection found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get a collection's events
      tags:
        - Collections
      x-speakeasy-name-override: ListEvents
  /v3/collections/{collection_uid}/search/aggregate:
    post:
      description: Aggregate results for a Platform search query that targets a collection's assets. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.<br><br>In a SOC environment, use this endpoint to count and bucket matches by field, such as port, country, or software, inside a collection so you can spot exposure trends without pulling every asset.
      operationId: v3-collections-search-aggregate
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The UID for the collection. Obtain the collection ID using the [list collections endpoint](https://docs.censys.com/reference/v3-collections-crud-list#/) or via the collection URL when using the web console.
          in: path
          name: collection_uid
          required: true
          schema:
            description: The UID for the collection. Obtain the collection ID using the [list collections endpoint](https://docs.censys.com/reference/v3-collections-crud-list#/) or via the collection URL when using the web console.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SearchAggregateInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeSearchAggregateResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No collection found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Aggregate results for a search query within a collection
      tags:
        - Collections
      x-speakeasy-name-override: Aggregate
  /v3/collections/{collection_uid}/search/query:
    post:
      description: Run a search query across a collection's assets. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax. Host services that match your search criteria will be returned in a `matched_services` object.<br><br>In a SOC environment, use this endpoint to search only within the defined scope of a collection, so triage and hunting results stay relevant instead of covering the whole internet.
      operationId: v3-collections-search-query
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The UID for the collection
          in: path
          name: collection_uid
          required: true
          schema:
            description: The UID for the collection
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SearchQueryInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeSearchQueryResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No collection found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Run a search query within a collection
      tags:
        - Collections
      x-speakeasy-name-override: Search
  /v3/comments:
    get:
      description: Retrieve a paginated list of comments in your organization. Use query parameters to filter by asset, creator, or creation time.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-comments-list-comments
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Number of comments to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of comments to return per page.
            format: int32
            maximum: 1000
            minimum: 1
            type: integer
        - description: Pagination token from a previous response to retrieve the next page of results.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results.
            type: string
        - description: "Sort order. Supported values: create_time_asc, create_time_desc."
          explode: false
          in: query
          name: order_by
          schema:
            default: create_time_desc
            description: "Sort order. Supported values: create_time_asc, create_time_desc."
            enum:
              - create_time_asc
              - create_time_desc
            type: string
        - description: Filter comments by asset identifier (host IP, certificate fingerprint, or web property hostname:port).
          explode: false
          in: query
          name: asset_id
          schema:
            description: Filter comments by asset identifier (host IP, certificate fingerprint, or web property hostname:port).
            type: string
        - description: Filter comments by the user ID of the user who created the comment.
          explode: false
          in: query
          name: created_by
          schema:
            description: Filter comments by the user ID of the user who created the comment.
            format: uuid
            type: string
        - description: Filter comments created before this RFC3339 timestamp.
          explode: false
          in: query
          name: created_before
          schema:
            description: Filter comments created before this RFC3339 timestamp.
            format: date-time
            type: string
        - description: Filter comments created after this RFC3339 timestamp.
          explode: false
          in: query
          name: created_after
          schema:
            description: Filter comments created after this RFC3339 timestamp.
            format: date-time
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCommentsList"
          description: Comments retrieved successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List comments
      tags:
        - Tags and Comments
      x-speakeasy-name-override: ListComments
    post:
      description: Add a comment on an asset in your organization.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-comments-create-comment
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateCommentInputBody"
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeComment"
          description: Comment created successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Create a comment
      tags:
        - Tags and Comments
      x-speakeasy-name-override: CreateComment
  /v3/comments/{comment_id}:
    delete:
      description: Delete a comment. Only the comment's creator or an organization admin can delete a comment. This action is permanent and cannot be undone.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-comments-delete-comment
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the comment to delete.
          in: path
          name: comment_id
          required: true
          schema:
            description: The ID of the comment to delete.
            format: uuid
            type: string
      responses:
        "204":
          description: Comment deleted successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Comment not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Delete a comment
      tags:
        - Tags and Comments
      x-speakeasy-name-override: DeleteComment
    put:
      description: Update the body of an existing comment. Only the comment's creator can update it.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-comments-update-comment
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the comment to update.
          in: path
          name: comment_id
          required: true
          schema:
            description: The ID of the comment to update.
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/UpdateCommentInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeComment"
          description: Comment updated successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Comment not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Update a comment
      tags:
        - Tags and Comments
      x-speakeasy-name-override: UpdateComment
  /v3/global/asset/certificate:
    get:
      deprecated: true
      description: Retrieve information about multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.<br><br>The GET method of this endpoint is deprecated, but will continue to be supported for backwards compatibility. Please use the [POST variant](https://docs.censys.com/reference/v3-globaldata-asset-certificate-list-post#/) of this endpoint instead.
      operationId: v3-globaldata-asset-certificate-list
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: A list of SHA-256 certificate fingerprints.
          explode: false
          in: query
          name: certificate_ids
          required: true
          schema:
            description: A list of SHA-256 certificate fingerprints.
            examples:
              - - 3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf
            items:
              type: string
            maxItems: 1000
            minItems: 1
            type:
              - array
              - "null"
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.certificate.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListCertificateAsset"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No certificates found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Retrieve multiple certificates
      tags:
        - Global Data
      x-speakeasy-ignore: true
    post:
      description: Retrieve information about multiple certificates. You can retrieve up to 1,000 certificates per call. A certificate ID is its SHA-256 fingerprint.<br><br>In a SOC environment, use this endpoint to bulk-check multiple certificates from network telemetry for self-signed, newly issued, or lookalike certs.
      operationId: v3-globaldata-asset-certificate-list-post
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/AssetCertificateListInputBody"
        required: true
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.certificate.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListCertificateAsset"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No certificates found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Retrieve multiple certificates
      tags:
        - Global Data
      x-speakeasy-name-override: GetCertificates
  /v3/global/asset/certificate/raw:
    get:
      deprecated: true
      description: Retrieve the raw PEM-encoded format for multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.<br><br>The GET method of this endpoint is deprecated, but will continue to be supported for backwards compatibility. Please use the [POST variant](https://docs.censys.com/reference/v3-globaldata-asset-certificate-list-raw-post#/) of this endpoint instead.
      operationId: v3-globaldata-asset-certificate-list-raw
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: A list of SHA-256 certificate fingerprints.
          explode: false
          in: query
          name: certificate_ids
          required: true
          schema:
            description: A list of SHA-256 certificate fingerprints.
            examples:
              - - 3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf
            items:
              type: string
            maxItems: 1000
            minItems: 1
            type:
              - array
              - "null"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListRawCertificateResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No certificates found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Retrieve multiple certificates in PEM format
      tags:
        - Global Data
      x-speakeasy-ignore: true
    post:
      description: Retrieve the raw PEM-encoded format for multiple certificates. You can retrieve up to 1,000 certificates per call. A certificate ID is its SHA-256 fingerprint.<br><br>Use this endpoint to export raw PEMs for multiple certificates at once, for bulk analysis or sharing with your detection pipeline.
      operationId: v3-globaldata-asset-certificate-list-raw-post
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/AssetCertificateListInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListRawCertificateResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No certificates found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Retrieve multiple certificates in PEM format
      tags:
        - Global Data
      x-speakeasy-name-override: GetCertificatesRaw
  /v3/global/asset/certificate/{certificate_id}:
    get:
      description: Retrieve information about a single certificate. A certificate ID is its SHA-256 fingerprint.<br><br>In a SOC environment, use this endpoint to look up a certificate by SHA-256 fingerprint to see its subject, issuer, and validity, so you can vet certs seen in TLS logs or alerts.
      operationId: v3-globaldata-asset-certificate
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The SHA-256 certificate fingerprint.
          in: path
          name: certificate_id
          required: true
          schema:
            description: The SHA-256 certificate fingerprint.
            examples:
              - 3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf
            type: string
        - description: Comma-separated list of fields to include in the response, in dot notation (for example `services.port`). Repeated fields are filtered per element. Omit the parameter or pass `*` to return every field. Unknown fields are rejected.
          explode: false
          in: query
          name: fields
          schema:
            description: Comma-separated list of fields to include in the response, in dot notation (for example `services.port`). Repeated fields are filtered per element. Omit the parameter or pass `*` to return every field. Unknown fields are rejected.
            examples:
              - fingerprint_sha256,parsed.subject_dn
            maxLength: 8192
            type: string
        - description: Comma-separated list of fields to exclude from the response, in dot notation (for example `services.banner`). Repeated fields are filtered per element. Unknown fields are rejected. Cannot be used together with `fields`.
          explode: false
          in: query
          name: exclude_fields
          schema:
            description: Comma-separated list of fields to exclude from the response, in dot notation (for example `services.banner`). Repeated fields are filtered per element. Unknown fields are rejected. Cannot be used together with `fields`.
            examples:
              - names,fingerprint_sha1
            maxLength: 8192
            type: string
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.certificate.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCertificateAsset"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No certificate found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get a certificate
      tags:
        - Global Data
      x-speakeasy-name-override: GetCertificate
  /v3/global/asset/certificate/{certificate_id}/raw:
    get:
      description: Retrieve the raw PEM-encoded format of a certificate. A certificate ID is its SHA-256 fingerprint.<br><br>Use this endpoint to retrieve the raw PEM of a suspicious certificate for offline analysis or to feed other tooling.
      operationId: v3-globaldata-asset-certificate-raw
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The SHA-256 certificate fingerprint.
          in: path
          name: certificate_id
          required: true
          schema:
            description: The SHA-256 certificate fingerprint.
            examples:
              - 3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf
            type: string
      responses:
        "200":
          content:
            application/x-pem-file:
              schema:
                contentMediaType: application/octet-stream
                format: binary
                type: string
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No certificate found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get a certificate in PEM format
      tags:
        - Global Data
      x-speakeasy-name-override: GetCertificateRaw
  /v3/global/asset/enrichment/host/{host_ip}:
    get:
      description: Retrieve enrichment data for a single host. This endpoint is optimized for high-volume SOC enrichment use cases.<br><br>Use this endpoint to add Censys context (location, ASN, labels, reputation, and more) to IPs in your SIEM or SOAR at high volume, without spending standard credits.<br><br>This endpoint does not consume standard Censys credits. Core organizations may perform up to 20,000 enrichment calls per day. Core + Unlimited Enrichment organizations may perform an unlimited amount of enrichment calls per day.<br><br>[Learn more about the enrichment API here](https://docs.censys.com/docs/host-enrichment).
      operationId: v3-globaldata-asset-host-enrichment
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The IP address of a host.
          in: path
          name: host_ip
          required: true
          schema:
            description: The IP address of a host.
            examples:
              - 8.8.8.8
            format: ip
            type: string
        - description: Comma-separated list of fields to include in the response, in dot notation (for example `services.port`). Repeated fields are filtered per element. Omit the parameter or pass `*` to return every field. Unknown fields are rejected.
          explode: false
          in: query
          name: fields
          schema:
            description: Comma-separated list of fields to include in the response, in dot notation (for example `services.port`). Repeated fields are filtered per element. Omit the parameter or pass `*` to return every field. Unknown fields are rejected.
            examples:
              - ip,greynoise.classification,third_party.mallory
            maxLength: 8192
            type: string
        - description: Comma-separated list of fields to exclude from the response, in dot notation (for example `services.banner`). Repeated fields are filtered per element. Unknown fields are rejected. Cannot be used together with `fields`.
          explode: false
          in: query
          name: exclude_fields
          schema:
            description: Comma-separated list of fields to exclude from the response, in dot notation (for example `services.banner`). Repeated fields are filtered per element. Unknown fields are rejected. Cannot be used together with `fields`.
            examples:
              - whois,services
            maxLength: 8192
            type: string
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.host-enrichment.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeHostEnrichmentAsset"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            RateLimit-Limit:
              description: Request quota for the current window, with the quota-policy window in seconds (e.g. 20000, 20000;w=86400).
              schema:
                type: string
            RateLimit-Remaining:
              description: Requests remaining in the current window.
              schema:
                type: string
            RateLimit-Reset:
              description: Seconds until the quota resets.
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "429":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Daily request limit reached
          headers:
            RateLimit-Limit:
              description: Request quota for the current window, with the quota-policy window in seconds (e.g. 20000, 20000;w=86400).
              schema:
                type: string
            RateLimit-Remaining:
              description: Requests remaining in the current window.
              schema:
                type: string
            RateLimit-Reset:
              description: Seconds until the quota resets.
              schema:
                type: string
            Retry-After:
              description: Seconds until the quota resets.
              schema:
                type: string
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get host enrichment
      tags:
        - Global Data
      x-speakeasy-name-override: GetHostEnrichment
  /v3/global/asset/host:
    get:
      deprecated: true
      description: Retrieve information about multiple hosts. A host ID is its IP address.<br><br>The GET method of this endpoint is deprecated, but will continue to be supported for backwards compatibility. Please use the [POST variant](https://docs.censys.com/reference/v3-globaldata-asset-host-list-post#/) of this endpoint instead.
      operationId: v3-globaldata-asset-host-list
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: A list of host IP addresses.
          explode: false
          in: query
          name: host_ids
          required: true
          schema:
            description: A list of host IP addresses.
            examples:
              - - 8.8.8.8
            items:
              type: string
            maxItems: 100
            minItems: 1
            type:
              - array
              - "null"
        - description: RFC3339 Timestamp to view all requested hosts 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.
          explode: false
          in: query
          name: at_time
          schema:
            description: RFC3339 Timestamp to view all requested hosts 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.
            examples:
              - "2025-01-01T00:00:00Z"
            format: date-time
            type: string
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.host.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListHostAsset"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Retrieve multiple hosts
      tags:
        - Global Data
      x-speakeasy-ignore: true
    post:
      description: Retrieve information about multiple hosts. You can retrieve up to 100 hosts per call. A host ID is its IP address.<br><br>In a SOC environment, use this endpoint to look up multiple IPs from an alert, log, or threat feed in one call, so you can triage a whole indicator list quickly.
      operationId: v3-globaldata-asset-host-list-post
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/AssetHostListInputBody"
        required: true
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.host.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListHostAsset"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Retrieve multiple hosts
      tags:
        - Global Data
      x-speakeasy-name-override: GetHosts
  /v3/global/asset/host/{host_id}:
    get:
      description: Retrieve information about a single host. A host ID is its IP address.<br><br>In a SOC environment, use this endpoint to pull the current services, software, certificates, and labels on an IP from an alert, so you can quickly judge whether it is malicious or benign.
      operationId: v3-globaldata-asset-host
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The IP address of a host.
          in: path
          name: host_id
          required: true
          schema:
            description: The IP address of a host.
            examples:
              - 8.8.8.8
            format: ip
            type: string
        - description: 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.
          explode: false
          in: query
          name: at_time
          schema:
            description: 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.
            examples:
              - "2025-01-01T00:00:00Z"
            format: date-time
            type: string
        - description: Comma-separated list of fields to include in the response, in dot notation (for example `services.port`). Repeated fields are filtered per element. Omit the parameter or pass `*` to return every field. Unknown fields are rejected.
          explode: false
          in: query
          name: fields
          schema:
            description: Comma-separated list of fields to include in the response, in dot notation (for example `services.port`). Repeated fields are filtered per element. Omit the parameter or pass `*` to return every field. Unknown fields are rejected.
            examples:
              - ip,services.port,services.protocol
            maxLength: 8192
            type: string
        - description: Comma-separated list of fields to exclude from the response, in dot notation (for example `services.banner`). Repeated fields are filtered per element. Unknown fields are rejected. Cannot be used together with `fields`.
          explode: false
          in: query
          name: exclude_fields
          schema:
            description: Comma-separated list of fields to exclude from the response, in dot notation (for example `services.banner`). Repeated fields are filtered per element. Unknown fields are rejected. Cannot be used together with `fields`.
            examples:
              - services.banner,services.cert
            maxLength: 8192
            type: string
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.host.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeHostAsset"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No host found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get a host
      tags:
        - Global Data
      x-speakeasy-name-override: GetHost
  /v3/global/asset/host/{host_id}/observations/services:
    get:
      description: Retrieve historical service observations for a host. This endpoint returns time ranges during which services were detected on the host.<br><br>You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.<br><br>You can filter by port number, protocol, and transport protocol.<br><br>In a SOC environment, use this endpoint to see when a specific service was exposed on an IP, so you can check whether it was live during the window of a suspected incident.
      operationId: v3-globaldata-service-on-host
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
          explode: false
          in: query
          name: start_time
          schema:
            description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
            examples:
              - "2024-01-01T00:00:00Z"
            type: string
        - description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
          explode: false
          in: query
          name: end_time
          schema:
            description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
            examples:
              - "2024-01-31T23:59:59Z"
            type: string
        - description: Number of results per page (max 100)
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of results per page (max 100)
            examples:
              - 50
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from previous response
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from previous response
            type: string
        - description: Filter by port number
          explode: false
          in: query
          name: port
          schema:
            description: Filter by port number
            examples:
              - 443
            format: int32
            type: integer
        - description: Filter by application protocol
          explode: false
          in: query
          name: protocol
          schema:
            description: Filter by application protocol
            examples:
              - HTTP
            type: string
        - description: Filter by transport protocol
          explode: false
          in: query
          name: transport_protocol
          schema:
            description: Filter by transport protocol
            enum:
              - tcp
              - udp
              - quic
            examples:
              - tcp
            type: string
        - description: The IP address of a host.
          in: path
          name: host_id
          required: true
          schema:
            description: The IP address of a host.
            examples:
              - 8.8.8.8
            format: ip
            type: string
        - description: Order observations by these fields. Multiple values can be provided to sort by multiple fields (e.g., ['port DESC', 'protocol ASC']).
          explode: false
          in: query
          name: order_by
          schema:
            description: Order observations by these fields. Multiple values can be provided to sort by multiple fields (e.g., ['port DESC', 'protocol ASC']).
            items:
              enum:
                - port ASC
                - port DESC
                - protocol ASC
                - protocol DESC
                - transport_protocol ASC
                - transport_protocol DESC
              type: string
            type:
              - array
              - "null"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeServicesOnHostResponse"
          description: A list of service observation ranges
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get service history for a host
      tags:
        - Global Data
      x-speakeasy-name-override: ListServicesOnHost
  /v3/global/asset/host/{host_id}/timeline:
    get:
      description: Retrieve event history for a host. A host ID is its IP address.<br><br>Note that when a service protocol changes after a new scan (for example, from `UNKNOWN` to `NETBIOS`), this information will be reflected in the `scan` object.<br><br>In a SOC environment, use this endpoint to see what changed on an IP over time, such as new services, certificate swaps, and software changes, to reconstruct when attacker infrastructure was stood up or modified.
      operationId: v3-globaldata-asset-host-timeline
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The IP address of a host.
          in: path
          name: host_id
          required: true
          schema:
            description: The IP address of a host.
            examples:
              - 8.8.8.8
            type: string
        - description: Start time of the host timeline. Equivalent to the To field in the event history UI. This must be the timestamp closest to the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 2 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
          explode: false
          in: query
          name: start_time
          required: true
          schema:
            description: Start time of the host timeline. Equivalent to the To field in the event history UI. This must be the timestamp closest to the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 2 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
            examples:
              - "2025-01-02T00:00:00Z"
            format: date-time
            type: string
        - description: End time of the host timeline. Equivalent to the From field in the event history UI. This must be the timestamp furthest from the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 1 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
          explode: false
          in: query
          name: end_time
          required: true
          schema:
            description: End time of the host timeline. Equivalent to the From field in the event history UI. This must be the timestamp furthest from the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 1 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
            examples:
              - "2025-01-01T00:00:00Z"
            format: date-time
            type: string
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.host_timeline_event.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeHostTimeline"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get host event history
      tags:
        - Global Data
      x-speakeasy-name-override: GetHostTimeline
  /v3/global/asset/webproperty:
    get:
      deprecated: true
      description: Retrieve information about multiple web properties. Web properties are identified using a combination of a hostname and port joined with a colon, such as `platform.censys.io:80`.<br><br>The GET method of this endpoint is deprecated, but will continue to be supported for backwards compatibility. Please use the [POST variant](https://docs.censys.com/reference/v3-globaldata-asset-webproperty-list-post#/) of this endpoint instead.
      operationId: v3-globaldata-asset-webproperty-list
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: A list of web property identifiers.
          explode: false
          in: query
          name: webproperty_ids
          required: true
          schema:
            description: A list of web property identifiers.
            examples:
              - - platform.censys.io:80
            items:
              type: string
            maxItems: 100
            minItems: 1
            type:
              - array
              - "null"
        - description: RFC3339 Timestamp to view all requested webproperties 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
          explode: false
          in: query
          name: at_time
          schema:
            description: RFC3339 Timestamp to view all requested webproperties 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
            examples:
              - "2025-01-01T00:00:00Z"
            format: date-time
            type: string
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.webproperty.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListWebpropertyAsset"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Retrieve multiple web properties
      tags:
        - Global Data
      x-speakeasy-ignore: true
    post:
      description: Retrieve information about multiple web properties. You can retrieve up to 100 web properties per call. Web properties are identified using a combination of a hostname and port joined with a colon, such as `platform.censys.io:80`.<br><br>In a SOC environment, use this endpoint to check up to 100 suspicious hostnames at once, such as domains from phishing reports or proxy logs, to find the live and malicious ones.
      operationId: v3-globaldata-asset-webproperty-list-post
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/AssetWebpropertyListInputBody"
        required: true
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.webproperty.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListWebpropertyAsset"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Retrieve multiple web properties
      tags:
        - Global Data
      x-speakeasy-name-override: GetWebProperties
  /v3/global/asset/webproperty/{webproperty_id}:
    get:
      description: Retrieve information about a single web property. Web properties are identified using a combination of a hostname and port joined with a colon, such as `platform.censys.io:80`.<br><br>In a SOC environment, use this endpoint to inspect the current content, technologies, and certificate for a hostname and port from a phishing or C2 alert.
      operationId: v3-globaldata-asset-webproperty
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: A web property identifier.
          in: path
          name: webproperty_id
          required: true
          schema:
            description: A web property identifier.
            examples:
              - platform.censys.io:80
            type: string
        - description: RFC3339 Timestamp to view a webproperty 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
          explode: false
          in: query
          name: at_time
          schema:
            description: RFC3339 Timestamp to view a webproperty 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
            examples:
              - "2025-01-01T00:00:00Z"
            format: date-time
            type: string
        - description: Comma-separated list of fields to include in the response, in dot notation (for example `services.port`). Repeated fields are filtered per element. Omit the parameter or pass `*` to return every field. Unknown fields are rejected.
          explode: false
          in: query
          name: fields
          schema:
            description: Comma-separated list of fields to include in the response, in dot notation (for example `services.port`). Repeated fields are filtered per element. Omit the parameter or pass `*` to return every field. Unknown fields are rejected.
            examples:
              - hostname,port,tls.cipher_selected
            maxLength: 8192
            type: string
        - description: Comma-separated list of fields to exclude from the response, in dot notation (for example `services.banner`). Repeated fields are filtered per element. Unknown fields are rejected. Cannot be used together with `fields`.
          explode: false
          in: query
          name: exclude_fields
          schema:
            description: Comma-separated list of fields to exclude from the response, in dot notation (for example `services.banner`). Repeated fields are filtered per element. Unknown fields are rejected. Cannot be used together with `fields`.
            examples:
              - cert,endpoints.http.body
            maxLength: 8192
            type: string
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.webproperty.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeWebpropertyAsset"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get a web property
      tags:
        - Global Data
      x-speakeasy-name-override: GetWebProperty
  /v3/global/asset/webproperty/{webproperty_id}/timeline:
    get:
      description: Retrieve event history for a web property. Web properties are identified using a combination of a hostname and port joined with a colon, such as `platform.censys.io:80`. URL-encode the colon when used in the path (e.g. `platform.censys.io%3A80`).
      operationId: v3-globaldata-asset-webproperty-timeline
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: A web property identifier, such as platform.censys.io:80. URL-encode the colon when used in the path (e.g. platform.censys.io%3A80).
          in: path
          name: webproperty_id
          required: true
          schema:
            description: A web property identifier, such as platform.censys.io:80. URL-encode the colon when used in the path (e.g. platform.censys.io%3A80).
            examples:
              - platform.censys.io:80
            type: string
        - description: Start time of the web property timeline. Equivalent to the To field in the event history UI. This must be the timestamp closest to the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 2 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
          explode: false
          in: query
          name: start_time
          required: true
          schema:
            description: Start time of the web property timeline. Equivalent to the To field in the event history UI. This must be the timestamp closest to the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 2 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
            examples:
              - "2025-01-02T00:00:00Z"
            format: date-time
            type: string
        - description: End time of the web property timeline. Equivalent to the From field in the event history UI. This must be the timestamp furthest from the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 1 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
          explode: false
          in: query
          name: end_time
          required: true
          schema:
            description: End time of the web property timeline. Equivalent to the From field in the event history UI. This must be the timestamp furthest from the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 1 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
            examples:
              - "2025-01-01T00:00:00Z"
            format: date-time
            type: string
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.web_timeline_event.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeWebpropertyTimeline"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get web property event history
      tags:
        - Global Data
      x-speakeasy-name-override: GetWebPropertyTimeline
  /v3/global/dns/resolutions/ip/{ip}/bounds:
    get:
      description: Retrieve the domain names that resolved to an IP during a time frame. You can narrow results with `record_types` (A or AAAA).<br><br>Results are aggregated per domain name and multiple distinct ranges for a name will be grouped into one row of results. For example, if `censys.com` resolved to `1.1.1.1` from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will group those ranges into one entry for `censys.com` in the response.<br><br>To retrieve domain names for an IP with each record broken down by time range, use the [ranges endpoint](https://docs.censys.com/reference/v3-globaldata-dns-ip-resolution-ranges)<br><br>In a SOC environment, use this endpoint to find every domain that has pointed at a malicious IP, with first- and last-seen bounds per name, so you can discover related domains and block them.<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>[Learn more about Censys Active DNS](https://docs.censys.com/docs/platform-active-dns).
      operationId: v3-globaldata-dns-ip-resolution-bound
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
          explode: false
          in: query
          name: start_time
          schema:
            description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
            examples:
              - "2024-01-01T00:00:00Z"
            type: string
        - description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
          explode: false
          in: query
          name: end_time
          schema:
            description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
            examples:
              - "2024-01-31T23:59:59Z"
            type: string
        - description: Number of results per page (max 100)
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of results per page (max 100)
            examples:
              - 50
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from previous response
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from previous response
            type: string
        - description: Filter by record types (A, AAAA). For multiple values, include comma-separated values. Defaults to A and AAAA when omitted.
          explode: false
          in: query
          name: record_types
          schema:
            description: Filter by record types (A, AAAA). For multiple values, include comma-separated values. Defaults to A and AAAA when omitted.
            examples:
              - - A
            items:
              enum:
                - A
                - AAAA
              type: string
            type:
              - array
              - "null"
        - description: The IP address of a DNS record.
          in: path
          name: ip
          required: true
          schema:
            description: The IP address of a DNS record.
            examples:
              - 8.8.8.8
            format: ip
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeDnsIpResolutionBoundResponse"
          description: A list of domain names that resolved to the provided IP.
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get DNS names that resolved to an IP (aggregated bounds)
      tags:
        - Global Data
      x-speakeasy-name-override: ListDnsIpResolutionBounds
  /v3/global/dns/resolutions/ip/{ip}/ranges:
    get:
      description: Retrieve the domain names that resolved to an IP during a time frame. You can narrow results with `record_types` (A or AAAA).<br><br>Record results are broken down based on time range. For example, if `censys.com` resolved to `1.1.1.1` from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will return one row for each of those distinct ranges.<br><br>To retrieve domain names for an IP with each result aggregated by name, use the [bounds endpoint endpoint](https://docs.censys.com/reference/v3-globaldata-dns-ip-resolution-bound).<br><br>In a SOC environment, use this endpoint to see the exact time ranges a domain resolved to an IP, to confirm it was active during the incident window or to spot infrastructure reuse.<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>[Learn more about Censys Active DNS](https://docs.censys.com/docs/platform-active-dns).
      operationId: v3-globaldata-dns-ip-resolution-ranges
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
          explode: false
          in: query
          name: start_time
          schema:
            description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
            examples:
              - "2024-01-01T00:00:00Z"
            type: string
        - description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
          explode: false
          in: query
          name: end_time
          schema:
            description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
            examples:
              - "2024-01-31T23:59:59Z"
            type: string
        - description: Number of results per page (max 100)
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of results per page (max 100)
            examples:
              - 50
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from previous response
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from previous response
            type: string
        - description: Filter by record types (A, AAAA). For multiple values, include comma-separated values. Defaults to A and AAAA when omitted.
          explode: false
          in: query
          name: record_types
          schema:
            description: Filter by record types (A, AAAA). For multiple values, include comma-separated values. Defaults to A and AAAA when omitted.
            examples:
              - - A
            items:
              enum:
                - A
                - AAAA
              type: string
            type:
              - array
              - "null"
        - description: Filter to a specific domain name resolving to this IP.
          explode: false
          in: query
          name: domain
          schema:
            description: Filter to a specific domain name resolving to this IP.
            examples:
              - platform.censys.io
            type: string
        - description: The IP address of a DNS record.
          in: path
          name: ip
          required: true
          schema:
            description: The IP address of a DNS record.
            examples:
              - 8.8.8.8
            format: ip
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeDnsIpResolutionRangeResponse"
          description: A list of domain names that resolved to the provided IP.
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get DNS names that resolved to an IP (ranges)
      tags:
        - Global Data
      x-speakeasy-name-override: ListDnsIpResolutionRanges
  /v3/global/dns/resolutions/{name}/bounds:
    get:
      description: Retrieve the DNS resolution records for a name. This endpoint returns observed A, AAAA, MX, NS, SOA, and TXT records for the name you provide. You can filter by one or more record types using record_types.<br><br>Results are aggregated per record distinct ranges for a record will be grouped into one row of results. For example, if `censys.com` resolved to `1.1.1.1` from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will group those ranges into one entry for the `1.1.1.1` A record in the response.<br><br>To retrieve records for a name with each record broken down by time range, use the [ranges endpoint](https://docs.censys.com/reference/v3-globaldata-dns-name-resolution-ranges).<br><br>In a SOC environment, use this endpoint to see the A, AAAA, MX, NS, SOA, and TXT records observed for a suspicious domain, to pivot to its hosting and mail infrastructure.<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>[Learn more about Censys Active DNS](https://docs.censys.com/docs/platform-active-dns).
      operationId: v3-globaldata-dns-name-resolution-bound
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
          explode: false
          in: query
          name: start_time
          schema:
            description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
            examples:
              - "2024-01-01T00:00:00Z"
            type: string
        - description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
          explode: false
          in: query
          name: end_time
          schema:
            description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
            examples:
              - "2024-01-31T23:59:59Z"
            type: string
        - description: Number of results per page (max 100)
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of results per page (max 100)
            examples:
              - 50
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from previous response
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from previous response
            type: string
        - description: Filter by record types (A, AAAA, MX, NS, SOA, TXT). For multiple values, include comma-separated values. Defaults to all supported types when omitted.
          explode: false
          in: query
          name: record_types
          schema:
            description: Filter by record types (A, AAAA, MX, NS, SOA, TXT). For multiple values, include comma-separated values. Defaults to all supported types when omitted.
            examples:
              - - MX
            items:
              enum:
                - A
                - AAAA
                - MX
                - NS
                - SOA
                - TXT
              type: string
            type:
              - array
              - "null"
        - description: The domain name
          in: path
          name: name
          required: true
          schema:
            description: The domain name
            examples:
              - platform.censys.io
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeDnsNameResolutionBoundResponse"
          description: A list of DNS records currently resolving for the provided name.
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get DNS resolution records for a name (aggregated bounds)
      tags:
        - Global Data
      x-speakeasy-name-override: ListDnsNameResolutionBounds
  /v3/global/dns/resolutions/{name}/ranges:
    get:
      description: Retrieve the records that resolved for a name during a time frame. This endpoint returns observed A, AAAA, MX, NS, SOA, and TXT records for the name you provide. You can filter by one or more record types using `record_types`.<br><br>Record results are broken down based on time range. For example, if `censys.com` resolved to `1.1.1.1` from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will return one row for each of those distinct ranges for the `1.1.1.1` A record.<br><br>To retrieve records for a name with each result aggregated per record, use the [bounds endpoint endpoint](https://docs.censys.com/reference/v3-globaldata-dns-name-resolution-bound).<br><br>In a SOC environment, use this endpoint to see when a domain's records changed over time, such as a sudden hosting move after takedown.<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>[Learn more about Censys Active DNS](https://docs.censys.com/docs/platform-active-dns).
      operationId: v3-globaldata-dns-name-resolution-ranges
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
          explode: false
          in: query
          name: start_time
          schema:
            description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
            examples:
              - "2024-01-01T00:00:00Z"
            type: string
        - description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
          explode: false
          in: query
          name: end_time
          schema:
            description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
            examples:
              - "2024-01-31T23:59:59Z"
            type: string
        - description: Number of results per page (max 100)
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of results per page (max 100)
            examples:
              - 50
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from previous response
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from previous response
            type: string
        - description: Filter by record types (A, AAAA, MX, NS, SOA, TXT). For multiple values, include comma-separated values. Defaults to all supported types when omitted.
          explode: false
          in: query
          name: record_types
          schema:
            description: Filter by record types (A, AAAA, MX, NS, SOA, TXT). For multiple values, include comma-separated values. Defaults to all supported types when omitted.
            examples:
              - - MX
            items:
              enum:
                - A
                - AAAA
                - MX
                - NS
                - SOA
                - TXT
              type: string
            type:
              - array
              - "null"
        - description: The domain name
          in: path
          name: name
          required: true
          schema:
            description: The domain name
            examples:
              - platform.censys.io
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeDnsNameResolutionRangeResponse"
          description: A list of DNS resolution observations for the provided name.
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get DNS resolution records for a name (ranges)
      tags:
        - Global Data
      x-speakeasy-name-override: ListDnsNameResolutionRanges
  /v3/global/scans/rescan:
    post:
      description: Initiate a rescan for a known host service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Rescan](https://docs.censys.com/docs/platform-live-rescan#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-globaldata-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>In a SOC environment, rescan to ensure triage, an investigation, or a hunt has the most accurate and current state. This includes information like whether C2 servers are still operational, or whether an organization's asset is still exposed to the internet.<br><br>This endpoint is available to all Enterprise customers. It costs 10 credits to execute.
      operationId: v3-globaldata-scans-rescan
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/ScansRescanInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTrackedScan"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: "Live Rescan: Initiate a new rescan"
      tags:
        - Global Data
      x-speakeasy-name-override: CreateTrackedScan
  /v3/global/scans/{scan_id}:
    get:
      description: Retrieve the current status of a scan by its ID. This endpoint works for both [Live Discovery scans](https://docs.censys.com/reference/v3-threathunting-scans-discovery#/) and [Live Rescans](https://docs.censys.com/reference/v3-globaldata-scans-rescan#/).<br><br>Use this endpoint to check whether a Live Discovery or Live Rescan scan has finished, so automation knows when fresh data is ready to pull.<br><br>If the scan was successful, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all enterprise customers. This endpoint does not cost any credits to execute.
      operationId: v3-globaldata-scans-get
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The unique identifier of the tracked scan
          in: path
          name: scan_id
          required: true
          schema:
            description: The unique identifier of the tracked scan
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.trackedscan.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTrackedScan"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No scan found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get scan status
      tags:
        - Global Data
      x-speakeasy-name-override: GetTrackedScan
  /v3/global/search/aggregate:
    post:
      description: Aggregate results for a Platform search query. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.<br><br>In a SOC environment, use this endpoint to count and bucket matches by field, such as country, ASN, or port, to size a campaign or spot where malicious infrastructure clusters without pulling every record.
      operationId: v3-globaldata-search-aggregate
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SearchAggregateInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeSearchAggregateResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Aggregate results for a search query
      tags:
        - Global Data
      x-speakeasy-name-override: Aggregate
  /v3/global/search/convert:
    post:
      description: Convert Censys Search Language queries used in Legacy Search into Censys Query Language (CenQL) queries for use in the Platform.<br><br>Reference the [documentation on CenQL](https://docs.censys.com/docs/censys-query-language) for more information about query syntax.
      operationId: v3-globaldata-search-convert
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SearchConvertQueryInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeListSearchConvertQueryResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Convert Legacy Search queries to Platform queries
      tags:
        - Global Data
      x-speakeasy-name-override: ConvertLegacySearchQueries
  /v3/global/search/query:
    post:
      description: Run a search query across Censys data. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax.<br><br>Host services that match your search criteria will be returned in a `matched_services` object.<br><br>In a SOC environment, use this endpoint to hunt for hosts, web properties, or certificates that match an indicator, such as a C2 banner, JARM, or favicon hash to scope infrastructure tied to an alert.
      operationId: v3-globaldata-search-query
      parameters:
        - description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          schema:
            description: The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SearchQueryInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeSearchQueryResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Run a search query
      tags:
        - Global Data
      x-speakeasy-name-override: Search
      x-speakeasy-usage-example:
        description: ""
        position: 1
        tags: []
        title: ""
  /v3/tags:
    get:
      description: Retrieve a paginated list of tags in your organization. Private tags created by other users are not included in the results unless your account is an organization admin.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-tags-list-tags
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Number of tags to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of tags to return per page.
            format: int32
            maximum: 1000
            minimum: 1
            type: integer
        - description: Pagination token from a previous response to retrieve the next page of results.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results.
            type: string
        - description: "Sort order. Supported values: name_asc, name_desc, created_at_asc, created_at_desc, updated_at_asc, updated_at_desc."
          explode: false
          in: query
          name: order_by
          schema:
            default: name_asc
            description: "Sort order. Supported values: name_asc, name_desc, created_at_asc, created_at_desc, updated_at_asc, updated_at_desc."
            enum:
              - name_asc
              - name_desc
              - created_at_asc
              - created_at_desc
              - updated_at_asc
              - updated_at_desc
            type: string
        - description: Filter tags by name (exact match).
          explode: false
          in: query
          name: name
          schema:
            description: Filter tags by name (exact match).
            type: string
        - description: Filter tags by the user ID of the user who created the tag.
          explode: false
          in: query
          name: created_by
          schema:
            description: Filter tags by the user ID of the user who created the tag.
            format: uuid
            type: string
        - description: Filter tags by privacy setting.
          explode: false
          in: query
          name: privacy
          schema:
            description: Filter tags by privacy setting.
            enum:
              - private
              - shared
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTagsList"
          description: Tags retrieved successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List tags
      tags:
        - Tags and Comments
      x-speakeasy-name-override: ListTags
    post:
      description: "Create a new tag in your organization. Tags can be used to label and organize assets.<br><br>Specify a privacy setting to control visibility: `private` tags are only visible to you and organization admins, while `shared` tags are visible and manageable by all organization members.<br><br>Tag names must be unique within your organization.<br><br>This endpoint does not cost any credits to execute."
      operationId: v3-tags-create-tag
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateTagInputBody"
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTag"
          description: Tag created successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag name already exists in this organization
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Create a tag
      tags:
        - Tags and Comments
      x-speakeasy-name-override: CreateTag
  /v3/tags/{tag_id}:
    delete:
      description: Delete a tag and all of its assignments from your organization. This action is permanent and cannot be undone.<br><br>Only the tag's creator or an organization admin can delete a `private` tag. Tags that are `shared` can be deleted by any organization member.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-tags-delete-tag
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the tag to delete.
          in: path
          name: tag_id
          required: true
          schema:
            description: The ID of the tag to delete.
            format: uuid
            type: string
      responses:
        "204":
          description: Tag deleted successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Delete a tag
      tags:
        - Tags and Comments
      x-speakeasy-name-override: DeleteTag
    get:
      description: "Retrieve a tag by its ID or name. Tag names are unique within an organization and can be used interchangeably with the tag ID in the path parameter.<br><br>Only tags that are visible to the caller are returned: private tags created by other users are not accessible unless your account is an organization admin.<br><br>This endpoint does not cost any credits to execute."
      operationId: v3-tags-get-tag
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID or name of the tag to retrieve.
          in: path
          name: tag_id
          required: true
          schema:
            description: The ID or name of the tag to retrieve.
            examples:
              - 123e4567-e89b-12d3-a456-426614174000
              - my-tag
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTag"
          description: Tag retrieved successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get a tag
      tags:
        - Tags and Comments
      x-speakeasy-name-override: GetTag
    put:
      description: 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. A `shared` tag cannot be made `private`.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-tags-update-tag
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the tag to update.
          in: path
          name: tag_id
          required: true
          schema:
            description: The ID of the tag to update.
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/UpdateTagInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTag"
          description: Tag updated successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag name already exists in this organization, or a shared tag cannot be made private
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Update a tag
      tags:
        - Tags and Comments
      x-speakeasy-name-override: UpdateTag
  /v3/tags/{tag_id}/assignments:
    get:
      description: Retrieve a paginated list of assignments for a tag in your organization. Use query parameters to filter results by asset, created_by, or creation time. Only assignments for tags visible to your account are returned.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-tags-list-assignments
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the tag whose assignments to list.
          in: path
          name: tag_id
          required: true
          schema:
            description: The ID of the tag whose assignments to list.
            format: uuid
            type: string
        - description: Number of assignments to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of assignments to return per page.
            format: int32
            maximum: 1000
            minimum: 1
            type: integer
        - description: Pagination token from a previous response to retrieve the next page of results.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results.
            type: string
        - description: "Sort order. Supported values: create_time_asc, create_time_desc."
          explode: false
          in: query
          name: order_by
          schema:
            default: create_time_desc
            description: "Sort order. Supported values: create_time_asc, create_time_desc."
            enum:
              - create_time_asc
              - create_time_desc
            type: string
        - description: The identifier of the asset (host IP, certificate SHA-256 fingerprint, or web property hostname:port).
          explode: false
          in: query
          name: asset_id
          schema:
            description: The identifier of the asset (host IP, certificate SHA-256 fingerprint, or web property hostname:port).
            examples:
              - 8.8.8.8
              - 3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf
              - platform.censys.io:443
            type: string
        - description: Filter assignments by asset type.
          explode: false
          in: query
          name: asset_type
          schema:
            description: Filter assignments by asset type.
            enum:
              - host
              - web_property
              - certificate
            type: string
        - description: RFC3339 timestamp. Only return assignments created before this time.
          explode: false
          in: query
          name: created_before
          schema:
            description: RFC3339 timestamp. Only return assignments created before this time.
            format: date-time
            type: string
        - description: RFC3339 timestamp. Only return assignments created after this time.
          explode: false
          in: query
          name: created_after
          schema:
            description: RFC3339 timestamp. Only return assignments created after this time.
            format: date-time
            type: string
        - description: Filter by the user ID of the user who created the assignment.
          explode: false
          in: query
          name: created_by
          schema:
            description: Filter by the user ID of the user who created the assignment.
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTagAssignmentsList"
          description: Tag assignments retrieved successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List tag assignments
      tags:
        - Tags and Comments
      x-speakeasy-name-override: ListTagAssignments
    post:
      description: Assign a tag to an asset. Tag assignments are only visible to members of your organization, depending on the tag's privacy settings. You must have access to the tag to assign it to an asset.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-tags-create-assignment
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the tag to assign.
          in: path
          name: tag_id
          required: true
          schema:
            description: The ID of the tag to assign.
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateTagAssignmentInputBody"
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTagAssignment"
          description: Tag assignment created successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag assignment already exists for this asset
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Create a tag assignment
      tags:
        - Tags and Comments
      x-speakeasy-name-override: CreateTagAssignment
  /v3/tags/{tag_id}/assignments/bulk-create:
    post:
      description: 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.
      operationId: v3-tags-bulk-create-assignments
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the tag to assign.
          in: path
          name: tag_id
          required: true
          schema:
            description: The ID of the tag to assign.
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkCreateTagAssignmentsInputBody"
        required: true
      responses:
        "202":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTagOperation"
          description: Bulk create operation started successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Query is invalid, or is valid but matches no assets
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Bulk create tag assignments
      tags:
        - Tags and Comments
      x-speakeasy-name-override: BulkCreateTagAssignments
  /v3/tags/{tag_id}/assignments/bulk-delete:
    post:
      description: 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.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-tags-bulk-delete-assignments
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the tag whose assignments to delete.
          in: path
          name: tag_id
          required: true
          schema:
            description: The ID of the tag whose assignments to delete.
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BulkDeleteTagAssignmentsInputBody"
        required: true
      responses:
        "202":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTagOperation"
          description: Bulk delete operation started successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Bulk delete tag assignments
      tags:
        - Tags and Comments
      x-speakeasy-name-override: BulkDeleteTagAssignments
  /v3/tags/{tag_id}/assignments/{assignment_id}:
    delete:
      description: Remove a tag assignment from an asset. This action is permanent and cannot be undone. Removing an assignment only detaches the tag from the specified asset; the tag itself is not deleted. Only the tag's creator or an organization admin can delete an assignment for a `private` tag. Assignments for `shared` tags can be deleted by any organization member.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-tags-delete-assignment
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the tag.
          in: path
          name: tag_id
          required: true
          schema:
            description: The ID of the tag.
            format: uuid
            type: string
        - description: The ID of the assignment to delete.
          in: path
          name: assignment_id
          required: true
          schema:
            description: The ID of the assignment to delete.
            format: uuid
            type: string
      responses:
        "204":
          description: Tag assignment deleted successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag or assignment not found
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Delete a tag assignment
      tags:
        - Tags and Comments
      x-speakeasy-name-override: DeleteTagAssignment
  /v3/tags/{tag_id}/operations:
    get:
      description: Retrieve a paginated list of bulk tag operations. Provide a tag ID in the path to scope the listing to a single tag, or `-` to list operations across all tags in your organization. Use query parameters to filter by type or status.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-tags-list-operations
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the tag whose operations to list, or `-` to list operations across all tags in your organization.
          in: path
          name: tag_id
          required: true
          schema:
            description: The ID of the tag whose operations to list, or `-` to list operations across all tags in your organization.
            examples:
              - 123e4567-e89b-12d3-a456-426614174000
              - "-"
            type: string
        - description: Number of operations to return per page.
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of operations to return per page.
            format: int32
            maximum: 1000
            minimum: 1
            type: integer
        - description: Pagination token from a previous response to retrieve the next page of results.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from a previous response to retrieve the next page of results.
            type: string
        - description: "Sort order. Supported values: create_time_asc, create_time_desc."
          explode: false
          in: query
          name: order_by
          schema:
            default: create_time_desc
            description: "Sort order. Supported values: create_time_asc, create_time_desc."
            enum:
              - create_time_asc
              - create_time_desc
            type: string
        - description: Filter by operation type.
          explode: false
          in: query
          name: type
          schema:
            description: Filter by operation type.
            enum:
              - bulk_create
              - bulk_delete
            type: string
        - description: Filter by operation status.
          explode: false
          in: query
          name: status
          schema:
            description: Filter by operation status.
            enum:
              - pending
              - running
              - succeeded
              - limit_reached
              - failed
              - cancelled
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTagOperationsList"
          description: Tag operations retrieved successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List tag operations
      tags:
        - Tags and Comments
      x-speakeasy-name-override: ListTagOperations
  /v3/tags/{tag_id}/operations/{operation_id}:
    get:
      description: Retrieve a single bulk tag operation by ID, including its current status and progress counts. Use this to poll the status of an operation started by the bulk-create or bulk-delete endpoints.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-tags-get-operation
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the tag the operation belongs to.
          in: path
          name: tag_id
          required: true
          schema:
            description: The ID of the tag the operation belongs to.
            format: uuid
            type: string
        - description: The ID of the operation to retrieve.
          in: path
          name: operation_id
          required: true
          schema:
            description: The ID of the operation to retrieve.
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTagOperation"
          description: Tag operation retrieved successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag operation not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get a tag operation
      tags:
        - Tags and Comments
      x-speakeasy-name-override: GetTagOperation
  /v3/tags/{tag_id}/operations/{operation_id}/cancel:
    post:
      description: "Request cancellation of an in-progress bulk tag operation. Cancellation is cooperative: the operation finishes the page it is currently processing, then stops. Work already committed before cancellation is preserved.<br><br>Cancellation is not a rollback — it stops further work but does not remove assignments the operation already created. To remove assignments, use the bulk-delete endpoint. An operation that has already finished cannot be cancelled.<br><br>This endpoint does not cost any credits to execute."
      operationId: v3-tags-cancel-operation
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The ID of the tag the operation belongs to.
          in: path
          name: tag_id
          required: true
          schema:
            description: The ID of the tag the operation belongs to.
            format: uuid
            type: string
        - description: The ID of the operation to cancel.
          in: path
          name: operation_id
          required: true
          schema:
            description: The ID of the operation to cancel.
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTagOperation"
          description: Tag operation cancellation requested successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag operation not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Tag operation has already finished and cannot be cancelled
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Cancel a tag operation
      tags:
        - Tags and Comments
      x-speakeasy-name-override: CancelTagOperation
  /v3/threat-hunting/censeye/jobs:
    get:
      description: List CensEye pivot analysis jobs for the current organization. Results are paginated. Optionally filter by asset (host, web property, or certificate).
      operationId: v3-threathunting-censeye-jobs-list
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Number of results per page (max 100)
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of results per page (max 100)
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from previous response
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from previous response
            type: string
        - description: Filter by host IP address.
          explode: false
          in: query
          name: host_id
          schema:
            description: Filter by host IP address.
            examples:
              - 8.8.8.8
            type: string
        - description: Filter by web property (hostname:port).
          explode: false
          in: query
          name: webproperty_id
          schema:
            description: Filter by web property (hostname:port).
            examples:
              - example.com:443
            type: string
        - description: Filter by certificate SHA-256 fingerprint.
          explode: false
          in: query
          name: certificate_id
          schema:
            description: Filter by certificate SHA-256 fingerprint.
            examples:
              - 3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCenseyeJobsListResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Conflict
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: "CensEye: List jobs"
      tags:
        - Threat Hunting
      x-speakeasy-name-override: ListCenseyeJobs
    post:
      description: Create an asynchronous CensEye pivot analysis job for a host, web property, or certificate. The job extracts [default pivot fields](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#default-pivot-fields) from the target asset and counts matching documents for each field-value pair. Poll the job status endpoint to track progress, then retrieve results when complete.<br><br>Use this endpoint to start an analysis of a suspicious host, web property, or certificate that finds the rare attributes it shares with other assets, so you can uncover related attacker infrastructure.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint costs 44 credits to execute for a host, 28 credits to execute for a web property, and 7 credits to execute for a certificate.
      operationId: v3-threathunting-censeye-jobs-create
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateCenseyeJobInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCenseyeJob"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: "CensEye: Create a pivot analysis job"
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: CreateCenseyeJob
  /v3/threat-hunting/censeye/jobs/{job_id}:
    get:
      description: Retrieve the current status of a CensEye pivot analysis job. Use this to poll for completion before fetching results.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
      operationId: v3-threathunting-censeye-jobs-get
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The unique identifier of the CensEye job.
          in: path
          name: job_id
          required: true
          schema:
            description: The unique identifier of the CensEye job.
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCenseyeJob"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: "CensEye: Get job status"
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: GetCenseyeJob
  /v3/threat-hunting/censeye/jobs/{job_id}/results:
    get:
      description: Retrieve the results of a completed CensEye pivot analysis job. Use this endpoint to retrieve the pivots from a finished job, then turn the most distinctive ones into searches or blocklist candidates.<br><br>Each result contains a count and the field-value pairs that were analyzed. Results may be empty if the job is still running.<br><br>Results are paginated. Use the `next_page_token` from the response to fetch subsequent pages.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
      operationId: v3-threathunting-censeye-job-results
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The unique identifier of the CensEye job.
          in: path
          name: job_id
          required: true
          schema:
            description: The unique identifier of the CensEye job.
            format: uuid
            type: string
        - description: Number of results per page (max 100)
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of results per page (max 100)
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from previous response
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from previous response
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCenseyeResultsResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: "CensEye: Get job results"
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: GetCenseyeJobResults
  /v3/threat-hunting/certificate/{certificate_id}/observations/hosts:
    get:
      description: Retrieve the historical observations of hosts associated with a certificate. Use this endpoint to see every host that has presented a given certificate over time, so you can build a timeline and find other infrastructure using it.<br><br>Certificate history is also visible to Adversary Investigation users in the Platform UI on the [certificate timeline](https://docs.censys.com/docs/platform-threat-hunting-use-cert-history-to-build-better-detections#/).<br><br>You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.<br><br>For workspaces with a history limit, the API returns observation ranges that overlap the allowed history window. The window starts at 00:00 UTC the allowed number of days ago and ends at the time of the request. Ranges are returned in full, with their original start and end times, even if they extend outside the window.<br><br>You may also filter results by port and transport protocol.<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module. This endpoint costs one credit per page of results.
      operationId: v3-threathunting-get-host-observations-with-certificate
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: SHA-256 hash of the certificate
          in: path
          name: certificate_id
          required: true
          schema:
            description: SHA-256 hash of the certificate
            examples:
              - 55af8a301eb51abdaf7c31bec951638fe5a99d5d92117eca2be493026613fa46
            type: string
        - description: Only show ranges ending at or after this time (ISO 8601)
          explode: false
          in: query
          name: start_time
          schema:
            description: Only show ranges ending at or after this time (ISO 8601)
            examples:
              - "2023-01-01T00:00:00Z"
            type: string
        - description: Only show ranges starting at or before this time (ISO 8601)
          explode: false
          in: query
          name: end_time
          schema:
            description: Only show ranges starting at or before this time (ISO 8601)
            examples:
              - "2023-12-31T23:59:59Z"
            type: string
        - description: The port to filter by
          explode: false
          in: query
          name: port
          schema:
            description: The port to filter by
            examples:
              - 443
            format: int32
            type: integer
        - description: The application protocol to filter by
          explode: false
          in: query
          name: protocol
          schema:
            description: The application protocol to filter by
            examples:
              - RDP
            type: string
        - description: Pagination token from previous response to retrieve next page of results
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from previous response to retrieve next page of results
            type: string
        - description: Number of results per page. Maximum 100, defaults to 100 if not specified
          explode: false
          in: query
          name: page_size
          schema:
            description: Number of results per page. Maximum 100, defaults to 100 if not specified
            examples:
              - 50
            format: int32
            type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeHostObservationResponse"
          description: A list of host observations for the certificate
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get host history for a certificate
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: GetHostObservationsWithCertificate
  /v3/threat-hunting/host/{ip}/observations/endpoints:
    get:
      description: Retrieve historical endpoint-level hash observations for a host.<br><br>Use this endpoint to see when an IP served a given page body, favicon, or banner, so you can identify changes on a host or pivot to other hosts serving the same content.<br><br>You must provide an `observation_type` and can optionally filter by a specific value using the `observation_value` parameter. You may also filter by port number.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
      operationId: v3-threathunting-endpoint-observations-on-host
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
          explode: false
          in: query
          name: start_time
          schema:
            description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
            examples:
              - "2024-01-01T00:00:00Z"
            type: string
        - description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
          explode: false
          in: query
          name: end_time
          schema:
            description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
            examples:
              - "2024-01-31T23:59:59Z"
            type: string
        - description: Number of results per page (max 100)
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of results per page (max 100)
            examples:
              - 50
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from previous response
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from previous response
            type: string
        - description: Filter by port number
          explode: false
          in: query
          name: port
          schema:
            description: Filter by port number
            examples:
              - 443
            format: int32
            type: integer
        - description: Filter by observation value for the selected observation_type
          explode: false
          in: query
          name: observation_value
          schema:
            description: Filter by observation value for the selected observation_type
            type: string
        - description: The IP address of a host.
          in: path
          name: ip
          required: true
          schema:
            description: The IP address of a host.
            examples:
              - 8.8.8.8
            format: ip
            type: string
        - description: Endpoint observation type to query.
          explode: false
          in: query
          name: observation_type
          required: true
          schema:
            description: Endpoint observation type to query.
            enum:
              - body_hash_sha1
              - body_hash_sha256
              - favicon_hash_md5
              - favicon_hash_sha256
              - favicon_hash_shodan
              - banner_hash_sha256
              - endpoints_banner_hash_sha256
            type: string
        - description: Order observations by these fields. Multiple values can be provided (e.g., ['port DESC', 'observation_value ASC']).
          explode: false
          in: query
          name: order_by
          schema:
            description: Order observations by these fields. Multiple values can be provided (e.g., ['port DESC', 'observation_value ASC']).
            items:
              enum:
                - port ASC
                - port DESC
                - observation_value ASC
                - observation_value DESC
              type: string
            type:
              - array
              - "null"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeHashObservationsOnHostResponse"
          description: A list of observation ranges
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get endpoint observation history for a host
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListEndpointObservationsOnHost
  /v3/threat-hunting/host/{ip}/observations/fingerprints:
    get:
      description: Retrieve fingerprint observations for a host.<br><br>Use this endpoint to see which TLS certificate chains an IP has presented, on which ports, and when, so you can spot infrastructure changes, pivot to related hosts, identify certificate swaps, or tie a host to attacker-controlled certificates.<br><br>You may optionally include a time range by using `start_time` and `end_time`. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.<br><br>You must provide an `observation_type` and can optionally filter by `port` and `observation_value`.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
      operationId: v3-threathunting-fingerprint-observations-on-host
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
          explode: false
          in: query
          name: start_time
          schema:
            description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
            examples:
              - "2024-01-01T00:00:00Z"
            type: string
        - description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
          explode: false
          in: query
          name: end_time
          schema:
            description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
            examples:
              - "2024-01-31T23:59:59Z"
            type: string
        - description: Number of results per page (max 100)
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of results per page (max 100)
            examples:
              - 50
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from previous response
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from previous response
            type: string
        - description: Filter by port number
          explode: false
          in: query
          name: port
          schema:
            description: Filter by port number
            examples:
              - 443
            format: int32
            type: integer
        - description: Filter by transport protocol when supported by the selected observation_type
          explode: false
          in: query
          name: transport_protocol
          schema:
            description: Filter by transport protocol when supported by the selected observation_type
            enum:
              - tcp
              - udp
              - icmp
              - quic
            examples:
              - tcp
            type: string
        - description: Filter by observation value for the selected observation_type
          explode: false
          in: query
          name: observation_value
          schema:
            description: Filter by observation value for the selected observation_type
            type: string
        - description: The IP address of a host.
          in: path
          name: ip
          required: true
          schema:
            description: The IP address of a host.
            examples:
              - 8.8.8.8
            format: ip
            type: string
        - description: Fingerprint observation type to query.
          explode: false
          in: query
          name: observation_type
          required: true
          schema:
            description: Fingerprint observation type to query.
            enum:
              - tls_presented_chain_fingerprint_sha256
            type: string
        - description: Order observations by these fields. Multiple values can be provided (e.g., ['port DESC', 'observation_value ASC']). transport_protocol ordering is only supported for observation types whose timelines expose that field; see the endpoint description for details.
          explode: false
          in: query
          name: order_by
          schema:
            description: Order observations by these fields. Multiple values can be provided (e.g., ['port DESC', 'observation_value ASC']). transport_protocol ordering is only supported for observation types whose timelines expose that field; see the endpoint description for details.
            items:
              enum:
                - port ASC
                - port DESC
                - transport_protocol ASC
                - transport_protocol DESC
                - observation_value ASC
                - observation_value DESC
              type: string
            type:
              - array
              - "null"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeHashObservationsOnHostResponse"
          description: A list of observation ranges
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get fingerprint observation history for a host
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListFingerprintObservationsOnHost
  /v3/threat-hunting/host/{ip}/observations/threats:
    get:
      description: Retrieve historical threat observations for a host. This endpoint returns time ranges during which threats were detected on the host.<br><br>Use this endpoint to see when a host was flagged for threats, so you can check whether it was malicious during the window of an incident.<br><br>You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.<br><br>You can filter by port number, protocol, threat name, and transport protocol.<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module.
      operationId: v3-threathunting-threats-on-host
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
          explode: false
          in: query
          name: start_time
          schema:
            description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
            examples:
              - "2024-01-01T00:00:00Z"
            type: string
        - description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
          explode: false
          in: query
          name: end_time
          schema:
            description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
            examples:
              - "2024-01-31T23:59:59Z"
            type: string
        - description: Number of results per page (max 100)
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of results per page (max 100)
            examples:
              - 50
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from previous response
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from previous response
            type: string
        - description: Filter by port number
          explode: false
          in: query
          name: port
          schema:
            description: Filter by port number
            examples:
              - 443
            format: int32
            type: integer
        - description: Filter by application protocol
          explode: false
          in: query
          name: protocol
          schema:
            description: Filter by application protocol
            examples:
              - HTTP
            type: string
        - description: Filter by threat name
          explode: false
          in: query
          name: threat_name
          schema:
            description: Filter by threat name
            examples:
              - Acunetix
            type: string
        - description: Filter by transport protocol
          explode: false
          in: query
          name: transport_protocol
          schema:
            description: Filter by transport protocol
            enum:
              - tcp
              - udp
            examples:
              - tcp
            type: string
        - description: The IP address of a host.
          in: path
          name: ip
          required: true
          schema:
            description: The IP address of a host.
            examples:
              - 8.8.8.8
            format: ip
            type: string
        - description: Order observations by these fields. Multiple values can be provided to sort by multiple fields (e.g., ['port DESC', 'protocol ASC']).
          explode: false
          in: query
          name: order_by
          schema:
            description: Order observations by these fields. Multiple values can be provided to sort by multiple fields (e.g., ['port DESC', 'protocol ASC']).
            items:
              enum:
                - port ASC
                - port DESC
                - protocol ASC
                - protocol DESC
                - transport_protocol ASC
                - transport_protocol DESC
                - threat_name ASC
                - threat_name DESC
              type: string
            type:
              - array
              - "null"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeThreatsOnHostResponse"
          description: A list of threat observation ranges
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get threat history for a host
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListThreatsOnHost
  /v3/threat-hunting/investigations/files:
    post:
      description: Prepare to attach an evidence file to an investigation. Use this endpoint to stage evidence, such as logs, malware reports, or alert exports, so an AI investigation can use it.<br><br>This endpoint does not accept the file. It returns a URL to send the file to and an identifier to pass to the [create job endpoint](https://docs.censys.com/reference/v3-threathunting-investigations-jobs-create) afterwards.<br><br>Upload the file with an HTTP PUT to `upload_url` and send `upload_headers` exactly as returned by this endpoint. The URL grants access to that one file and stops working at `expire_time`; a file uploaded before that stays usable afterwards. Prepare one upload per file.<br><br>Start the investigation promptly after uploading. There is a limit on how many uploaded files you may hold without using them and starting an investigation from a file releases its slot. A file that no investigation references is discarded once it passes the service's retention window for unused uploads. A file an investigation does reference is kept with that investigation for as long as the investigation itself.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-threathunting-investigations-files-create
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateInvestigationFileInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeInvestigationFileUpload"
          description: Upload prepared successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "413":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Request body too large
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "429":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: You are holding too many unused uploads
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: "Investigations: Create file upload"
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: CreateInvestigationFileUpload
  /v3/threat-hunting/investigations/jobs:
    get:
      description: List the AI investigations you have started. The most recent investigations are listed first and only investigations that have not passed their retention period are shown. Results are paginated and include investigations started in the Platform UI as well as through the API.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-threathunting-investigations-jobs-list
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Number of investigations to return per page. Zero or omitted returns at most 50; values above 200 are reduced to 200.
          explode: false
          in: query
          name: page_size
          schema:
            default: 50
            description: Number of investigations to return per page. Zero or omitted returns at most 50; values above 200 are reduced to 200.
            format: int32
            minimum: 0
            type: integer
        - description: Pagination token from the next_page_token of a previous response. Omit it to start from the first page.
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from the next_page_token of a previous response. Omit it to start from the first page.
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeInvestigationJobsList"
          description: Investigations retrieved successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: "Investigations: List jobs"
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: ListInvestigationJobs
    post:
      description: Start an [AI investigation](https://docs.censys.com/docs/platform-ai-investigations) from a set of indicators, a set of previously uploaded evidence files, or both to obtain a report on suspect infrastructure without doing the pivots by hand.<br><br>Supply at least one `indicators` or `file_ids`. To use files, upload them first with the [create file upload endpoint](https://docs.censys.com/reference/v3-threathunting-investigations-files-create).<br><br>This endpoint returns a `job_id` that you can poll to retrieve its status and results.<br><br>Provide `start_time` and `end_time` to scope the investigation to a time frame, or `start_time` alone to scope it from that time up to now. Omit both to investigate current data.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.
      operationId: v3-threathunting-investigations-jobs-create
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/CreateInvestigationJobInputBody"
        required: true
      responses:
        "202":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeCreatedInvestigationJob"
          description: Investigation started successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "413":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Request body too large
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "429":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Too many investigations running, or the organization's allowance is spent
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: "Investigations: Create job"
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: CreateInvestigationJob
  /v3/threat-hunting/investigations/jobs/{job_id}:
    get:
      description: Retrieve the status of one AI investigation. Poll this endpoint until the investigation is completed, then download its report and evidence.<br><br>An investigation that does not exist, belongs to another user, or has passed its retention window will return a “not found” response.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-threathunting-investigations-jobs-get
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The unique identifier of the investigation.
          in: path
          name: job_id
          required: true
          schema:
            description: The unique identifier of the investigation.
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeInvestigationJob"
          description: Investigation retrieved successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: "Investigations: Get job status"
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: GetInvestigationJob
  /v3/threat-hunting/investigations/jobs/{job_id}/results:
    get:
      description: Download the ZIP archive that contains a completed AI investigation's report and evidence. You can only retrieve the job results for an investigation you started. The archive is composed when you request it and is never stored.<br><br>Investigations that did not publish any findings or have passed their retention windows will return a “not found” response.<br><br>If an investigation’s ZIP archive is larger than 20 megabytes, you will receive a “payload too large” response. You can only retrieve the results for investigations that exceed this size limit within the Platform UI.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-threathunting-investigations-jobs-results
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The unique identifier of the investigation.
          in: path
          name: job_id
          required: true
          schema:
            description: The unique identifier of the investigation.
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/zip:
              schema:
                contentMediaType: application/octet-stream
                format: binary
                type: string
          description: Investigation results archive
          headers:
            Cache-Control:
              schema:
                type: string
            Content-Disposition:
              schema:
                type: string
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "413":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Investigation results are too large to download
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
        "503":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Investigation results could not be packaged right now
        "504":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Packaging the investigation results timed out
      security:
        - PersonalAccessToken: []
      summary: "Investigations: Get job results"
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: GetInvestigationJobResults
  /v3/threat-hunting/investigations/usage:
    get:
      description: Retrieve your organization's investigation limit, current usage, and the number of remaining investigations.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint does not cost any credits to execute.
      operationId: v3-threathunting-investigations-usage-get
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeInvestigationUsage"
          description: Investigation usage retrieved successfully
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: "Investigations: Get usage"
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: GetInvestigationUsage
  /v3/threat-hunting/scans/discovery:
    post:
      description: Initiate a scan to look for a currently unobserved service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Discovery](https://docs.censys.com/docs/platform-threat-hunting-use-live-scan-and-rescan-to-validate-infrastructure#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-threathunting-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>Use this endpoint to scan for a service at an `ip:port` or `hostname:port`, such as a new IOC from an incident, so you can get data on it right away.<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module. It costs 15 credits to execute this endpoint.
      operationId: v3-threathunting-scans-discovery
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/ScansDiscoveryInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTrackedScan"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: "Live Discovery: Initiate a new scan"
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: CreateTrackedScan
  /v3/threat-hunting/scans/{scan_id}:
    get:
      description: Retrieve the current status of a scan by its ID. This endpoint works for both [Live Discovery scans](https://docs.censys.com/reference/v3-threathunting-scans-discovery#/) and [Live Rescans](https://docs.censys.com/reference/v3-globaldata-scans-rescan#/).<br><br>Use this endpoint to check whether a Live Discovery or Live Rescan scan has finished, so automation knows when fresh data is ready to pull.<br><br>If the scan was successful, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all enterprise customers. This endpoint does not cost any credits to execute.
      operationId: v3-threathunting-scans-get
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: The unique identifier of the tracked scan
          in: path
          name: scan_id
          required: true
          schema:
            description: The unique identifier of the tracked scan
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/vnd.censys.api.v3.trackedscan.v1+json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeTrackedScan"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: No scan found
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get scan status
      tags:
        - Threat Hunting
      x-speakeasy-name-override: GetTrackedScanThreatHunting
  /v3/threat-hunting/threats:
    get:
      description: Retrieve a list of active threats observed by Censys by aggregating threat IDs across hosts and web properties. Use this endpoint to see currently active threats so you can prioritize which malicious infrastructure to hunt or block first.<br><br>Threats are active if their fingerprint has been identified on hosts or web properties by Censys scans. This information is also available on the [Explore Threats page in the Platform web UI](https://platform.censys.io/threats).<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module.
      operationId: v3-threathunting-threats-list
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Optional CenQL filter to constrain threats list
          explode: false
          in: query
          name: query
          schema:
            description: Optional CenQL filter to constrain threats list
            examples:
              - "*"
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeThreatsListResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: List active threats
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: ListThreats
  /v3/threat-hunting/value-counts:
    post:
      description: Get counts of web assets for specific field-value pairs and combinations of field-value pairs. This is similar to the [CensEye functionality](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#/) available in the Platform web UI, but it allows you to define specific fields of interest rather than the [default fields](https://docs.censys.com/docs/platform-threat-hunting-use-censeye-to-build-detections#default-pivot-fields) leveraged by the tool in the UI.<br><br>Each array can only target fields within the same nested object and may contain at most 5 field-value pairs. For example, you can combine `host.services.port=80` and `host.services.protocol=SSH` in the same array, but you cannot combine `host.services.port=80` and `host.location.country="United States"` in the same array. You can input multiple arrays of objects in each API call.<br><br>Use this endpoint to see how many assets share a given field value, so you can tell which attributes are rare enough to pivot on and which are too common to be useful.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module. This endpoint costs 1 credit per count condition (array of objects) included in the API call.
      operationId: v3-threathunting-value-counts
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SearchValueCountsInputBody"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeValueCountsResponse"
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "422":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Invalid input
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: "CensEye: Retrieve value counts to discover pivots"
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-name-override: ValueCounts
  /v3/threat-hunting/web/{webproperty_id}/observations/threats:
    get:
      description: Retrieve historical threat observations for a web property. This endpoint returns time ranges during which threats were detected on the host.<br><br>Use this endpoint to see when a hostname and port was associated with threats, to confirm whether a domain was hosting malicious content at the time of an alert.<br><br>You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.<br><br>You can filter by threat name.<br><br>This endpoint is available to organizations that have access to the Adversary Investigation module.
      operationId: v3-threathunting-threats-on-web
      parameters:
        - description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
          explode: false
          in: query
          name: organization_id
          required: true
          schema:
            description: The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
        - description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
          in: header
          name: X-Organization-ID
          schema:
            description: "The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter."
            examples:
              - 11111111-2222-3333-4444-555555555555
            format: uuid
            type: string
          x-speakeasy-ignore: true
        - description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
          explode: false
          in: query
          name: start_time
          schema:
            description: Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
            examples:
              - "2024-01-01T00:00:00Z"
            type: string
        - description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
          explode: false
          in: query
          name: end_time
          schema:
            description: End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
            examples:
              - "2024-01-31T23:59:59Z"
            type: string
        - description: Number of results per page (max 100)
          explode: false
          in: query
          name: page_size
          schema:
            default: 100
            description: Number of results per page (max 100)
            examples:
              - 50
            format: int32
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination token from previous response
          explode: false
          in: query
          name: page_token
          schema:
            description: Pagination token from previous response
            type: string
        - description: Filter by threat name
          explode: false
          in: query
          name: threat_name
          schema:
            description: Filter by threat name
            examples:
              - Acunetix
            type: string
        - description: A web property identifier in hostname:port format.
          in: path
          name: webproperty_id
          required: true
          schema:
            description: A web property identifier in hostname:port format.
            examples:
              - platform.censys.io:80
            type: string
        - description: Order observations by these fields. Multiple values can be provided to sort by multiple fields (e.g., ['threat_name DESC']).
          explode: false
          in: query
          name: order_by
          schema:
            description: Order observations by these fields. Multiple values can be provided to sort by multiple fields (e.g., ['threat_name DESC']).
            items:
              enum:
                - threat_name ASC
                - threat_name DESC
              type: string
            type:
              - array
              - "null"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseEnvelopeThreatsOnWebResponse"
          description: A list of threat observation ranges
          headers:
            Content-Type:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthenticationError"
          description: Request does not contain a valid Authorization token
        "403":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: User does not have permission to access this data
        "404":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Resource not found
        "409":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Feature not enabled
        "500":
          content:
            application/problem+json:
              schema:
                $ref: "#/components/schemas/ErrorModel"
          description: Internal server error
      security:
        - PersonalAccessToken: []
      summary: Get threat history for a web property
      tags:
        - Threat Hunting
        - Adversary Investigation
      x-speakeasy-ignore: true
      x-speakeasy-name-override: ListThreatsOnWeb
servers:
  - description: The Censys Platform API
    url: https://api.platform.censys.io
tags:
  - description: Endpoints related to the Account Management product
    name: Account Management
  - description: Endpoints related to the Adversary Investigation product
    name: Adversary Investigation
  - description: Endpoints related to the Collections product
    name: Collections
  - description: Endpoints related to the Exposure Management product
    name: Exposure Management
  - description: Endpoints related to the Global Data product
    name: Global Data
  - description: Endpoints related to the Supplier Risk product
    name: Supplier Risk
  - description: Endpoints related to asset tagging and commenting
    name: Tags and Comments
  - description: Endpoints related to the Adversary Investigation product
    name: Threat Hunting
x-readme:
  parameter-ordering:
    - path
    - body
    - query
    - cookie
    - form
    - header
  samples-languages:
    - shell
    - python
    - go
    - javascript
    - java
x-speakeasy-globals:
  parameters:
    - in: query
      name: organization_id
      schema:
        type: string
