Graphiant

Graphiant Devices API

The Devices API from Graphiant — 40 operation(s) for devices.

Documentation GitHub OpenAPI

Operations 45

GET /v1/devices/{deviceId}/jobs/{jobId}

DELETE /v1/devices/{deviceId}/draft

GET /v1/devices/{deviceId}/draft

POST /v1/devices/{deviceId}/draft

POST /v1/devices/session-status

GET /v1/devices/{deviceId}/candidate-circuits

GET /v1/devices/{deviceId}/vrf/protocols

GET /v1/devices/{deviceId}/connectivity

GET /v1/devices/{deviceId}/twamp/core

GET /v1/devices/{deviceId}/dhcp-server/leases

GET /v1/devices/{deviceId}/policy/applications

GET /v1/devices/{deviceId}

GET /v1/devices/{deviceId}/versions/{version}

GET /v1/devices/{deviceId}/versions

GET /v1/devices

GET /v1/devices/{deviceId}/policy/zonepairs

GET /v1/devices/{deviceId}/interfaces

GET /v1/devices/{deviceId}/ospfv2/defaultOriginate

GET /v1/devices/{deviceId}/ospfv3/defaultOriginate

GET /v1/devices/{deviceId}/slice/peers

GET /v1/devices/{deviceId}/circuits/vrf-associations

PUT /v1/devices/{deviceId}/controller-peers

PUT /v1/devices/{deviceId}/config

POST /v1/devices/oauth

GET /v1/devices/oauth

GET /v1/devices/oauth/authorization

POST /v1/devices/inventory/approve-return

PUT /v1/devices/inventory/enterprise

POST /v1/devices/clear-new-flag

POST /v1/devices/inventory/clear-new-flag

POST /v1/devices/inventory/clear-return

POST /v1/devices/bringup/token

GET /v1/devices/inventory

POST /v1/devices/inventory

POST /v1/devices/bringup

PUT /v1/devices/bringup

POST /v1/devices/rma

DELETE /v1/devices/inventory/serial-num

POST /v1/devices/inventory/request-return

GET /v1/devices/{deviceId}/arp

GET /v1/devices/routing/vrf/protocol-route-count

GET /v1/devices/{deviceId}/vrrp

PUT /v1/devices/upgrade/cancel

POST /v1/devices/running/version

PUT /v1/devices/upgrade/schedule

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/graphiant-devices-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

openapi: 3.2.0
info:
  title: Graphiant Devices API
  version: 1.0.0
  description: Graphiant API documentation.
