YugabyteDB

YugabyteDB Node Agents API

The Node Agents API from YugabyteDB — 5 operation(s) for node agents.

GitHub OpenAPI

Operations 5

GET /api/v1/customers/{cUUID}/node_agents List Node Agents #
POST /api/v1/customers/{cUUID}/node_agents/page List Node Agents (paginated) #
GET /api/v1/customers/{cUUID}/node_agents/{nUUID} Get Node Agent #
POST /api/v1/customers/{cUUID}/universes/{uniUUID}/node_agents Reinstall Node Agent #
GET /api/v1/node_agents/download Download Node Agent Installer or Package #

Documentation

📖
Documentation
https://docs.yugabyte.com/stable/yugabyte-cloud/managed-automation/managed-api/
📖
APIReference
https://api-docs.yugabyte.com/docs/managed-apis/
📖
GettingStarted
https://docs.yugabyte.com/stable/yugabyte-cloud/managed-automation/managed-api/managed-apikeys/
📖
Authentication
https://docs.yugabyte.com/stable/yugabyte-cloud/managed-automation/managed-api/managed-apikeys/
📖
Documentation
https://docs.yugabyte.com/stable/yugabyte-platform/anywhere-automation/anywhere-api/
📖
APIReference
https://api-docs.yugabyte.com/docs/yugabyte-platform/
📖
GettingStarted
https://docs.yugabyte.com/stable/yugabyte-platform/anywhere-automation/anywhere-api/
📖
Authentication
https://docs.yugabyte.com/stable/yugabyte-platform/anywhere-automation/anywhere-api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/openapi/yugabytedb-node-agents-api-openapi.yml

Other Resources

🔗
CLI
https://github.com/yugabyte/ybm-cli
🔗
Integrations
https://github.com/yugabyte/terraform-provider-ybm
🔗
TermsOfService
https://www.yugabyte.com/yugabytedb-managed-service-terms/
🔗
SDKs
https://github.com/yugabyte/platform-go-client
🔗
Integrations
https://github.com/yugabyte/terraform-provider-yba
🔗
Integrations
https://github.com/yugabyte/yugabyte-k8s-operator
🔗
KubernetesCRD
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/crd/yugabytedb-ybuniverse.yaml
🔗
KubernetesCRD
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/crd/yugabytedb-backup.yaml
🔗
KubernetesCRD
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/crd/yugabytedb-backup-schedule.yaml
🔗
KubernetesCRD
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/crd/yugabytedb-restore-job.yaml
🔗
KubernetesCRD
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/crd/yugabytedb-storage-config.yaml
🔗
KubernetesCRD
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/crd/yugabytedb-dr-config.yaml
🔗
KubernetesCRD
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/crd/yugabytedb-pitr-config.yaml
🔗
KubernetesCRD
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/crd/yugabytedb-release.yaml
🔗
KubernetesCRD
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/crd/yugabytedb-support-bundle.yaml
🔗
KubernetesCRD
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/crd/yugabytedb-ybcertificate.yaml
🔗
KubernetesCRD
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/crd/yugabytedb-ybprovider.yaml
🔗
KubernetesCRD
https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/crd/yugabytedb-ybplatform.yaml

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/yugabytedb-node-agents-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.

GitHub Google LinkedIn

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

OpenAPI Specification

yugabytedb-node-agents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Yugabytedb Node Agents API
  version: v1
  contact:
    name: https://docs.yugabyte.com
  license:
    name: Polyform Free Trial License 1.0.0
    url: https://github.com/yugabyte/yugabyte-db/blob/master/licenses/POLYFORM-FREE-TRIAL-LICENSE-1.0.0.txt
  termsOfService: TODO(chirag)
  x-refined-note:
  - x-source differs across the merged source definitions and was not carried
  - x-split-from differs across the merged source definitions and was not carried
  description: 'Operations tagged Node Agents across 3 of this provider''s published API definitions: openapi_2.yaml, yugabytedb-anywhere-v1-full.yaml, yugabytedb-anywhere-v1-providers-infra.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: /
