Graphiant

Graphiant Software API

The Software API from Graphiant — 9 operation(s) for software.

Documentation GitHub OpenAPI

Operations 13

POST /v1/software/rollouts Create software rollouts #

GET /v1/software/rollouts Get software rollouts #

PUT /v1/software/rollouts Replace software rollouts #

DELETE /v1/software/rollouts/{id} Delete software rollouts by id #

GET /v1/software/rollouts/{id} Get software rollouts by id #

GET /v1/software/auto-upgrade/default Get software auto upgrade default #

PUT /v1/software/auto-upgrade/default Replace software auto upgrade default #

GET /v1/software/releases/download Get software releases download #

GET /v1/software/releases/summary Get software releases summary #

GET /v1/software/running/details Get software running details #

GET /v1/software/running/summary Get software running summary #

POST /v1/software/rollouts/schedule Create software rollouts schedule #

POST /v1/software/gcsrelease/upload/notes Create software gcsrelease upload notes #

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:graphiant-software-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 Software API
  version: 1.0.0
  description: Graphiant API documentation.
servers:
- url: https://api.graphiant.com
security:
- jwtAuth: []
tags:
- name: Software
paths:
  /v1/software/rollouts:
    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/v1SoftwareRolloutsPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1SoftwareRolloutsPostResponse'
      description: Create upgrade rollout and returns rollout identifier
      tags:
      - Software
      summary: Create software rollouts
      x-summary-source: derived
      operationId: postV1SoftwareRollouts
      x-operation-id-source: derived
    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/v1SoftwareRolloutsGetResponse'
      description: Returns all the configured upgrade rollouts
      tags:
      - Software
      summary: Get software rollouts
      x-summary-source: derived
      operationId: getV1SoftwareRollouts
      x-operation-id-source: derived
    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/v1SoftwareRolloutsPutRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1SoftwareRolloutsPutResponse'
      description: Modify update rollout
      tags:
      - Software
      summary: Replace software rollouts
      x-summary-source: derived
      operationId: putV1SoftwareRollouts
      x-operation-id-source: derived
  /v1/software/rollouts/{id}:
    delete:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: id
        in: path
        required: true
        description: Rollout identifier to delete.
        schema:
          type: integer
          format: int64
          example: 1234567891011
        example: 42
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1SoftwareRolloutsIdDeleteResponse'
      description: Delete given upgrade rollout
      tags:
      - Software
      summary: Delete software rollouts by id
      x-summary-source: derived
      operationId: deleteV1SoftwareRolloutsById
      x-operation-id-source: derived
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: id
        in: path
        required: true
        description: Rollout identifier to fetch.
        schema:
          type: integer
          format: int64
          example: 1234567891011
        example: 42
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1SoftwareRolloutsIdGetResponse'
      description: Returns details about given upgrade rollout
      tags:
      - Software
      summary: Get software rollouts by id
      x-summary-source: derived
      operationId: getV1SoftwareRolloutsById
      x-operation-id-source: derived
  /v1/software/auto-upgrade/default:
    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/v1SoftwareAutoUpgradeDefaultGetResponse'
      tags:
      - Software
      summary: Get software auto upgrade default
      x-summary-source: derived
      operationId: getV1SoftwareAutoUpgradeDefault
      x-operation-id-source: derived
    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/v1SoftwareAutoUpgradeDefaultPutRequest'
      responses:
        '204':
          description: No Content
      tags:
      - Software
      summary: Replace software auto upgrade default
      x-summary-source: derived
      operationId: putV1SoftwareAutoUpgradeDefault
      x-operation-id-source: derived
  /v1/software/releases/download:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: imageExt
        in: query
        description: GNOS Image type (qcow2 or ova)
        required: true
        schema:
          type: string
          example: example string
        example: qcow2
      - name: version
        in: query
        description: GNOS Image version
        required: true
        schema:
          type: string
          example: example string
        example: 9999.202406130322
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1SoftwareReleasesDownloadGetResponse'
      tags:
      - Software
      summary: Get software releases download
      x-summary-source: derived
      operationId: getV1SoftwareReleasesDownload
      x-operation-id-source: derived
  /v1/software/releases/summary:
    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/v1SoftwareReleasesSummaryGetResponse'
      tags:
      - Software
      summary: Get software releases summary
      x-summary-source: derived
      operationId: getV1SoftwareReleasesSummary
      x-operation-id-source: derived
  /v1/software/running/details:
    get:
      security:
      - jwtAuth: []
      parameters:
      - in: header
        name: Authorization
        required: true
        schema:
          type: string
        description: 'Bearer token. Format: Bearer <your_token_here>'
      - name: runningVersion
        in: query
        description: ''
        required: false
        schema:
          type: string
          example: example string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1SoftwareRunningDetailsGetResponse'
      tags:
      - Software
      summary: Get software running details
      x-summary-source: derived
      operationId: getV1SoftwareRunningDetails
      x-operation-id-source: derived
  /v1/software/running/summary:
    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/v1SoftwareRunningSummaryGetResponse'
      tags:
      - Software
      summary: Get software running summary
      x-summary-source: derived
      operationId: getV1SoftwareRunningSummary
      x-operation-id-source: derived
  /v1/software/rollouts/schedule:
    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/v1SoftwareRolloutsSchedulePostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1SoftwareRolloutsSchedulePostResponse'
      description: Schedule rollout to upgrade now, later or user-triggered
      tags:
      - Software
      summary: Create software rollouts schedule
      x-summary-source: derived
      operationId: postV1SoftwareRolloutsSchedule
      x-operation-id-source: derived
  /v1/software/gcsrelease/upload/notes:
    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/v1SoftwareGcsreleaseUploadNotesPostRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1SoftwareGcsreleaseUploadNotesPostResponse'
      tags:
      - Software
      summary: Create software gcsrelease upload notes
      x-summary-source: derived
      operationId: postV1SoftwareGcsreleaseUploadNotes
      x-operation-id-source: derived