servers:
- url: https://api.graphiant.com
security:
- jwtAuth: []
tags:
- name: Devices
paths:
  /v1/devices/{deviceId}/jobs/{jobId}:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      - name: jobId
        in: path
        required: true
        description: id of the job as received from the Enqueue* calls.
        schema:
          type: integer
          format: int64
          example: 1234567891011
        example: 1234
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdJobsJobIdGetResponse'
      description: Get device job status
      tags:
      - Devices
  /v1/devices/{deviceId}/draft:
    delete:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '204':
          description: No Content
      description: Delete draft configuration
      tags:
      - Devices
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdDraftGetResponse'
      description: Get draft configuration
      tags:
      - Devices
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesDeviceIdDraftPostRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdDraftPostResponse'
      description: Save draft configuration
      tags:
      - Devices
  /v1/devices/session-status:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesSessionStatusPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesSessionStatusPostResponse'
      description: Get all the BGP session states for the devices
      tags:
      - Devices
  /v1/devices/{deviceId}/candidate-circuits:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdCandidateCircuitsGetResponse'
      description: Get the candidate circuits for a device
      tags:
      - Devices
  /v1/devices/{deviceId}/vrf/protocols:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      - name: vrfName
        in: query
        description: Valid Configured Vrf Name
        required: true
        schema:
          type: string
          example: example string
        example: lan-1-business
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdVrfProtocolsGetResponse'
      tags:
      - Devices
  /v1/devices/{deviceId}/connectivity:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdConnectivityGetResponse'
      description: Get the connectivity graph for a device
      tags:
      - Devices
  /v1/devices/{deviceId}/twamp/core:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdTwampCoreGetResponse'
      description: Get core TWAMP neighbors for a given device
      tags:
      - Devices
  /v1/devices/{deviceId}/dhcp-server/leases:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdDhcpServerLeasesGetResponse'
      description: Get current DHCP leases for a device
      tags:
      - Devices
  /v1/devices/{deviceId}/policy/applications:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdPolicyApplicationsGetResponse'
      description: Get a list of builtin DPI applications able to be configured on a given device based on GNOS version
      tags:
      - Devices
  /v1/devices/{deviceId}:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdGetResponse'
      description: Get a specific device
      tags:
      - Devices
  /v1/devices/{deviceId}/versions/{version}:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: 16 bytes (base64 encoded) identifier for the device.
        schema:
          type: integer
          format: int64
          example: 1234567891011
        example: 3000000000
      - name: version
        in: path
        required: true
        description: 8 bytes (base32 encoded) version number.
        schema:
          type: integer
          format: int32
          example: 123
          minimum: 0
        example: 150
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdVersionsVersionGetResponse'
      description: Get device config for a specific version
      tags:
      - Devices
  /v1/devices/{deviceId}/versions:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: 16 bytes (base64 encoded) identifier for the device.
        schema:
          type: integer
          format: int64
          example: 1234567891011
        example: 3000000000
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdVersionsGetResponse'
      description: Get device config versions
      tags:
      - Devices
  /v1/devices:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesGetResponse'
      description: Get devices for the current enterprise
      tags:
      - Devices
  /v1/devices/{deviceId}/policy/zonepairs:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdPolicyZonepairsGetResponse'
      description: Get a list of firewall zone pairs each with holding nested policy rule sets
      tags:
      - Devices
  /v1/devices/{deviceId}/interfaces:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdInterfacesGetResponse'
      description: Get interfaces for the given device
      tags:
      - Devices
  /v1/devices/{deviceId}/ospfv2/defaultOriginate:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdOspfv2DefaultOriginateGetResponse'
      tags:
      - Devices
  /v1/devices/{deviceId}/ospfv3/defaultOriginate:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdOspfv3DefaultOriginateGetResponse'
      tags:
      - Devices
  /v1/devices/{deviceId}/slice/peers:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdSlicePeersGetResponse'
      tags:
      - Devices
  /v1/devices/{deviceId}/circuits/vrf-associations:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      - name: circuitNames
        in: query
        description: Circuit name configured of wan interface
        required: false
        schema:
          type: array
          items:
            type: string
            example: isp
          example:
          - isp
        style: form
        explode: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdCircuitsVrfAssociationsGetResponse'
      description: Get the VRF, interface, &, if relevant, loopback interfaces for a list of circuits
      tags:
      - Devices
  /v1/devices/{deviceId}/controller-peers:
    put:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesDeviceIdControllerPeersPutRequest'
      responses:
        '202':
          description: Accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdControllerPeersPutResponse'
      description: Update peer list for controller
      tags:
      - Devices
  /v1/devices/{deviceId}/config:
    put:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesDeviceIdConfigPutRequest'
      responses:
        '202':
          description: Accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdConfigPutResponse'
      description: Update a device
      tags:
      - Devices
  /v1/devices/oauth:
    post:
      description: Process OAuth client credentials for device onboarding
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesOauthPostRequest'
      responses:
        '200':
          description: OAuth token generated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesOauthPostResponse'
        '400':
          description: Bad request - Invalid input
        '500':
          description: Internal server error
      tags:
      - Devices
    get:
      description: Redirect to OAuth authorization page for device onboarding
      parameters:
      - in: query
        name: scope
        required: true
        schema:
          type: string
          example: type=zt-cpe uuid=device-uuid-123 hostname=device.example.com
        description: OAuth scope containing device type, UUID, and hostname
      - in: query
        name: state
        schema:
          type: string
          example: state-12345
        description: OAuth state parameter
      - in: query
        name: code_challenge
        schema:
          type: string
          example: code-challenge-12345
        description: PKCE code challenge
      - in: query
        name: code_challenge_method
        schema:
          type: string
          example: S256
        description: PKCE code challenge method
      - in: query
        name: pt
        schema:
          type: string
          example: hardware
        description: Platform type
      - in: query
        name: bm
        schema:
          type: string
          example: p
        description: Boot mode
      responses:
        '302':
          description: Redirect to OAuth authorization page
        '400':
          description: Bad request - Invalid parameters
        '500':
          description: Internal server error
      tags:
      - Devices
  /v1/devices/oauth/authorization:
    get:
      description: Process OAuth authorization for device onboarding
      security:
      - jwtAuth: []
      parameters:
      - in: query
        name: relayState
        required: true
        schema:
          type: string
          example: eyJzY29wZSI6InR5cGU9enQtY3BlIHV1aWQ9ZGV2aWNlLXV1aWQtMTIzIGhvc3RuYW1lPWRldmljZS5leGFtcGxlLmNvbSIsInN0YXRlIjoic3RhdGUtMTIzNDUiLCJjb2RlX2NoYWxsZW5nZSI6ImNvZGUtY2hhbGxlbmdlLTEyMzQ1IiwiY29kZV9jaGFsbGVuZ2VfbWV0aG9kIjoiUzI1NiIsInB0IjoiaGFyZHdhcmUiLCJibSI6InAifQ==
        description: Base64 encoded relay state containing OAuth parameters
      responses:
        '200':
          description: Authorization code generated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesOauthAuthorizationGetResponse'
        '400':
          description: Bad request - Invalid relay state or parameters
        '401':
          description: Unauthorized - Invalid or missing token
        '500':
          description: Internal server error
      tags:
      - Devices
  /v1/devices/inventory/approve-return:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesInventoryApproveReturnPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesInventoryApproveReturnPostResponse'
      tags:
      - Devices
  /v1/devices/inventory/enterprise:
    put:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesInventoryEnterprisePutRequest'
      responses:
        '204':
          description: No Content
      tags:
      - Devices
  /v1/devices/clear-new-flag:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesClearNewFlagPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesClearNewFlagPostResponse'
      tags:
      - Devices
  /v1/devices/inventory/clear-new-flag:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesInventoryClearNewFlagPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesInventoryClearNewFlagPostResponse'
      tags:
      - Devices
  /v1/devices/inventory/clear-return:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesInventoryClearReturnPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesInventoryClearReturnPostResponse'
      tags:
      - Devices
  /v1/devices/bringup/token:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesBringupTokenPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesBringupTokenPostResponse'
      description: VM edge onboarding token
      tags:
      - Devices
  /v1/devices/inventory:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: notAssigned
        in: query
        description: ''
        required: false
        schema:
          type: boolean
          example: true
        example: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesInventoryGetResponse'
      tags:
      - Devices
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesInventoryPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesInventoryPostResponse'
      tags:
      - Devices
  /v1/devices/bringup:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesBringupPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesBringupPostResponse'
      tags:
      - Devices
    put:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesBringupPutRequest'
      responses:
        '204':
          description: No Content
      tags:
      - Devices
  /v1/devices/rma:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesRmaPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesRmaPostResponse'
      tags:
      - Devices
  /v1/devices/inventory/serial-num:
    delete:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceSerials
        in: query
        description: ''
        required: false
        schema:
          type: array
          items:
            type: string
            example: example string
          example:
          - example
        style: form
        explode: true
      responses:
        '204':
          description: No Content
      tags:
      - Devices
  /v1/devices/inventory/request-return:
    post:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1DevicesInventoryRequestReturnPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesInventoryRequestReturnPostResponse'
      tags:
      - Devices
  /v1/devices/{deviceId}/arp:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: path
        required: true
        description: ''
        schema:
          type: integer
          format: int64
          example: 1234567891011
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1DevicesDeviceIdArpGetResponse'
      description: Get ARP monitoring table for a device
      tags:
      - Devices
  /v1/devices/routing/vrf/protocol-route-count:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: deviceId
        in: query
        description: Valid configured device ID > 0
        required: true
        schema:
          type: integer
          format: int64
          example: 1234567891011
        example: 1000000
      - name: protocols
        in: query
        description: List of protocols names for which route count is needed
        required: true
        schema:
          type: array
          items:
            type: string
            example: '[OSPF,BGP,connected]'
          example:
          - '[OSPF,BGP,connected]'
        style: form
        explode: true
      - name: vrfName
        in: query
        description: Valid configured VRF names
        required: true
        schema:
          type: string
          example: example string
        example: management
      responses:
        '200':
          description: OK
          co

# --- truncated at 32 KB (242 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/graphiant/refs/heads/main/openapi/graphiant-devices-api-openapi.yml