tags:
- name: Node Agents
paths:
  /api/v1/customers/{cUUID}/node_agents:
    get:
      operationId: ListNodeAgents
      parameters:
      - in: path
        name: cUUID
        required: true
        schema:
          format: uuid
          type: string
      - in: query
        name: nodeIp
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/NodeAgentResp'
                type: array
          description: successful operation
      security:
      - apiKeyAuth: []
      summary: List Node Agents
      tags:
      - Node Agents
    servers:
    - url: /
  /api/v1/customers/{cUUID}/node_agents/page:
    post:
      operationId: PageListNodeAgents
      parameters:
      - in: path
        name: cUUID
        required: true
        schema:
          format: uuid
          type: string
      - in: query
        name: request
        schema: {}
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NodeAgentPagedApiQuery'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NodeAgentPagedApiResponse'
          description: successful operation
      security:
      - apiKeyAuth: []
      summary: List Node Agents (paginated)
      tags:
      - Node Agents
      x-codegen-request-body-name: PageNodeAgentRequest
    servers:
    - url: /
  /api/v1/customers/{cUUID}/node_agents/{nUUID}:
    get:
      operationId: GetNodeAgent
      parameters:
      - in: path
        name: cUUID
        required: true
        schema:
          format: uuid
          type: string
      - in: path
        name: nUUID
        required: true
        schema:
          format: uuid
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NodeAgentResp'
          description: successful operation
      security:
      - apiKeyAuth: []
      summary: Get Node Agent
      tags:
      - Node Agents
    servers:
    - url: /
  /api/v1/customers/{cUUID}/universes/{uniUUID}/node_agents:
    post:
      operationId: ReinstallNodeAgent
      parameters:
      - in: path
        name: cUUID
        required: true
        schema:
          format: uuid
          type: string
      - in: path
        name: uniUUID
        required: true
        schema:
          format: uuid
          type: string
      - in: query
        name: request
        schema: {}
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReinstallNodeAgentForm'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NodeAgent'
          description: successful operation
      security:
      - apiKeyAuth: []
      summary: Reinstall Node Agent
      tags:
      - Node Agents
      x-codegen-request-body-name: ReinstallNodeAgentForm
    servers:
    - url: /
  /api/v1/node_agents/download:
    get:
      operationId: DownloadNodeAgentInstaller
      parameters:
      - in: query
        name: downloadType
        schema:
          default: INSTALLER
          type: string
      - in: query
        name: os
        schema:
          type: string
      - in: query
        name: arch
        schema:
          type: string
      responses:
        '200':
          content:
            application/gzip:
              schema:
                type: string
            application/x-sh:
              schema:
                type: string
          description: successful operation
      security:
      - apiKeyAuth: []
      summary: Download Node Agent Installer or Package
      tags:
      - Node Agents
    servers:
    - url: /