components:
  schemas:
    upgradeGcsReleaseDetails:
      type: object
      properties:
        category:
          type: array
          items:
            $ref: '#/components/schemas/upgradeGcsReleaseCategory'
        major:
          type: boolean
          example: true
        releaseTs:
          $ref: '#/components/schemas/googleProtobufTimestamp'
      additionalProperties: false
    v1SoftwareRolloutsSchedulePostRequest:
      type: object
      properties:
        failedOnly:
          type: boolean
          example: true
          description: When true, only devices previously marked failed are rescheduled.
        id:
          type: integer
          format: int64
          example: 42
          description: Rollout identifier to schedule. (required)
        ts:
          $ref: '#/components/schemas/googleProtobufTimestamp'
      additionalProperties: false
      required:
      - id
    v1SoftwareRolloutsPutRequest:
      type: object
      properties:
        id:
          type: integer
          format: int64
          example: 42
          description: Rollout identifier to update. (required)
        rolloutConfig:
          $ref: '#/components/schemas/upgradeRolloutConfig'
      additionalProperties: false
      required:
      - id
      - rolloutConfig
    upgradeUpgradeOccurrence:
      type: object
      properties:
        dayOfWeek:
          type: string
          example: ENUM_VALUE
        hour:
          type: integer
          format: int32
          example: 123
        minute:
          type: integer
          format: int32
          example: 123
        occurrenceInMonth:
          type: integer
          format: int32
          example: 123
        ordinal:
          type: string
          example: ENUM_VALUE
        weekday:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    v1SoftwareRunningDetailsGetResponseDevice:
      type: object
      properties:
        deviceId:
          type: integer
          format: int64
          example: 1234567891011
        enterpriseId:
          type: integer
          format: int64
          example: 1234567891011
        enterpriseName:
          type: string
          example: example string
        hostname:
          type: string
          example: example string
      additionalProperties: false
    v1SoftwareRunningSummaryGetResponseVersionSummary:
      type: object
      properties:
        count:
          type: integer
          format: int32
          example: 123
          minimum: 0
        name:
          type: string
          example: example string
        version:
          type: string
          example: example string
      additionalProperties: false
    googleProtobufTimestamp:
      type: object
      properties:
        nanos:
          type: integer
          format: int32
          example: 123
        seconds:
          type: integer
          format: int64
          example: 1234567891011
      additionalProperties: false
    v1SoftwareRolloutsGetResponse:
      type: object
      properties:
        rollouts:
          type: array
          items:
            $ref: '#/components/schemas/upgradeRollout'
      additionalProperties: false
    v1SoftwareGcsreleaseUploadNotesPostResponse:
      type: object
      properties: {}
      additionalProperties: false
    upgradeRolloutDevice:
      type: object
      properties:
        deviceId:
          type: integer
          format: int64
          example: 1001
          description: Device identifier. (required)
        hostname:
          type: string
          example: edge-site-01
          description: Device hostname for display.
      additionalProperties: false
    upgradeYearlyRecurrence:
      type: object
      properties:
        date:
          type: integer
          format: int32
          example: 1
          minimum: 0
          description: Calendar day (1–31) for fixed month+date yearly recurrence.
        month:
          type: integer
          format: int32
          example: 3
          minimum: 0
          description: Month of year (1–12) for yearly recurrence. (required)
        ordinal:
          type: string
          example: First
          description: For nth-weekday-in-month yearly recurrence; use with weekday, or use month + date.
        weekday:
          type: string
          example: Wednesday
          description: Weekday paired with ordinal for yearly recurrence.
      additionalProperties: false
      required:
      - month
    v1SoftwareAutoUpgradeDefaultGetResponse:
      type: object
      properties:
        profile:
          $ref: '#/components/schemas/upgradeUpgradeCanaryProfile'
        release:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    v1SoftwareRolloutsSchedulePostResponse:
      type: object
      properties: {}
      additionalProperties: false
    upgradeWeeklyRecurrence:
      type: object
      properties:
        interval:
          type: integer
          format: int32
          example: 2
          minimum: 0
          description: Which occurrence of the weekday in the month applies for weekly-style recurrence (1–52, aligned with schedule validation). (required)
        weekday:
          type: string
          example: Monday
          description: Day of week for the weekly recurrence. (required)
      additionalProperties: false
      required:
      - interval
      - weekday
    upgradeReleaseSummary:
      type: object
      properties:
        eosTs:
          $ref: '#/components/schemas/googleProtobufTimestamp'
        key:
          $ref: '#/components/schemas/upgradeInventoryKey'
        name:
          type: string
          example: example string
        release:
          type: string
          example: ENUM_VALUE
        releaseTs:
          $ref: '#/components/schemas/googleProtobufTimestamp'
      additionalProperties: false
    v1SoftwareRunningSummaryGetResponse:
      type: object
      properties:
        versions:
          type: array
          items:
            $ref: '#/components/schemas/v1SoftwareRunningSummaryGetResponseVersionSummary'
      additionalProperties: false
    v1SoftwareRunningDetailsGetResponse:
      type: object
      properties:
        devices:
          type: array
          items:
            $ref: '#/components/schemas/v1SoftwareRunningDetailsGetResponseDevice'
      additionalProperties: false
    v1SoftwareRolloutsPostRequest:
      type: object
      properties:
        rolloutConfig:
          $ref: '#/components/schemas/upgradeRolloutConfig'
      additionalProperties: false
      required:
      - rolloutConfig
    v1SoftwareRolloutsIdGetResponse:
      type: object
      properties:
        rollout:
          $ref: '#/components/schemas/upgradeRollout'
      additionalProperties: false
    v1SoftwareReleasesSummaryGetResponse:
      type: object
      properties:
        summaries:
          type: array
          items:
            $ref: '#/components/schemas/upgradeReleaseSummary'
      additionalProperties: false
    v1SoftwareReleasesDownloadGetResponse:
      type: object
      properties:
        imageLink:
          type: string
          example: example string
      additionalProperties: false
    v1SoftwareRolloutsIdDeleteResponse:
      type: object
      properties: {}
      additionalProperties: false
    v1SoftwareRolloutsPostResponse:
      type: object
      properties:
        id:
          type: integer
          format: int64
          example: 42
          description: Identifier of the created rollout. (required)
      additionalProperties: false
    upgradeRollout:
      type: object
      properties:
        devices:
          type: array
          items:
            $ref: '#/components/schemas/upgradeRolloutDevice'
        hasFailed:
          type: boolean
          example: true
          description: True if any device in the rollout has a failed upgrade state.
        id:
          type: integer
          format: int64
          example: 42
          description: Server-assigned rollout identifier.
        lastRunTs:
          $ref: '#/components/schemas/googleProtobufTimestamp'
        nextRunTs:
          $ref: '#/components/schemas/googleProtobufTimestamp'
        numDevices:
          type: integer
          format: int32
          example: 3
          description: Count of devices associated with the rollout.
        rolloutConfig:
          $ref: '#/components/schemas/upgradeRolloutConfig'
        status:
          type: string
          example: idle
          description: Status of the upgrade rollout group
      additionalProperties: false
    v1SoftwareGcsreleaseUploadNotesPostRequest:
      type: object
      properties:
        details:
          $ref: '#/components/schemas/upgradeGcsReleaseDetails'
      additionalProperties: false
    upgradeMonthlyRecurrence:
      type: object
      properties:
        date:
          type: integer
          format: int32
          example: 15
          minimum: 0
          description: Calendar day of month (1–31) for fixed-date monthly recurrence; optional if ordinal and weekday are set.
        ordinal:
          type: string
          example: Second
          description: For nth-weekday-of-month style recurrence; use together with weekday, or use date instead.
        weekday:
          type: string
          example: Tuesday
          description: Weekday paired with ordinal for monthly nth-weekday recurrence; optional if date is set.
      additionalProperties: false
    upgradeRolloutConfig:
      type: object
      properties:
        action:
          type: string
          example: InstallActivate
          description: Upgrade action to perform (e.g. install+activate, install only, activate, auto-upgrade). (required)
        description:
          type: string
          example: Upgrade branch sites to release 25.4
          description: Optional longer description of the rollout.
        deviceIds:
          type: array
          items:
            type: integer
            format: int64
            example: 1001,1002,1003
            description: Device IDs included in the rollout (field name retained for API compatibility).
        name:
          type: string
          example: Q2 edge upgrade
          description: Human-readable rollout name unique within the enterprise. (required)
        release:
          type: string
          example: Recommended
          description: Target software release for devices in this rollout. (required)
        schedule:
          $ref: '#/components/schemas/upgradeRecurringSchedule'
      additionalProperties: false
      required:
      - action
      - name
      - release
    upgradeInventoryKey:
      type: object
      properties:
        model:
          type: integer
          format: int32
          example: 123
          minimum: 0
        version:
          type: string
          example: example string
      additionalProperties: false
    v1SoftwareRolloutsPutResponse:
      type: object
      properties: {}
      additionalProperties: false
    upgradeGcsReleaseCategory:
      type: object
      properties:
        content:
          type: string
          example: example string
        title:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    v1SoftwareAutoUpgradeDefaultPutRequest:
      type: object
      properties:
        profile:
          $ref: '#/components/schemas/upgradeUpgradeCanaryProfile'
        release:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    upgradeUpgradeCanaryProfile:
      type: object
      properties:
        action:
          type: string
          example: ENUM_VALUE
        name:
          type: string
          example: example string
        occurrence:
          $ref: '#/components/schemas/upgradeUpgradeOccurrence'
        release:
          type: string
          example: ENUM_VALUE
      additionalProperties: false
    upgradeRecurringSchedule:
      type: object
      properties:
        monthly:
          $ref: '#/components/schemas/upgradeMonthlyRecurrence'
        startsAtTs:
          $ref: '#/components/schemas/googleProtobufTimestamp'
        weekly:
          $ref: '#/components/schemas/upgradeWeeklyRecurrence'
        yearly:
          $ref: '#/components/schemas/upgradeYearlyRecurrence'
      additionalProperties: false
      required:
      - startsAtTs
  securitySchemes:
    jwtAuth:
      type: apiKey
      in: header
      name: authorization
      description: Use `Bearer <token>`

Graphiant Software API

Operations 13

Documentation

Specifications

Schemas & Data

Other Resources