CybelAngel ADM Inventory API

Manipulate ADM inventory assets and threats.

Operations 10

GET /v1/inventory/assets Get inventory assets #
GET /v1/inventory/assets/hostnames Get inventory assets hostnames #
GET /v1/inventory/assets/threats Get inventory threats with asset info #
PUT /v1/inventory/assets/status Update inventory assets status #
PUT /v1/inventory/assets/threats/status Update inventory assets threats status #
GET /v1/{organization_id}/inventory/assets Get Organization Inventory Assets #
GET /v1/{organization_id}/inventory/assets/hostnames Get Organization Inventory Assets Hostnames #
GET /v1/{organization_id}/inventory/assets/threats Get Organization Inventory Threats with Asset info #
PUT /v1/{organization_id}/inventory/assets/status Update Organization Inventory Assets Status #
PUT /v1/{organization_id}/inventory/assets/threats/status Update Organization Inventory Assets Threats Status #

Documentation

📖
Documentation
https://developers.cybelangel.com/docs/cybelangel-platform-api/39d4926befc14-what-can-i-do-with-this-api
📖
APIReference
https://developers.cybelangel.com/docs/cybelangel-platform-api/68a341c676710-references
📖
GettingStarted
https://developers.cybelangel.com/docs/cybelangel-platform-api/05d245301ecc5-get-your-api-credentials
📖
Authentication
https://developers.cybelangel.com/docs/cybelangel-platform-api/b6b6c2d4906e9-authentication
📖
Documentation
https://developers.cybelangel.com/docs/alerts-api/72b66de24898e-cybel-angel-alerts-api-real-time-threat-intelligence
📖
APIReference
https://developers.cybelangel.com/docs/alerts-api/a3ab024122156-search-alerts
📖
GettingStarted
https://developers.cybelangel.com/docs/alerts-api/c53add3c8b16f-getting-started
📖
RateLimits
https://developers.cybelangel.com/docs/alerts-api/304dab003eb13-limitations
📖
Documentation
https://developers.cybelangel.com/docs/adm-inventory-api/7e88d945427a4-fetch-assets-details-from-adm-inventory
📖
Documentation
https://developers.cybelangel.com/docs/keywords-api/c812fc6b544b0-manipulate-your-keywords
📖
Documentation
https://developers.cybelangel.com/docs/threat-intelligence-api/38e63ab3d5c42-fetch-threat-intelligence-claimed-attacks
📖
Documentation
https://developers.cybelangel.com/docs/audit-logs-api/72b66de24898e-cybel-angel-audit-logs-api
📖
GettingStarted
https://developers.cybelangel.com/docs/audit-logs-api/f9723159f94ff-getting-started-guide-audit-logs-api
📖
Authentication
https://developers.cybelangel.com/docs/audit-logs-api/b87d37ae48a0d-authentication
📖
Documentation
https://developers.cybelangel.com/docs/partner-api/72b66de24898e-cybel-angel-partners-api

Specifications

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/cybelangel-adm-inventory-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cybelangel-adm-inventory-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Cybelangel ADM Inventory API
  version: 1.0.0
  contact:
    email: support@cybelangel.com
  license:
    url: https://cybelangel.com/
    name: Proprietary
  description: 'Operations tagged ADM Inventory across 2 of this provider''s published API definitions: cybelangel-adm-inventory-openapi.yml, cybelangel-partner-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.cybelangel.com
tags:
- name: ADM Inventory
  description: Manipulate ADM inventory assets and threats.