components:
  schemas:
    NodeAgentResp:
      description: Node agent details
      example:
        lastError:
          code: UNKNOWN_ERROR
          originMessage: originMessage
          message: message
        versionMatched: true
        ip: ip
        providerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        version: version
        reachable: true
        home: home
        universeUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        customerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        port: 0
        name: name
        osType: DARWIN
        archType: ARM64
        state: REGISTERING
        config:
          certPath: certPath
          serverCert: serverCert
          offloadable: true
          serverKey: serverKey
          compressor: compressor
        providerName: providerName
        universeName: universeName
        updatedAt: 2022-12-21 13:07:18+00:00
      properties:
        archType:
          description: Node agent host machine arch
          enum:
          - ARM64
          - AMD64
          readOnly: true
          type: string
        config:
          $ref: '#/components/schemas/Config'
        customerUuid:
          description: Customer UUID
          format: uuid
          readOnly: true
          type: string
        home:
          description: Node agent installation directory
          readOnly: true
          type: string
        ip:
          description: Node agent server IP
          readOnly: true
          type: string
        lastError:
          $ref: '#/components/schemas/YBAError'
        name:
          description: Node agent name
          readOnly: true
          type: string
        osType:
          description: Node agent host OS
          enum:
          - DARWIN
          - LINUX
          readOnly: true
          type: string
        port:
          description: Node agent server port
          format: int32
          readOnly: true
          type: integer
        providerName:
          readOnly: true
          type: string
        providerUuid:
          format: uuid
          readOnly: true
          type: string
        reachable:
          readOnly: true
          type: boolean
        state:
          description: Node agent state
          enum:
          - REGISTERING
          - REGISTERED
          - UPGRADE
          - UPGRADED
          - READY
          readOnly: true
          type: string
        universeName:
          readOnly: true
          type: string
        universeUuid:
          format: uuid
          readOnly: true
          type: string
        updatedAt:
          description: Updated time
          example: 2022-12-21 13:07:18+00:00
          format: date-time
          readOnly: true
          type: string
        uuid:
          description: Node agent UUID
          format: uuid
          readOnly: true
          type: string
        version:
          description: Node agent installed version
          readOnly: true
          type: string
        versionMatched:
          readOnly: true
          type: boolean
      type: object
    YBAError:
      example:
        code: UNKNOWN_ERROR
        originMessage: originMessage
        message: message
      properties:
        code:
          description: Error code
          enum:
          - UNKNOWN_ERROR
          - INTERNAL_ERROR
          - PLATFORM_SHUTDOWN
          - PLATFORM_RESTARTED
          - INSTALLATION_ERROR
          - SERVICE_START_ERROR
          - CONNECTION_ERROR
          - TIMED_OUT
          readOnly: true
          type: string
        message:
          description: Error message
          readOnly: true
          type: string
        originMessage:
          description: Origin error message
          readOnly: true
          type: string
      type: object
    NodeAgent:
      description: Node agent details
      example:
        lastError:
          code: UNKNOWN_ERROR
          originMessage: originMessage
          message: message
        ip: ip
        uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        version: version
        home: home
        customerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        port: 0
        name: name
        osType: DARWIN
        archType: ARM64
        state: REGISTERING
        config:
          certPath: certPath
          serverCert: serverCert
          offloadable: true
          serverKey: serverKey
          compressor: compressor
        updatedAt: 2022-12-21 13:07:18+00:00
      properties:
        archType:
          description: Node agent host machine arch
          enum:
          - ARM64
          - AMD64
          readOnly: true
          type: string
        config:
          $ref: '#/components/schemas/Config'
        customerUuid:
          description: Customer UUID
          format: uuid
          readOnly: true
          type: string
        home:
          description: Node agent installation directory
          readOnly: true
          type: string
        ip:
          description: Node agent server IP
          readOnly: true
          type: string
        lastError:
          $ref: '#/components/schemas/YBAError'
        name:
          description: Node agent name
          readOnly: true
          type: string
        osType:
          description: Node agent host OS
          enum:
          - DARWIN
          - LINUX
          readOnly: true
          type: string
        port:
          description: Node agent server port
          format: int32
          readOnly: true
          type: integer
        state:
          description: Node agent state
          enum:
          - REGISTERING
          - REGISTERED
          - UPGRADE
          - UPGRADED
          - READY
          readOnly: true
          type: string
        updatedAt:
          description: Updated time
          example: 2022-12-21 13:07:18+00:00
          format: date-time
          readOnly: true
          type: string
        uuid:
          description: Node agent UUID
          format: uuid
          readOnly: true
          type: string
        version:
          description: Node agent installed version
          readOnly: true
          type: string
      type: object
    NodeAgentApiFilter:
      example:
        universeUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        regionUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        cloudType: unknown
        zoneUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        providerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        nodeIps:
        - nodeIps
        - nodeIps
      properties:
        cloudType:
          enum:
          - unknown
          - aws
          - gcp
          - azu
          - docker
          - onprem
          - kubernetes
          - local
          - other
          type: string
        nodeIps:
          items:
            type: string
          type: array
          uniqueItems: true
        providerUuid:
          format: uuid
          type: string
        regionUuid:
          format: uuid
          type: string
        universeUuid:
          format: uuid
          type: string
        zoneUuid:
          format: uuid
          type: string
      required:
      - cloudType
      - nodeIps
      - providerUuid
      - regionUuid
      - universeUuid
      - zoneUuid
      type: object
    Config:
      example:
        certPath: certPath
        serverCert: serverCert
        offloadable: true
        serverKey: serverKey
        compressor: compressor
      properties:
        certPath:
          type: string
        compressor:
          type: string
        offloadable:
          type: boolean
        serverCert:
          type: string
        serverKey:
          type: string
      required:
      - certPath
      - compressor
      - offloadable
      - serverCert
      - serverKey
      type: object
    NodeAgentPagedApiResponse:
      example:
        entities:
        - lastError:
            code: UNKNOWN_ERROR
            originMessage: originMessage
            message: message
          versionMatched: true
          ip: ip
          providerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          version: version
          reachable: true
          home: home
          universeUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          customerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          port: 0
          name: name
          osType: DARWIN
          archType: ARM64
          state: REGISTERING
          config:
            certPath: certPath
            serverCert: serverCert
            offloadable: true
            serverKey: serverKey
            compressor: compressor
          providerName: providerName
          universeName: universeName
          updatedAt: 2022-12-21 13:07:18+00:00
        - lastError:
            code: UNKNOWN_ERROR
            originMessage: originMessage
            message: message
          versionMatched: true
          ip: ip
          providerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          version: version
          reachable: true
          home: home
          universeUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          customerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          port: 0
          name: name
          osType: DARWIN
          archType: ARM64
          state: REGISTERING
          config:
            certPath: certPath
            serverCert: serverCert
            offloadable: true
            serverKey: serverKey
            compressor: compressor
          providerName: providerName
          universeName: universeName
          updatedAt: 2022-12-21 13:07:18+00:00
        hasPrev: true
        hasNext: true
        totalCount: 0
      properties:
        entities:
          items:
            $ref: '#/components/schemas/NodeAgentResp'
          type: array
        hasNext:
          type: boolean
        hasPrev:
          type: boolean
        totalCount:
          format: int32
          type: integer
      required:
      - entities
      - hasNext
      - hasPrev
      - totalCount
      type: object
    ReinstallNodeAgentForm:
      example:
        nodeNames:
        - nodeNames
        - nodeNames
      properties:
        nodeNames:
          description: Node names
          items:
            type: string
          type: array
          uniqueItems: true
      type: object
    NodeAgentPagedApiQuery:
      example:
        filter:
          universeUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          regionUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          cloudType: unknown
          zoneUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          providerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          nodeIps:
          - nodeIps
          - nodeIps
        offset: 6
        needTotalCount: true
        limit: 0
        sortBy: uuid
        direction: ASC
      properties:
        direction:
          enum:
          - ASC
          - DESC
          type: string
        filter:
          $ref: '#/components/schemas/NodeAgentApiFilter'
        limit:
          format: int32
          type: integer
        needTotalCount:
          type: boolean
        offset:
          format: int32
          type: integer
        sortBy:
          enum:
          - uuid
          - ip
          - name
          - state
          - updatedAt
          - version
          type: string
      required:
      - direction
      - filter
      - limit
      - needTotalCount
      - offset
      - sortBy
      type: object
    NodeAgentResp_2:
      description: Node agent details
      example:
        lastError:
          code: UNKNOWN_ERROR
          originMessage: originMessage
          message: message
        versionMatched: true
        ip: ip
        providerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        version: version
        reachable: true
        home: home
        universeUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        customerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        port: 0
        name: name
        osType: DARWIN
        archType: ARM64
        state: REGISTERING
        config:
          certPath: certPath
          serverCert: serverCert
          offloadable: true
          serverKey: serverKey
          compressor: compressor
        providerName: providerName
        universeName: universeName
        updatedAt: 2022-12-21 13:07:18+00:00
      properties:
        archType:
          description: Node agent host machine arch
          enum:
          - ARM64
          - AMD64
          readOnly: true
          type: string
          example: ARM64
        config:
          $ref: '#/components/schemas/Config_2'
        customerUuid:
          description: Customer UUID
          format: uuid
          readOnly: true
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        home:
          description: Node agent installation directory
          readOnly: true
          type: string
          example: example-home
        ip:
          description: Node agent server IP
          readOnly: true
          type: string
          example: 10.0.0.1
        lastError:
          $ref: '#/components/schemas/YBAError_2'
        name:
          description: Node agent name
          readOnly: true
          type: string
          example: example-name
        osType:
          description: Node agent host OS
          enum:
          - DARWIN
          - LINUX
          readOnly: true
          type: string
          example: DARWIN
        port:
          description: Node agent server port
          format: int32
          readOnly: true
          type: integer
          example: 5433
        providerName:
          readOnly: true
          type: string
          example: example-providerName
        providerUuid:
          format: uuid
          readOnly: true
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        reachable:
          readOnly: true
          type: boolean
          example: true
        state:
          description: Node agent state
          enum:
          - REGISTERING
          - REGISTERED
          - UPGRADE
          - UPGRADED
          - READY
          readOnly: true
          type: string
          example: REGISTERING
        universeName:
          readOnly: true
          type: string
          example: example-universeName
        universeUuid:
          format: uuid
          readOnly: true
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        updatedAt:
          description: Updated time
          example: 2022-12-21 13:07:18+00:00
          format: date-time
          readOnly: true
          type: string
        uuid:
          description: Node agent UUID
          format: uuid
          readOnly: true
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        version:
          description: Node agent installed version
          readOnly: true
          type: string
          example: 2.20.0.0
        versionMatched:
          readOnly: true
          type: boolean
          example: true
      type: object
    YBAError_2:
      example:
        code: UNKNOWN_ERROR
        originMessage: originMessage
        message: message
      properties:
        code:
          description: Error code
          enum:
          - UNKNOWN_ERROR
          - INTERNAL_ERROR
          - PLATFORM_SHUTDOWN
          - PLATFORM_RESTARTED
          - INSTALLATION_ERROR
          - SERVICE_START_ERROR
          - CONNECTION_ERROR
          - TIMED_OUT
          readOnly: true
          type: string
          example: UNKNOWN_ERROR
        message:
          description: Error message
          readOnly: true
          type: string
          example: Example message
        originMessage:
          description: Origin error message
          readOnly: true
          type: string
          example: Example originMessage
      type: object
    NodeAgent_2:
      description: Node agent details
      example:
        lastError:
          code: UNKNOWN_ERROR
          originMessage: originMessage
          message: message
        ip: ip
        uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        version: version
        home: home
        customerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        port: 0
        name: name
        osType: DARWIN
        archType: ARM64
        state: REGISTERING
        config:
          certPath: certPath
          serverCert: serverCert
          offloadable: true
          serverKey: serverKey
          compressor: compressor
        updatedAt: 2022-12-21 13:07:18+00:00
      properties:
        archType:
          description: Node agent host machine arch
          enum:
          - ARM64
          - AMD64
          readOnly: true
          type: string
          example: ARM64
        config:
          $ref: '#/components/schemas/Config_2'
        customerUuid:
          description: Customer UUID
          format: uuid
          readOnly: true
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        home:
          description: Node agent installation directory
          readOnly: true
          type: string
          example: example-home
        ip:
          description: Node agent server IP
          readOnly: true
          type: string
          example: 10.0.0.1
        lastError:
          $ref: '#/components/schemas/YBAError_2'
        name:
          description: Node agent name
          readOnly: true
          type: string
          example: example-name
        osType:
          description: Node agent host OS
          enum:
          - DARWIN
          - LINUX
          readOnly: true
          type: string
          example: DARWIN
        port:
          description: Node agent server port
          format: int32
          readOnly: true
          type: integer
          example: 5433
        state:
          description: Node agent state
          enum:
          - REGISTERING
          - REGISTERED
          - UPGRADE
          - UPGRADED
          - READY
          readOnly: true
          type: string
          example: REGISTERING
        updatedAt:
          description: Updated time
          example: 2022-12-21 13:07:18+00:00
          format: date-time
          readOnly: true
          type: string
        uuid:
          description: Node agent UUID
          format: uuid
          readOnly: true
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        version:
          description: Node agent installed version
          readOnly: true
          type: string
          example: 2.20.0.0
      type: object
    NodeAgentApiFilter_2:
      example:
        universeUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        regionUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        cloudType: unknown
        zoneUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        providerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        nodeIps:
        - nodeIps
        - nodeIps
      properties:
        cloudType:
          enum:
          - unknown
          - aws
          - gcp
          - azu
          - docker
          - onprem
          - kubernetes
          - local
          - other
          type: string
          example: unknown
        nodeIps:
          items:
            type: string
          type: array
          uniqueItems: true
          example:
          - node-1
        providerUuid:
          format: uuid
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        regionUuid:
          format: uuid
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        universeUuid:
          format: uuid
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        zoneUuid:
          format: uuid
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
      required:
      - cloudType
      - nodeIps
      - providerUuid
      - regionUuid
      - universeUuid
      - zoneUuid
      type: object
    Config_2:
      example:
        certPath: certPath
        serverCert: serverCert
        offloadable: true
        serverKey: serverKey
        compressor: compressor
      properties:
        certPath:
          type: string
          example: /var/lib/yugabyte/example
        compressor:
          type: string
          example: example-compressor
        offloadable:
          type: boolean
          example: true
        serverCert:
          type: string
          example: example-serverCert
        serverKey:
          type: string
          example: example-key
      required:
      - certPath
      - compressor
      - offloadable
      - serverCert
      - serverKey
      type: object
    NodeAgentPagedApiResponse_2:
      example:
        entities:
        - lastError:
            code: UNKNOWN_ERROR
            originMessage: originMessage
            message: message
          versionMatched: true
          ip: ip
          providerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          version: version
          reachable: true
          home: home
          universeUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          customerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          port: 0
          name: name
          osType: DARWIN
          archType: ARM64
          state: REGISTERING
          config:
            certPath: certPath
            serverCert: serverCert
            offloadable: true
            serverKey: serverKey
            compressor: compressor
          providerName: providerName
          universeName: universeName
          updatedAt: 2022-12-21 13:07:18+00:00
        - lastError:
            code: UNKNOWN_ERROR
            originMessage: originMessage
            message: message
          versionMatched: true
          ip: ip
          providerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          version: version
          reachable: true
          home: home
          universeUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          customerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          port: 0
          name: name
          osType: DARWIN
          archType: ARM64
          state: REGISTERING
          config:
            certPath: certPath
            serverCert: serverCert
            offloadable: true
            serverKey: serverKey
            compressor: compressor
          providerName: providerName
          universeName: universeName
          updatedAt: 2022-12-21 13:07:18+00:00
        hasPrev: true
        hasNext: true
        totalCount: 0
      properties:
        entities:
          items:
            $ref: '#/components/schemas/NodeAgentResp_2'
          type: array
          example:
          - lastError:
              code: UNKNOWN_ERROR
              originMessage: originMessage
              message: message
            versionMatched: true
            ip: ip
            providerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
            uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
            version: version
            reachable: true
            home: home
            universeUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
            customerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
            port: 0
            name: name
            osType: DARWIN
            archType: ARM64
            state: REGISTERING
            config:
              certPath: certPath
              serverCert: serverCert
              offloadable: true
              serverKey: serverKey
              compressor: compressor
            providerName: providerName
            universeName: universeName
            updatedAt: '2022-12-21T13:07:18+00:00'
        hasNext:
          type: boolean
          example: true
        hasPrev:
          type: boolean
          example: true
        totalCount:
          format: int32
          type: integer
          example: 10
      required:
      - entities
      - hasNext
      - hasPrev
      - totalCount
      type: object
    ReinstallNodeAgentForm_2:
      example:
        nodeNames:
        - nodeNames
        - nodeNames
      properties:
        nodeNames:
          description: Node names
          items:
            type: string
          type: array
          uniqueItems: true
          example:
          - example-nodeNames
      type: object
    NodeAgentPagedApiQuery_2:
      example:
        filter:
          universeUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          regionUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          cloudType: unknown
          zoneUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          providerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          nodeIps:
          - nodeIps
          - nodeIps
        offset: 6
        needTotalCount: true
        limit: 0
        sortBy: uuid
        direction: ASC
      properties:
        direction:
          enum:
          - ASC
          - DESC
          type: string
          example: ASC
        filter:
          $ref: '#/components/schemas/NodeAgentApiFilter_2'
        limit:
          format: int32
          type: integer
          example: 10
        needTotalCount:
          type: boolean
          example: true
        offset:
          format: int32
          type: integer
          example: 100
        sortBy:
          enum:
          - uuid
          - ip
          - name
          - state
          - updatedAt
          - version
          type: string
          example: uuid
      required:
      - direction
      - filter
      - limit
      - needTotalCount
      - offset
      - sortBy
      type: object
    NodeAgentResp_3:
      description: Node agent details
      example:
        lastError:
          code: UNKNOWN_ERROR
          originMessage: originMessage
          message: message
        versionMatched: true
        ip: ip
        providerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        uuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        version: version
        reachable: true
        home: home
        universeUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        customerUuid: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        port: 0
        name: name
        osType: DARWIN
        archType: ARM64
        state: REGISTERING
        config:
          certPath: certPath
          serverCert: serverCert
          offloadable: true
          serverKey: serverKey
          compressor: compressor
        providerName: providerName
        universeName: universeName
        updatedAt: 2022-12-21 13:07:18+00:00
      properties:
        archType:
          description: Node agent host machine arch
          enum:
          - ARM64
          - AMD64
          readOnly: true
          type: string
          example: ARM64
        config:
          $ref: '#/components/schemas/Config_3'
        customerUuid:
          description: Customer UUID
          format: uuid
          readOnly: true
          type: string
          example: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
        home:
          description: Node agent installation directory
          readOnly: true
          type: string
          example: example-home
        ip:
          description: Node agent server IP
          readOnly: true
          type: string
          example: 10.0.0.1
        lastError:
          $ref: '#/components/schemas/YBAError_3'
        name:
          description: Node agent name
          readOnly: true
          type: string
          example: example-name
        osType:
          description: Node agent host OS
   

# --- truncated at 32 KB (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/yugabytedb/refs/heads/main/openapi/yugabytedb-node-agents-api-openapi.yml