> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leen.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List Vulnerabilities

> List all the vulnerabilities for a given connection.

`reachability` and `exploitable` are tri-state: a vulnerability for which the vendor gave no signal carries `null`, and `null` matches neither filter value, so filtering a vendor that never reports the field returns an empty page. Use the `capabilities` block on [List Integration Details](https://docs.leen.dev/api-reference/integration-details/list-integration-details.md#filter-capabilities) to see which integrations populate these filters, and `severity`, `state`, `category`, `port`, `protocol` and `cve`, and which values they emit. `protocol` is matched case-sensitively and vendors differ in case; the block's `notes` say which each emits.


## OpenAPI

````yaml get /vms/vulnerabilities
openapi: 3.1.0
info:
  title: Leen Security API
  version: 0.0.1
servers:
  - description: Production API (US)
    url: https://api.leen.dev/v1
  - description: Production API (EU)
    url: https://api.eu-c1.leen.dev/v1
  - description: Production API (APAC)
    url: https://api.ap-se2.leen.dev/v1
security: []
paths:
  /vms/vulnerabilities:
    get:
      tags:
        - vms
      summary: List Vulnerabilities
      description: List all the vulnerabilities for a given connection.
      operationId: get_vulnerabilities
      parameters:
        - description: >-
            Sort by a field, written as `field`, `field:asc` or `field:desc`.
            Which fields can be sorted on differs per endpoint.
          in: query
          name: sort
          required: false
          schema:
            anyOf:
              - pattern: >-
                  ^severity$|^severity\:asc$|^severity\:desc$|^updated_at$|^updated_at\:asc$|^updated_at\:desc$|^state_updated_at$|^state_updated_at\:asc$|^state_updated_at\:desc$
                type: string
              - type: 'null'
            description: >-
              Sort by a field, written as `field`, `field:asc` or `field:desc`.
              Which fields can be sorted on differs per endpoint.
            title: Sort
        - description: >-
            Datetime filter, only return vulnerabilities where the state was
            updated since this datetime. Example format:
            `2021-01-01T00:00:00+00:00`
          in: query
          name: stateUpdatedSince
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            description: >-
              Datetime filter, only return vulnerabilities where the state was
              updated since this datetime. Example format:
              `2021-01-01T00:00:00+00:00`
            examples:
              - '2021-01-01T00:00:00+00:00'
            title: Stateupdatedsince
        - description: >-
            Datetime filter, only return vulnerabilities where the first seen
            since this datetime. Example format: `2021-01-01T00:00:00+00:00`
          in: query
          name: firstSeenSince
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            description: >-
              Datetime filter, only return vulnerabilities where the first seen
              since this datetime. Example format: `2021-01-01T00:00:00+00:00`
            examples:
              - '2021-01-01T00:00:00+00:00'
            title: Firstseensince
        - description: >-
            Datetime filter, only return vulnerabilities where the last seen
            since this datetime. Example format: `2021-01-01T00:00:00+00:00`
          in: query
          name: lastSeenSince
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            description: >-
              Datetime filter, only return vulnerabilities where the last seen
              since this datetime. Example format: `2021-01-01T00:00:00+00:00`
            examples:
              - '2021-01-01T00:00:00+00:00'
            title: Lastseensince
        - description: Device ID Filter, comma separated
          in: query
          name: deviceId
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Device ID Filter, comma separated
            examples:
              - >-
                123e4567-e89b-12d3-a456-426614174000,
                123e4567-e89b-12d3-a456-426614174001
            title: Deviceid
        - description: Resource ID Filter, comma separated
          in: query
          name: resourceId
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Resource ID Filter, comma separated
            examples:
              - >-
                123e4567-e89b-12d3-a456-426614174000,
                123e4567-e89b-12d3-a456-426614174001
            title: Resourceid
        - description: Vulnerability severity filter, comma separated
          in: query
          name: severity
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Vulnerability severity filter, comma separated
            examples:
              - critical,high
            title: Severity
        - description: Vulnerability state filter, comma separated
          in: query
          name: state
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Vulnerability state filter, comma separated
            examples:
              - open,closed
            title: State
        - description: >-
            Filter by whether the vendor asserts the vulnerability is
            exploitable — a known exploit exists, or it is actively exploited.
            Vulnerabilities where the vendor reported no signal match neither
            `true` nor `false`.
          in: query
          name: exploitable
          required: false
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            description: >-
              Filter by whether the vendor asserts the vulnerability is
              exploitable — a known exploit exists, or it is actively exploited.
              Vulnerabilities where the vendor reported no signal match neither
              `true` nor `false`.
            examples:
              - true
            title: Exploitable
        - description: >-
            Reachability filter, comma separated. One or more of `reachable`,
            `potentially_reachable`, `unreachable`, `unknown` -- matching the
            values this endpoint returns; either case is accepted. `unknown`
            means the vendor analyzed the vulnerability without reaching a
            conclusion; vulnerabilities from vendors with no reachability
            analysis at all are excluded by any value.
          in: query
          name: reachability
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Reachability filter, comma separated. One or more of `reachable`,
              `potentially_reachable`, `unreachable`, `unknown` -- matching the
              values this endpoint returns; either case is accepted. `unknown`
              means the vendor analyzed the vulnerability without reaching a
              conclusion; vulnerabilities from vendors with no reachability
              analysis at all are excluded by any value.
            examples:
              - reachable,potentially_reachable
            title: Reachability
        - description: Port number filter, comma separated
          in: query
          name: port
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Port number filter, comma separated
            examples:
              - 80,443
            title: Port
        - description: Protocol filter, comma separated
          in: query
          name: protocol
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Protocol filter, comma separated
            examples:
              - tcp,udp
            title: Protocol
        - description: Vulnerability category filter, comma separated
          in: query
          name: category
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Vulnerability category filter, comma separated
            examples:
              - web,network
            title: Category
        - description: CVE ID filter, comma separated
          in: query
          name: cve
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: CVE ID filter, comma separated
            examples:
              - CVE-2021-1234,CVE-2021-5678
            title: Cve
        - description: Include device groups in the devices attached to the vulnerability
          in: query
          name: includeDeviceGroups
          required: false
          schema:
            default: false
            description: Include device groups in the devices attached to the vulnerability
            title: Includedevicegroups
            type: boolean
        - description: Device group ID filter, comma separated
          in: query
          name: deviceGroupId
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Device group ID filter, comma separated
            examples:
              - >-
                123e4567-e89b-12d3-a456-426614174002,
                123e4567-e89b-12d3-a456-426614174003
            title: Devicegroupid
        - description: >-
            Vulnerability ID filter, comma separated. Need to be valid UUIDs.
            Max 100 IDs
          in: query
          name: ids
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Vulnerability ID filter, comma separated. Need to be valid UUIDs.
              Max 100 IDs
            examples:
              - >-
                123e4567-e89b-12d3-a456-426614174004,123e4567-e89b-12d3-a456-426614174005
            title: Ids
        - description: >-
            Enable cursor based pagination instead of default offset-based
            pagination
          in: query
          name: enableCursor
          required: false
          schema:
            default: false
            description: >-
              Enable cursor based pagination instead of default offset-based
              pagination
            title: Enablecursor
            type: boolean
        - description: >-
            Only records whose `updated_at` is at or after this time. Leen bumps
            `updated_at` whenever any field on a record changes, so this is the
            filter for an incremental sync: it returns records that are new and
            records that changed, and nothing that has stood still. Example:
            `2021-01-01T00:00:00+00:00`.
          in: query
          name: updatedSince
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            description: >-
              Only records whose `updated_at` is at or after this time. Leen
              bumps `updated_at` whenever any field on a record changes, so this
              is the filter for an incremental sync: it returns records that are
              new and records that changed, and nothing that has stood still.
              Example: `2021-01-01T00:00:00+00:00`.
            examples:
              - '2021-01-01T00:00:00+00:00'
            title: Updatedsince
        - description: >-
            How many records to return per page. The walk is the same either
            way; a larger page means fewer round trips and more memory per
            response.
          in: query
          name: limit
          required: false
          schema:
            default: 100
            description: >-
              How many records to return per page. The walk is the same either
              way; a larger page means fewer round trips and more memory per
              response.
            maximum: 500
            minimum: 1
            title: Limit
            type: integer
        - description: >-
            Where to start, counted in records. Offset paging is stable only
            while the underlying data is; prefer the cursor for anything
            long-running.
          in: query
          name: offset
          required: false
          schema:
            default: 0
            description: >-
              Where to start, counted in records. Offset paging is stable only
              while the underlying data is; prefer the cursor for anything
              long-running.
            minimum: 0
            title: Offset
            type: integer
        - description: >-
            Skip counting the total. Counting is the expensive half of a large
            query, so set this when you are walking every page anyway and never
            read `total`. `total` comes back null.
          in: query
          name: excludeTotal
          required: false
          schema:
            default: false
            description: >-
              Skip counting the total. Counting is the expensive half of a large
              query, so set this when you are walking every page anyway and
              never read `total`. `total` comes back null.
            title: Excludetotal
            type: boolean
        - description: >-
            Opaque position of the next page, taken from the previous response.
            Ignore its contents; it encodes where the walk had reached.
          in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Opaque position of the next page, taken from the previous
              response. Ignore its contents; it encodes where the walk had
              reached.
            title: Cursor
      responses:
        '200':
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: >-
                      #/components/schemas/OffsetPaginatedResponse_VulnerabilityRespModel_
                  - $ref: >-
                      #/components/schemas/KeySetPaginatedResponse_VulnerabilityRespModel_
                title: Response Get Vulnerabilities
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Content
      security:
        - API-Key: []
          Connection-ID: []
components:
  schemas:
    OffsetPaginatedResponse_VulnerabilityRespModel_:
      properties:
        count:
          description: Number of items return in the response
          title: Count
          type: integer
        items:
          description: The records on this page.
          items:
            $ref: '#/components/schemas/VulnerabilityRespModel'
          title: Items
          type: array
        total:
          anyOf:
            - type: integer
            - type: 'null'
          description: Total number of items that can be returned
          title: Total
      required:
        - count
        - items
      title: OffsetPaginatedResponse[VulnerabilityRespModel]
      type: object
    KeySetPaginatedResponse_VulnerabilityRespModel_:
      properties:
        items:
          description: The records on this page.
          items:
            $ref: '#/components/schemas/VulnerabilityRespModel'
          title: Items
          type: array
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Opaque position of the next page. Pass it back as `cursor` to
            continue; null when this is the last page.
          title: Next Cursor
        previous_cursor:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Opaque position of the previous page, for walking backwards. Null on
            the first page.
          title: Previous Cursor
      required:
        - items
      title: KeySetPaginatedResponse[VulnerabilityRespModel]
      type: object
    ErrorResponse:
      properties:
        code:
          description: Error code
          title: Code
          type: string
        detail:
          description: List of error dictionaries
          items:
            additionalProperties: true
            type: object
          title: Detail
          type: array
        message:
          description: Error message
          title: Message
          type: string
        type:
          description: Type of error
          title: Type
          type: string
      required:
        - type
        - code
        - message
        - detail
      title: ErrorResponse
      type: object
    VulnerabilityRespModel:
      properties:
        category:
          anyOf:
            - $ref: '#/components/schemas/VulnerabilityCategory'
            - type: 'null'
          description: Vulnerability category
        cert_id:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Corresponds to an identifier in the vulnerability database provided
            by the US Computer Emergency Readiness Team (US-CERT)
          title: Cert Id
        cve:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: List of CVEs associated with the vulnerability
          title: Cve
        cvss_base_score:
          anyOf:
            - type: number
            - type: 'null'
          description: CVSS base score
          title: Cvss Base Score
        cvss_temporal_score:
          anyOf:
            - type: number
            - type: 'null'
          description: CVSS temporal score
          title: Cvss Temporal Score
        cvss_temporal_vector:
          anyOf:
            - type: string
            - type: 'null'
          description: CVSS temporal vector
          title: Cvss Temporal Vector
        cvss_vector:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            CVSS vector uses cvss3 when available, provided by the upstream
            vendor
          title: Cvss Vector
        cvss_version:
          anyOf:
            - type: string
            - type: 'null'
          description: CVSS version
          title: Cvss Version
        description:
          description: Description of vulnerability, provided by the upstream vendor
          title: Description
          type: string
        device:
          anyOf:
            - $ref: '#/components/schemas/DeviceRespModel'
            - $ref: '#/components/schemas/DeviceWithGroupsRespModel'
            - type: 'null'
          description: >-
            Device attached to the vulnerability, include device groups with
            includeDeviceGroups query parameter
          title: Device
        exploitable:
          anyOf:
            - type: boolean
            - type: 'null'
          description: >-
            Whether the vendor asserts this vulnerability is exploitable. `null`
            means the vendor provided no signal, which is not the same as
            `false`.
          title: Exploitable
        first_seen:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: First detection date
          title: First Seen
        id:
          description: Leen's UUID for the vulnerability
          format: uuid
          title: Id
          type: string
        last_seen:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: Last detection date
          title: Last Seen
        name:
          description: Name of vulnerability, provided by the upstream vendor
          title: Name
          type: string
        patchable:
          anyOf:
            - type: boolean
            - type: 'null'
          description: A patch is available
          title: Patchable
        port:
          anyOf:
            - type: integer
            - type: 'null'
          description: Port number of the vulnerability that was detected
          title: Port
        protocol:
          anyOf:
            - type: string
            - type: 'null'
          description: 'Protocol of the vulnerability that was detected, example: tcp'
          title: Protocol
        reachability:
          anyOf:
            - $ref: '#/components/schemas/VulnerabilityReachability'
            - type: 'null'
          description: >-
            Whether the vulnerable code is actually reached in the scanned
            target. One of `reachable`, `potentially_reachable`, `unreachable`,
            `unknown`. `null` means the vendor performs no reachability
            analysis; `unknown` means it ran but reached no conclusion.
        resource:
          anyOf:
            - $ref: '#/components/schemas/ResourceRespModel'
            - type: 'null'
          description: Resource attached to the vulnerability
        scan_output:
          anyOf:
            - type: string
            - type: 'null'
          description: Scan output that was provided when detected on the device
          title: Scan Output
        service:
          anyOf:
            - type: string
            - type: 'null'
          description: 'Service of the vulnerability that was detected, example: http'
          title: Service
        severity:
          $ref: '#/components/schemas/VulnerabilitySeverity'
          default: none
        solution:
          anyOf:
            - type: string
            - type: 'null'
          description: Solution for the vulnerability, provided by upstream vendor
          title: Solution
        state:
          $ref: '#/components/schemas/VulnerabilityState'
          default: open
        state_updated_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: The last time the state was updated
          title: State Updated At
        updated_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: The last time the vulnerability was updated
          title: Updated At
        vendor:
          $ref: '#/components/schemas/VulnerabilityVendor'
          description: Source vendor
        vendor_data:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Vendor specific pass through data, values can vary based on vendor
          title: Vendor Data
        vendor_id:
          anyOf:
            - type: string
            - type: 'null'
          description: Vendor's ID of the vulnerability
          title: Vendor Id
        vendor_scan_id:
          anyOf:
            - type: string
            - type: 'null'
          description: 'Vendor''s ID of the scan that detected the '
          title: Vendor Scan Id
        vendor_severity:
          anyOf:
            - type: string
            - type: 'null'
          description: Passthrough value of severity
          title: Vendor Severity
        vulnerability_url:
          anyOf:
            - type: string
            - type: 'null'
          description: URL to the vulnerability details, provided by the upstream vendor
          title: Vulnerability Url
      required:
        - id
        - name
        - description
        - scan_output
        - cve
        - cvss_version
        - cvss_base_score
        - cvss_vector
        - cvss_temporal_score
        - cvss_temporal_vector
        - cert_id
        - port
        - protocol
        - service
        - first_seen
        - last_seen
        - updated_at
        - state_updated_at
        - patchable
        - solution
        - category
        - vendor
        - vendor_id
        - vendor_severity
        - vendor_scan_id
      title: Vulnerability
      type: object
    VulnerabilityCategory:
      enum:
        - web
        - network
        - database
        - application
        - os
        - other
        - general
        - attack_vector
      title: VulnerabilityCategory
      type: string
    DeviceRespModel:
      properties:
        ad_info:
          anyOf:
            - $ref: '#/components/schemas/DeviceADInfo'
            - type: 'null'
          description: >-
            Active Directory placement -- organisational unit and site -- where
            the tool reports it.
        cloud_metadata:
          anyOf:
            - $ref: '#/components/schemas/AWSMetadata'
            - type: 'null'
          description: CloudMetadata, currently only AWS is supported
        first_seen:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            When the tool first registered this device. The tool's own
            timestamp, not when Leen synced it.
          title: First Seen
        fqdns:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Fully qualified domain names for this device.
          title: Fqdns
        hostnames:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Hostnames the tool knows this device by. A device can have several.
          title: Hostnames
        id:
          description: Leen's identifier for this device.
          format: uuid
          title: Id
          type: string
        identities:
          anyOf:
            - items:
                $ref: '#/components/schemas/DeviceIdentity'
              type: array
            - type: 'null'
          description: >-
            Accounts associated with the device, such as its last logged-in
            user.
          title: Identities
        installed_software:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Software the tool reported as installed.
          title: Installed Software
        ipv4s:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: IPv4 addresses the tool last observed. Not necessarily current.
          title: Ipv4S
        ipv6s:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: IPv6 addresses the tool last observed.
          title: Ipv6S
        last_seen:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            When the tool last had contact with the device. Use it to tell a
            decommissioned machine from one that simply has no findings.
          title: Last Seen
        mac_addresses:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: MAC addresses of the device's interfaces.
          title: Mac Addresses
        os_major_version:
          anyOf:
            - type: string
            - type: 'null'
          description: Major version, split out of `os_version` so it can be filtered on.
          title: Os Major Version
        os_minor_version:
          anyOf:
            - type: string
            - type: 'null'
          description: Minor version, split out of `os_version`.
          title: Os Minor Version
        os_version:
          anyOf:
            - type: string
            - type: 'null'
          description: Full operating system version string, as the tool reports it.
          title: Os Version
        platform:
          anyOf:
            - $ref: '#/components/schemas/DevicePlatform'
            - type: 'null'
          description: Operating system family, normalised across tools.
        source_vendors:
          description: >-
            The tool this device came from, and that tool's identifier for it. A
            list because the shape allows several; today a device carries
            exactly one.
          items:
            $ref: '#/components/schemas/DeviceVendor'
          title: Source Vendors
          type: array
        status:
          $ref: '#/components/schemas/DeviceStatus'
          description: >-
            Device state as the tool reports it. `quarantined` means the tool
            has isolated it; `deleted` means the tool no longer returns it.
        tags:
          anyOf:
            - items:
                $ref: '#/components/schemas/DeviceTags'
              type: array
            - type: 'null'
          description: Tags the tool carries for this device.
          title: Tags
        vendor_data:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Vendor specific pass through data, values can vary based on vendor
          title: Vendor Data
      required:
        - id
        - status
        - last_seen
        - first_seen
        - source_vendors
        - installed_software
        - ad_info
      title: Device
      type: object
    DeviceWithGroupsRespModel:
      properties:
        ad_info:
          anyOf:
            - $ref: '#/components/schemas/DeviceADInfo'
            - type: 'null'
          description: >-
            Active Directory placement -- organisational unit and site -- where
            the tool reports it.
        cloud_metadata:
          anyOf:
            - $ref: '#/components/schemas/AWSMetadata'
            - type: 'null'
          description: CloudMetadata, currently only AWS is supported
        device_groups:
          default: []
          description: >-
            Pass in the includeDeviceGroups query parameter to include device
            group information.
          items:
            $ref: '#/components/schemas/DeviceGroupsBase'
          title: Device Groups
          type: array
        first_seen:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            When the tool first registered this device. The tool's own
            timestamp, not when Leen synced it.
          title: First Seen
        fqdns:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Fully qualified domain names for this device.
          title: Fqdns
        hostnames:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Hostnames the tool knows this device by. A device can have several.
          title: Hostnames
        id:
          description: Leen's identifier for this device.
          format: uuid
          title: Id
          type: string
        identities:
          anyOf:
            - items:
                $ref: '#/components/schemas/DeviceIdentity'
              type: array
            - type: 'null'
          description: >-
            Accounts associated with the device, such as its last logged-in
            user.
          title: Identities
        installed_software:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Software the tool reported as installed.
          title: Installed Software
        ipv4s:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: IPv4 addresses the tool last observed. Not necessarily current.
          title: Ipv4S
        ipv6s:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: IPv6 addresses the tool last observed.
          title: Ipv6S
        last_seen:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            When the tool last had contact with the device. Use it to tell a
            decommissioned machine from one that simply has no findings.
          title: Last Seen
        mac_addresses:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: MAC addresses of the device's interfaces.
          title: Mac Addresses
        os_major_version:
          anyOf:
            - type: string
            - type: 'null'
          description: Major version, split out of `os_version` so it can be filtered on.
          title: Os Major Version
        os_minor_version:
          anyOf:
            - type: string
            - type: 'null'
          description: Minor version, split out of `os_version`.
          title: Os Minor Version
        os_version:
          anyOf:
            - type: string
            - type: 'null'
          description: Full operating system version string, as the tool reports it.
          title: Os Version
        platform:
          anyOf:
            - $ref: '#/components/schemas/DevicePlatform'
            - type: 'null'
          description: Operating system family, normalised across tools.
        source_vendors:
          description: >-
            The tool this device came from, and that tool's identifier for it. A
            list because the shape allows several; today a device carries
            exactly one.
          items:
            $ref: '#/components/schemas/DeviceVendor'
          title: Source Vendors
          type: array
        status:
          $ref: '#/components/schemas/DeviceStatus'
          description: >-
            Device state as the tool reports it. `quarantined` means the tool
            has isolated it; `deleted` means the tool no longer returns it.
        tags:
          anyOf:
            - items:
                $ref: '#/components/schemas/DeviceTags'
              type: array
            - type: 'null'
          description: Tags the tool carries for this device.
          title: Tags
        vendor_data:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Vendor specific pass through data, values can vary based on vendor
          title: Vendor Data
      required:
        - id
        - status
        - last_seen
        - first_seen
        - source_vendors
        - installed_software
        - ad_info
      title: DeviceWithGroups
      type: object
    VulnerabilityReachability:
      description: >-
        Reachability as this API surface renders it.


        Lowercase values, like every other enum in this module: the VMS v1
        response

        has always emitted `"state": "open"` / `"severity": "high"`, and a
        single

        uppercase field would be an odd one out for clients parsing it. The
        stored

        vocabulary is uppercase, so both read paths convert by member name.


        Filters stay case-insensitive --
        `VulnerabilityFilters.uppercase_reachability`

        normalizes before validating -- so `?reachability=reachable` and

        `?reachability=REACHABLE` both work.
      enum:
        - reachable
        - potentially_reachable
        - unreachable
        - unknown
      title: VulnerabilityReachability
      type: string
    ResourceRespModel:
      description: Response model for returning resource details via an API endpoint.
      properties:
        cloud_metadata:
          anyOf:
            - $ref: '#/components/schemas/ResourceCloudMetadata'
            - type: 'null'
          description: Cloud metadata for the resource
        data:
          anyOf:
            - $ref: '#/components/schemas/ResourceContainer'
            - $ref: '#/components/schemas/ResourceHost'
            - $ref: '#/components/schemas/ResourceImage'
            - $ref: '#/components/schemas/ResourceBranch'
            - type: 'null'
          description: Additional data or properties about the resource
          title: Data
        first_seen:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: Timestamp when the resource was first seen
          title: First Seen
        groups:
          anyOf:
            - items:
                $ref: '#/components/schemas/ResourceGroup'
              type: array
            - type: 'null'
          description: Groups associated with the resource
          title: Groups
        id:
          description: Leen's UUID for the resource
          format: uuid
          title: Id
          type: string
        last_seen:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: Timestamp when the resource was last seen
          title: Last Seen
        name:
          description: Resource name
          title: Name
          type: string
        state:
          $ref: '#/components/schemas/ResourceStateEnum'
          description: State of the resource
        tags:
          anyOf:
            - items:
                $ref: '#/components/schemas/ResourceTag'
              type: array
            - type: 'null'
          description: List of arbitrary tags/metadata for the resource
          title: Tags
        type:
          $ref: '#/components/schemas/ResourceTypeEnum'
          description: Type of the resource
        url:
          anyOf:
            - type: string
            - type: 'null'
          description: URL associated with the resource
          title: Url
        vendor:
          description: The source vendor of the resource
          title: Vendor
          type: string
        vendor_attributes:
          $ref: '#/components/schemas/ResourceVendorAttributes'
          description: Vendor-specific attributes like IDs
      required:
        - id
        - name
        - type
        - state
        - vendor
        - vendor_attributes
      title: Resource
      type: object
    VulnerabilitySeverity:
      enum:
        - critical
        - high
        - medium
        - low
        - info
        - none
      title: VulnerabilitySeverity
      type: string
    VulnerabilityState:
      enum:
        - open
        - closed
        - reopened
        - ignored
        - deleted
      title: VulnerabilityState
      type: string
    VulnerabilityVendor:
      enum:
        - tenable
        - qualys
        - snyk
        - insightvm
        - crowdstrike_spotlight
        - sentinelone_vms
        - MS_DEFENDER_VMS
        - WIZ_VMS
        - AWS_INSPECTOR2
      title: VulnerabilityVendor
      type: string
    DeviceADInfo:
      properties:
        device_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Device Id
        domain:
          anyOf:
            - type: string
            - type: 'null'
          title: Domain
        org_unit:
          anyOf:
            - type: string
            - type: 'null'
          title: Org Unit
        site_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Site Name
      title: DeviceADInfo
      type: object
    AWSMetadata:
      properties:
        account_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Id
        availability_zone:
          anyOf:
            - type: string
            - type: 'null'
          title: Availability Zone
        cloud_provider:
          $ref: '#/components/schemas/CloudProvider'
          default: aws
        image_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Image Id
        instance_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Instance Id
        instance_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Instance Type
        kernel_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Kernel Id
        region:
          anyOf:
            - type: string
            - type: 'null'
          title: Region
        subnet_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Subnet Id
        vpc_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Vpc Id
      title: AWSMetadata
      type: object
    DeviceIdentity:
      properties:
        user_sid:
          anyOf:
            - type: string
            - type: 'null'
          title: User Sid
        username:
          title: Username
          type: string
      required:
        - username
      title: DeviceIdentity
      type: object
    DevicePlatform:
      enum:
        - mac
        - windows
        - linux
        - unknown
      title: DevicePlatform
      type: string
    DeviceVendor:
      properties:
        agent_info:
          anyOf:
            - $ref: '#/components/schemas/DeviceAgentInfo'
            - type: 'null'
        vendor:
          title: Vendor
          type: string
        vendor_id:
          title: Vendor Id
          type: string
      required:
        - vendor
        - vendor_id
      title: DeviceVendor
      type: object
    DeviceStatus:
      enum:
        - active
        - offline
        - quarantined
        - unknown
        - deleted
      title: DeviceStatus
      type: string
    DeviceTags:
      properties:
        key:
          title: Key
          type: string
        source:
          $ref: '#/components/schemas/DeviceTagSource'
        value:
          title: Value
          type: string
      required:
        - key
        - value
        - source
      title: DeviceTags
      type: object
    DeviceGroupsBase:
      properties:
        created_by:
          anyOf:
            - type: string
            - type: 'null'
          description: Who created the group in the tool.
          title: Created By
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: Group description, where the tool has one.
          title: Description
        id:
          description: Leen's identifier for this group.
          format: uuid
          title: Id
          type: string
        name:
          description: Group name, as the tool names it.
          title: Name
          type: string
        vendor:
          description: Connector that produced this group.
          title: Vendor
          type: string
        vendor_created_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: When the group was created in the tool, where the tool reports it.
          title: Vendor Created At
        vendor_data:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Vendor specific pass through data, values can vary based on vendor
          title: Vendor Data
        vendor_id:
          description: The tool's own identifier for the group.
          title: Vendor Id
          type: string
      required:
        - id
        - name
        - vendor_id
        - vendor
      title: DeviceGroupsBase
      type: object
    ResourceCloudMetadata:
      description: ORM model representing cloud metadata in a resource.
      properties:
        account_id:
          anyOf:
            - type: string
            - type: 'null'
          description: Cloud account identifier
          title: Account Id
        account_name:
          anyOf:
            - type: string
            - type: 'null'
          description: Cloud account name
          title: Account Name
        cloud_provider:
          anyOf:
            - type: string
            - type: 'null'
          description: Cloud service provider
          title: Cloud Provider
        image_id:
          anyOf:
            - type: string
            - type: 'null'
          description: Cloud image identifier
          title: Image Id
        instance_id:
          anyOf:
            - type: string
            - type: 'null'
          description: Cloud instance identifier
          title: Instance Id
        instance_type:
          anyOf:
            - type: string
            - type: 'null'
          description: Type of cloud instance
          title: Instance Type
        region:
          anyOf:
            - type: string
            - type: 'null'
          description: Cloud region
          title: Region
        subnet_id:
          anyOf:
            - type: string
            - type: 'null'
          description: Cloud subnet identifier
          title: Subnet Id
        vpc_id:
          anyOf:
            - type: string
            - type: 'null'
          description: Cloud VPC identifier
          title: Vpc Id
      title: ResourceCloudMetadata
      type: object
    ResourceContainer:
      description: ORM model representing a container in a resource.
      properties:
        hostnames:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: List of hostnames for the container
          title: Hostnames
        image:
          anyOf:
            - type: string
            - type: 'null'
          description: Container image identifier
          title: Image
      title: ResourceContainer
      type: object
    ResourceHost:
      description: ORM model representing a host in a resource.
      properties:
        ad_device_id:
          anyOf:
            - type: string
            - type: 'null'
          description: Active Directory device ID
          title: Ad Device Id
        ad_domain:
          anyOf:
            - type: string
            - type: 'null'
          description: Active Directory domain
          title: Ad Domain
        ad_org_unit:
          anyOf:
            - type: string
            - type: 'null'
          description: Active Directory organizational unit
          title: Ad Org Unit
        ad_site_name:
          anyOf:
            - type: string
            - type: 'null'
          description: Active Directory site name
          title: Ad Site Name
        agents:
          anyOf:
            - items:
                $ref: '#/components/schemas/ResourceHostAgent'
              type: array
            - type: 'null'
          description: Agent information for the host
          title: Agents
        deleted_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: When the host was deleted
          title: Deleted At
        fqdns:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Fully qualified domain names of the host
          title: Fqdns
        hostnames:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: List of hostnames for the host
          title: Hostnames
        image:
          anyOf:
            - type: string
            - type: 'null'
          description: Host image identifier
          title: Image
        installed_software:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Installed software on the host
          title: Installed Software
        ipv4s:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: IPv4 addresses associated with the host
          title: Ipv4S
        ipv6s:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: IPv6 addresses associated with the host
          title: Ipv6S
        is_deleted:
          anyOf:
            - type: boolean
            - type: 'null'
          description: Whether the host is deleted
          title: Is Deleted
        mac_addresses:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: MAC addresses associated with the host
          title: Mac Addresses
        os_major_version:
          anyOf:
            - type: integer
            - type: 'null'
          description: Major version of the host's operating system
          title: Os Major Version
        os_minor_version:
          anyOf:
            - type: integer
            - type: 'null'
          description: Minor version of the host's operating system
          title: Os Minor Version
        os_version:
          anyOf:
            - type: string
            - type: 'null'
          description: Full operating system version of the host
          title: Os Version
        platform:
          anyOf:
            - $ref: '#/components/schemas/ResourcePlatformEnum'
            - type: 'null'
          description: Platform on which the host is running
      title: ResourceHost
      type: object
    ResourceImage:
      description: ORM model representing an image in a resource.
      properties:
        hash:
          anyOf:
            - $ref: '#/components/schemas/ResourceHash'
            - type: 'null'
          description: Image hash
        labels:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Image labels
          title: Labels
      title: ResourceImage
      type: object
    ResourceBranch:
      description: ORM model representing a branch in a resource.
      properties:
        code_repo:
          anyOf:
            - type: string
            - type: 'null'
          description: Code repository name
          title: Code Repo
        repo_branch_name:
          anyOf:
            - type: string
            - type: 'null'
          description: Repository branch name
          title: Repo Branch Name
      title: ResourceBranch
      type: object
    ResourceGroup:
      description: ORM model representing a groups in a resource.
      properties:
        name:
          description: The name of the group.
          title: Name
          type: string
        uid:
          description: The unique identifier of the group.
          title: Uid
          type: string
      required:
        - name
        - uid
      title: ResourceGroup
      type: object
    ResourceStateEnum:
      enum:
        - ACTIVE
        - IGNORED
        - DELETED
        - INACTIVE
        - QUARANTINED
        - UNKNOWN
      title: ResourceStateEnum
      type: string
    ResourceTag:
      properties:
        key:
          title: Key
          type: string
        source:
          $ref: '#/components/schemas/ResourceTagSourceEnum'
        value:
          title: Value
          type: string
      required:
        - key
        - value
        - source
      title: ResourceTag
      type: object
    ResourceTypeEnum:
      description: Enumeration for resource types.
      enum:
        - BRANCH
        - HOST
        - CONTAINER
        - DEPENDENCY
        - IMAGE
        - REPOSITORY
        - VENDOR
        - KUBERNETES
        - UNKNOWN
      title: ResourceTypeEnum
      type: string
    ResourceVendorAttributes:
      properties:
        data:
          anyOf:
            - $ref: '#/components/schemas/QualysDeviceVendorData'
            - $ref: '#/components/schemas/TenableDeviceVendorData'
            - $ref: '#/components/schemas/OrcaResourceVendorAttributesData'
            - $ref: '#/components/schemas/UpwindResourceVendorAttributesData'
            - $ref: '#/components/schemas/CheckmarxResourceVendorAttributesData'
            - $ref: '#/components/schemas/SocketResourceVendorAttributesData'
            - type: 'null'
          description: Vendor specific data
          title: Data
        id:
          description: Vendor specific ID
          title: Id
          type: string
      required:
        - id
      title: ResourceVendorAttributes
      type: object
    CloudProvider:
      enum:
        - aws
      title: CloudProvider
      type: string
    DeviceAgentInfo:
      properties:
        agent_version:
          anyOf:
            - type: string
            - type: 'null'
          title: Agent Version
        policies:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Policies
        signature_version:
          anyOf:
            - type: string
            - type: 'null'
          title: Signature Version
      title: DeviceAgentInfo
      type: object
    DeviceTagSource:
      enum:
        - aws
        - qualys
        - wiz_vms
        - insight_vm
      title: DeviceTagSource
      type: string
    ResourceHostAgent:
      description: ORM model representing agent information in a resource.
      properties:
        product:
          description: Product name of the agent
          title: Product
          type: string
        signature_version:
          anyOf:
            - type: string
            - type: 'null'
          description: Signature version of the agent, usually related to EDR agents
          title: Signature Version
        vendor:
          description: Vendor of the agent
          title: Vendor
          type: string
        vendor_attributes:
          anyOf:
            - $ref: '#/components/schemas/ResourceHostAgentVendorAttributes'
            - type: 'null'
          description: Vendor-specific attributes of the agent
        version:
          anyOf:
            - type: string
            - type: 'null'
          description: Version of the agent
          title: Version
      required:
        - vendor
        - product
      title: ResourceHostAgent
      type: object
    ResourcePlatformEnum:
      description: Enumeration for resource platforms.
      enum:
        - WINDOWS
        - LINUX
        - MAC
        - UNKNOWN
      title: ResourcePlatformEnum
      type: string
    ResourceHash:
      properties:
        algorithm:
          anyOf:
            - type: string
            - type: 'null'
          title: Algorithm
        value:
          anyOf:
            - type: string
            - type: 'null'
          title: Value
      title: ResourceHash
      type: object
    ResourceTagSourceEnum:
      description: >-
        Which integration contributed a resource tag.


        Named rather than an inline ``Literal`` so the OpenAPI document carries
        a reusable

        ``ResourceTagSourceEnum`` component. An inline literal generates an
        anonymous,

        differently-named enum type in every SDK language.
      enum:
        - wiz_vms
        - gitlab
        - checkmarx
        - mend
        - qualys
        - aws
        - insight_vm
        - orca
        - blackkite
      title: ResourceTagSourceEnum
      type: string
    QualysDeviceVendorData:
      properties:
        asset_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Asset Id
        host_id:
          title: Host Id
          type: string
        tracking_method:
          anyOf:
            - type: string
            - type: 'null'
          title: Tracking Method
        vendor:
          const: qualys
          title: Vendor
          type: string
      required:
        - vendor
        - host_id
      title: QualysDeviceVendorData
      type: object
    TenableDeviceVendorData:
      properties:
        first_seen:
          anyOf:
            - type: string
            - type: 'null'
          title: First Seen
        is_licensed:
          title: Is Licensed
          type: boolean
        last_seen:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Seen
        operating_systems:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Operating Systems
        vendor:
          const: tenable
          default: tenable
          title: Vendor
          type: string
      required:
        - is_licensed
      title: TenableDeviceVendorData
      type: object
    OrcaResourceVendorAttributesData:
      properties:
        category:
          title: Category
          type: string
        subcategory:
          title: Subcategory
          type: string
        type:
          title: Type
          type: string
        vendor:
          const: ORCA
          default: ORCA
          title: Vendor
          type: string
      required:
        - category
        - subcategory
        - type
      title: OrcaResourceVendorAttributesData
      type: object
    UpwindResourceVendorAttributesData:
      properties:
        type:
          title: Type
          type: string
        vendor:
          const: UPWIND
          default: UPWIND
          title: Vendor
          type: string
      required:
        - type
      title: UpwindResourceVendorAttributesData
      type: object
    CheckmarxResourceVendorAttributesData:
      properties:
        repo_url_inferred:
          title: Repo Url Inferred
          type: boolean
        vendor:
          const: CHECKMARX
          default: CHECKMARX
          title: Vendor
          type: string
      required:
        - repo_url_inferred
      title: CheckmarxResourceVendorAttributesData
      type: object
    SocketResourceVendorAttributesData:
      properties:
        default_branch:
          anyOf:
            - type: string
            - type: 'null'
          title: Default Branch
        slug:
          title: Slug
          type: string
        vendor:
          const: SOCKET
          default: SOCKET
          title: Vendor
          type: string
        workspace:
          anyOf:
            - type: string
            - type: 'null'
          title: Workspace
      required:
        - slug
      title: SocketResourceVendorAttributesData
      type: object
    ResourceHostAgentVendorAttributes:
      properties:
        id:
          anyOf:
            - type: string
            - type: 'null'
          description: Vendor ID of the agent
          title: Id
        policies:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Policies associated with the agent
          title: Policies
      title: ResourceHostAgentVendorAttributes
      type: object
  securitySchemes:
    API-Key:
      in: header
      name: X-API-KEY
      type: apiKey
    Connection-ID:
      in: header
      name: X-CONNECTION-ID
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.