paths:
  /v1/inventory/assets:
    get:
      tags:
      - ADM Inventory
      summary: Get inventory assets
      description: 'Get all inventory assets. Results are sorted by `created_at` (descending) and alphabetical order of `value`.<br/>You can filter assets by either `values` or `ids` parameters, but not both at the same time.<br/><br/>**Recommendation**: Inventory data is refreshed every 8 hours.<br/>We recommend aligning the frequency of your queries with this update interval for optimal results and performance.<br/>⚠️ **Asset Discovery and Monitoring module is required.**'
      operationId: get-inventory-assets
      parameters:
      - name: cursor
        in: query
        description: Cursor returned by a previous call to this endpoint. If it is not set, you will get the first page.
        required: false
        schema:
          type: string
          title: Cursor
          description: Cursor returned by a previous call to this endpoint. If it is not set, you will get the first page.
          minLength: 1
      - name: values
        in: query
        description: To get details for specific asset(s). Cannot be used together with 'ids' parameter.
        required: false
        schema:
          type: array
          title: Values
          description: To get details for specific asset(s). Cannot be used together with 'ids' parameter.
          items:
            type: string
            minLength: 1
      - name: ids
        in: query
        description: List of asset IDs (UUIDs). Cannot be used together with 'values' parameter.
        required: false
        schema:
          type: array
          title: Ids
          description: List of asset IDs (UUIDs). Cannot be used together with 'values' parameter.
          items:
            type: string
            format: uuid
      - name: status
        in: query
        description: '[Deprecated] Filter on the status on an asset (This query param will be removed on September 4 2026, use `asset_status` instead)'
        required: false
        deprecated: true
        schema:
          type: array
          title: Status
          description: '[Deprecated] Filter on the status on an asset (This query param will be removed on September 4 2026, use `asset_status` instead)'
          items:
            $ref: '#/components/schemas/PreviousAssetStatus'
          x-deprecated: true
      - name: asset_status
        in: query
        description: Filter on the status on an asset
        required: false
        schema:
          type: array
          title: Asset Status
          description: Filter on the status on an asset
          items:
            $ref: '#/components/schemas/AssetStatus'
      - name: first_seen_at_start_date
        in: query
        description: Filter assets based on when we detected the asset for the first time in our system (greater than this date)
        required: false
        schema:
          type: string
          title: First Seen At Start Date
          description: Filter assets based on when we detected the asset for the first time in our system (greater than this date)
          format: date-time
          examples:
          - '2023-10-05T14:48:00.000Z'
        examples:
          default:
            value: '2023-10-05T14:48:00.000Z'
      - name: first_seen_at_end_date
        in: query
        description: Filter assets based on when we detected the asset for the first time in our system (less than this date)
        required: false
        schema:
          type: string
          title: First Seen At End Date
          description: Filter assets based on when we detected the asset for the first time in our system (less than this date)
          format: date-time
          examples:
          - '2023-10-05T14:48:00.000Z'
        examples:
          default:
            value: '2023-10-05T14:48:00.000Z'
      - name: last_seen_at_start_date
        in: query
        description: Filter assets based on when we detected the asset for the last time in our system (greater than this date)
        required: false
        schema:
          type: string
          title: Last Seen At Start Date
          description: Filter assets based on when we detected the asset for the last time in our system (greater than this date)
          format: date-time
          examples:
          - '2023-10-05T14:48:00.000Z'
        examples:
          default:
            value: '2023-10-05T14:48:00.000Z'
      - name: last_seen_at_end_date
        in: query
        description: Filter assets based on when we detected the asset for the last time in our system (less than this date)
        required: false
        schema:
          type: string
          title: Last Seen At End Date
          description: Filter assets based on when we detected the asset for the last time in our system (less than this date)
          format: date-time
          examples:
          - '2023-10-05T14:48:00.000Z'
        examples:
          default:
            value: '2023-10-05T14:48:00.000Z'
      - name: type
        in: query
        description: Filter on the type of an asset
        required: false
        schema:
          $ref: '#/components/schemas/AssetType'
          title: Type
          description: Filter on the type of an asset
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAssetsResponseDTO'
                __errors__:
                  '#/%24defs/TranslationElementDTO': Keys TranslationElementDTO_2 through TranslationElementDTO_20 already taken.
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_BadRequestError_'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnauthorizedError_'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_ForbiddenAccessError_'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_NotFoundError_'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnknownError_'
      security:
      - jwt: []
      servers:
      - url: https://api.cybelangel.com
    servers:
    - url: https://api.cybelangel.com
  /v1/inventory/assets/hostnames:
    get:
      tags:
      - ADM Inventory
      summary: Get inventory assets hostnames
      description: 'Get hostnames associated with assets of type IP.<br/><br/>You can filter assets by either ''asset_values'' or ''asset_ids'' parameters, but not both at the same time.<br/><br/>**Recommendation**: Inventory data is refreshed every 8 hours.<br/>We recommend aligning the frequency of your queries with this update interval for optimal results and performance.<br/><br/>⚠️ **Asset Discovery and Monitoring module is required.**'
      operationId: get-inventory-assets-hostnames
      parameters:
      - name: cursor
        in: query
        description: Cursor returned by a previous call to this endpoint. If it is not set, you will get the first page.
        required: false
        schema:
          type: string
          title: Cursor
          description: Cursor returned by a previous call to this endpoint. If it is not set, you will get the first page.
          minLength: 1
      - name: asset_values
        in: query
        description: To get hostnames for specific asset(s). Cannot be used together with 'asset_ids' parameter.
        required: false
        schema:
          type: array
          title: Asset Values
          description: To get hostnames for specific asset(s). Cannot be used together with 'asset_ids' parameter.
          examples:
          - - 74.125.20.138
            - 17.253.144.10
          items:
            type: string
            minLength: 1
        examples:
          default:
            value:
            - 74.125.20.138
            - 17.253.144.10
      - name: asset_ids
        in: query
        description: List of asset IDs (UUIDs) to filter the results. Cannot be used together with 'asset_values' parameter.
        required: false
        schema:
          type: array
          title: Asset Ids
          description: List of asset IDs (UUIDs) to filter the results. Cannot be used together with 'asset_values' parameter.
          items:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAssetsHostnamesResponseDTO'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_BadRequestError_'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnauthorizedError_'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_ForbiddenAccessError_'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_NotFoundError_'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnknownError_'
      security:
      - jwt: []
      servers:
      - url: https://api.cybelangel.com
    servers:
    - url: https://api.cybelangel.com
  /v1/inventory/assets/threats:
    get:
      tags:
      - ADM Inventory
      summary: Get inventory threats with asset info
      description: 'Get threats associated with assets. Threats are sorted by their `first_seen` field (descending), and returned by page of 50 items. If there are more elements, you can use the provided cursor to retrieve the next page as explained in [the how-to page](https://developers.cybelangel.com/docs/adm-inventory-api/7e88d945427a4-fetch-assets-details-from-adm-inventory#pagination).<br/><br/>**Recommendation**: Inventory data is refreshed every 8 hours.<br/>We recommend aligning the frequency of your queries with this update interval for optimal results and performance.<br/><br/>⚠️ **Asset Discovery and Monitoring module is required.**'
      operationId: get-inventory-threats-with-asset-info
      parameters:
      - name: cursor
        in: query
        description: Cursor returned by a previous call to this endpoint. If it is not set, you will get the first page.
        required: false
        schema:
          type: string
          title: Cursor
          description: Cursor returned by a previous call to this endpoint. If it is not set, you will get the first page.
          minLength: 1
      - name: asset_values
        in: query
        description: To get threats for specific asset(s). Cannot be used together with 'asset_ids' parameter.
        required: false
        schema:
          type: array
          title: Asset Values
          description: To get threats for specific asset(s). Cannot be used together with 'asset_ids' parameter.
          examples:
          - - 127.0.0.1
            - 192.168.0.1
          items:
            type: string
            minLength: 1
        examples:
          default:
            value:
            - 127.0.0.1
            - 192.168.0.1
      - name: asset_ids
        in: query
        description: List of asset IDs (UUIDs). Cannot be used together with 'asset_values' parameter.
        required: false
        schema:
          type: array
          title: Asset Ids
          description: List of asset IDs (UUIDs). Cannot be used together with 'asset_values' parameter.
          items:
            type: string
            format: uuid
      - name: severity
        in: query
        description: To get threats with specific severity
        required: false
        schema:
          type: array
          title: Severity
          description: To get threats with specific severity
          examples:
          - - 1
            - 2
          items:
            $ref: '#/components/schemas/ThreatSeverity'
        examples:
          default:
            value:
            - 1
            - 2
      - name: status
        in: query
        description: To get threats with specific status
        required: false
        schema:
          type: array
          title: Status
          description: To get threats with specific status
          examples:
          - - open
          items:
            $ref: '#/components/schemas/ThreatStatus'
        examples:
          default:
            value:
            - open
      - name: first_seen_start_date
        in: query
        description: Full datetime format with timezone (e.g., 2025-07-17T11:00:51Z)
        required: false
        schema:
          type: string
          title: First Seen Start Date
          description: Full datetime format with timezone (e.g., 2025-07-17T11:00:51Z)
          format: date-time
          examples:
          - '2025-07-17T11:00:51Z'
        examples:
          default:
            value: '2025-07-17T11:00:51Z'
      - name: first_seen_end_date
        in: query
        description: Full datetime format with timezone (e.g., 2025-07-18T11:00:51Z)
        required: false
        schema:
          type: string
          title: First Seen End Date
          description: Full datetime format with timezone (e.g., 2025-07-18T11:00:51Z)
          format: date-time
          examples:
          - '2025-07-18T11:00:51Z'
        examples:
          default:
            value: '2025-07-18T11:00:51Z'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetThreatsWithAssetInfoResponseDTO'
                __errors__:
                  '#/%24defs/TranslationElementDTO': Keys TranslationElementDTO_2 through TranslationElementDTO_20 already taken.
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_BadRequestError_'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnauthorizedError_'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_ForbiddenAccessError_'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_NotFoundError_'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnknownError_'
      security:
      - jwt: []
      servers:
      - url: https://api.cybelangel.com
    servers:
    - url: https://api.cybelangel.com
  /v1/inventory/assets/status:
    put:
      tags:
      - ADM Inventory
      summary: Update inventory assets status
      description: Update the status of multiple assets.<br/><br/>You must provide either 'asset_values' or 'asset_ids', but not both.<br/><br/>⚠️ **Asset Discovery and Monitoring module is required.**
      operationId: put-inventory-assets-status
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAssetsStatusRequestBodyDTO'
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_BadRequestError_'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnauthorizedError_'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_ForbiddenAccessError_'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_NotFoundError_'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_ConflictError_'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnknownError_'
      security:
      - jwt: []
      servers:
      - url: https://api.cybelangel.com
    servers:
    - url: https://api.cybelangel.com
  /v1/inventory/assets/threats/status:
    put:
      tags:
      - ADM Inventory
      summary: Update inventory assets threats status
      description: Update the status of multiple asset threats.<br/><br/>Each threat must identify its asset by either 'asset_value' or 'asset_id', but not both.<br/><br/>⚠️ **Asset Discovery and Monitoring module is required.**
      operationId: put-inventory-assets-threats-status
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAssetThreatStatusRequestBodyDTO'
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_BadRequestError_'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnauthorizedError_'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_ForbiddenAccessError_'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_NotFoundError_'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnknownError_'
      security:
      - jwt: []
      servers:
      - url: https://api.cybelangel.com
    servers:
    - url: https://api.cybelangel.com
  /v1/{organization_id}/inventory/assets:
    get:
      tags:
      - ADM Inventory
      summary: Get Organization Inventory Assets
      description: 'Get all inventory assets for one of your client organizations. Results are sorted by created_at (descending)<br/>and alphabetical order of value.<br/><br/>You can filter assets by either `values` or `ids` parameters, but not both at the same time.<br/><br/>**Recommendation**: Inventory data is refreshed every 8 hours.<br/>We recommend aligning the frequency of your queries with this update interval for optimal results and performance.<br/><br/>⚠️ **Asset Discovery and Monitoring module is required on the client organization.**'
      operationId: get-organization-inventory-assets
      parameters:
      - name: cursor
        in: query
        description: Cursor returned by a previous call to this endpoint. If it is not set, you will get the first page.
        required: false
        schema:
          type: string
          title: Cursor
          description: Cursor returned by a previous call to this endpoint. If it is not set, you will get the first page.
          minLength: 1
      - name: values
        in: query
        description: To get details for specific asset(s). Cannot be used together with 'ids' parameter.
        required: false
        schema:
          type: array
          title: Values
          description: To get details for specific asset(s). Cannot be used together with 'ids' parameter.
          items:
            type: string
            minLength: 1
      - name: ids
        in: query
        description: List of asset IDs (UUIDs). Cannot be used together with 'values' parameter.
        required: false
        schema:
          type: array
          title: Ids
          description: List of asset IDs (UUIDs). Cannot be used together with 'values' parameter.
          items:
            type: string
            format: uuid
      - name: status
        in: query
        description: '[Deprecated] Filter on the status on an asset (This query param will be removed on September 4 2026, use `asset_status` instead)'
        required: false
        deprecated: true
        schema:
          type: array
          title: Status
          description: '[Deprecated] Filter on the status on an asset (This query param will be removed on September 4 2026, use `asset_status` instead)'
          items:
            $ref: '#/components/schemas/PreviousAssetStatus'
          x-deprecated: true
      - name: asset_status
        in: query
        description: Filter on the status on an asset
        required: false
        schema:
          type: array
          title: Asset Status
          description: Filter on the status on an asset
          items:
            $ref: '#/components/schemas/AssetStatus'
      - name: first_seen_at_start_date
        in: query
        description: Filter assets based on when we detected the asset for the first time in our system (greater than this date)
        required: false
        schema:
          type: string
          title: First Seen At Start Date
          description: Filter assets based on when we detected the asset for the first time in our system (greater than this date)
          format: date-time
          examples:
          - '2023-10-05T14:48:00.000Z'
        examples:
          default:
            value: '2023-10-05T14:48:00.000Z'
      - name: first_seen_at_end_date
        in: query
        description: Filter assets based on when we detected the asset for the first time in our system (less than this date)
        required: false
        schema:
          type: string
          title: First Seen At End Date
          description: Filter assets based on when we detected the asset for the first time in our system (less than this date)
          format: date-time
          examples:
          - '2023-10-05T14:48:00.000Z'
        examples:
          default:
            value: '2023-10-05T14:48:00.000Z'
      - name: last_seen_at_start_date
        in: query
        description: Filter assets based on when we detected the asset for the last time in our system (greater than this date)
        required: false
        schema:
          type: string
          title: Last Seen At Start Date
          description: Filter assets based on when we detected the asset for the last time in our system (greater than this date)
          format: date-time
          examples:
          - '2023-10-05T14:48:00.000Z'
        examples:
          default:
            value: '2023-10-05T14:48:00.000Z'
      - name: last_seen_at_end_date
        in: query
        description: Filter assets based on when we detected the asset for the last time in our system (less than this date)
        required: false
        schema:
          type: string
          title: Last Seen At End Date
          description: Filter assets based on when we detected the asset for the last time in our system (less than this date)
          format: date-time
          examples:
          - '2023-10-05T14:48:00.000Z'
        examples:
          default:
            value: '2023-10-05T14:48:00.000Z'
      - name: type
        in: query
        description: Filter on the type of an asset
        required: false
        schema:
          $ref: '#/components/schemas/AssetType'
          title: Type
          description: Filter on the type of an asset
      - name: organization_id
        in: path
        description: ID of the organization to manage resources for
        required: true
        schema:
          type: string
          title: Organization Id
          description: ID of the organization to manage resources for
          format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAssetsResponseDTO'
                __errors__:
                  '#/%24defs/TranslationElementDTO': Keys TranslationElementDTO_2 through TranslationElementDTO_20 already taken.
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_BadRequestError_'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnauthorizedError_'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_ForbiddenAccessError_'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_NotFoundError_'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnknownError_'
      security:
      - jwt: []
      servers:
      - url: https://api.cybelangel.com
    servers:
    - url: https://api.cybelangel.com
  /v1/{organization_id}/inventory/assets/hostnames:
    get:
      tags:
      - ADM Inventory
      summary: Get Organization Inventory Assets Hostnames
      description: 'Get hostnames associated with IP assets for one of your client organizations.<br/><br/>You can filter assets by either ''asset_values'' or ''asset_ids'' parameters, but not both at the same time.<br/><br/>**Recommendation**: Inventory data is refreshed every 8 hours.<br/>We recommend aligning the frequency of your queries with this update interval for optimal results and performance.<br/><br/>⚠️ **Asset Discovery and Monitoring module is required on the client organization.**'
      operationId: get-organization-inventory-assets-hostnames
      parameters:
      - name: cursor
        in: query
        description: Cursor returned by a previous call to this endpoint. If it is not set, you will get the first page.
        required: false
        schema:
          type: string
          title: Cursor
          description: Cursor returned by a previous call to this endpoint. If it is not set, you will get the first page.
          minLength: 1
      - name: asset_values
        in: query
        description: To get hostnames for specific asset(s). Cannot be used together with 'asset_ids' parameter.
        required: false
        schema:
          type: array
          title: Asset Values
          description: To get hostnames for specific asset(s). Cannot be used together with 'asset_ids' parameter.
          examples:
          - - 74.125.20.138
            - 17.253.144.10
          items:
            type: string
            minLength: 1
        examples:
          default:
            value:
            - 74.125.20.138
            - 17.253.144.10
      - name: asset_ids
        in: query
        description: List of asset IDs (UUIDs) to filter the results. Cannot be used together with 'asset_values' parameter.
        required: false
        schema:
          type: array
          title: Asset Ids
          description: List of asset IDs (UUIDs) to filter the results. Cannot be used together with 'asset_values' parameter.
          items:
            type: string
            format: uuid
      - name: organization_id
        in: path
        description: ID of the organization to manage resources for
        required: true
        schema:
          type: string
          title: Organization Id
          description: ID of the organization to manage resources for
          format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAssetsHostnamesResponseDTO'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_BadRequestError_'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnauthorizedError_'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_ForbiddenAccessError_'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_NotFoundError_'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse_UnknownError_'
      security:
      - jwt: []
      servers:
      - url: https://api.cybelangel.com
    servers:
    - url: https://api.cybelangel.com
  /v1/{organization_id}/inventory/assets/threats:
    get:
      tags:
      - ADM Inventory
      summary: Get Organization Inventory Threats with Asset info
      description: 'Get threats associated with assets for one of your client organizations. Threats are sorted by their first_seen field (descending), and returned by page of 50 items. If there are more elements, you can use the provided cursor to retrieve the next page as explained in [the how-to page](https://developers.cybelangel.com/docs/adm-inventory-api/7e88d945427a4-fetch-assets-details-from-adm-inventory#pagination).<br/><br/>**Recommendation**: Inventory data is refreshed every 8 hours.<br/>We recommend aligning the frequency of your queries with this update interval for optimal results and performance.<br/><br/>⚠️ **Asset Discovery and Monitoring module is required on the client organization.**'
      operationId: get-organization-inventory-threats-with-asset-info
      parameters:
      - name: cursor
        in: query
        description: Cursor returned by a previous call to this endpoint. If it is not set, you will get the first page.
        required: false
        schema:
          type: string
          title: Cursor
          description: Cursor returned by a previous call to this endpoint. If it is not set, you will get the first page.
          minLength: 1
      - name: asset_values
        in: query
        description: To get threa

# --- truncated at 32 KB (72 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cybelangel/refs/heads/main/openapi/cybelangel-adm-inventory-api-openapi.yml