YugabyteDB

YugabyteDB Isolated Backup API

Isolated backup/restore of YBA to local filesystem

Documentation GitHub OpenAPI

Operations 2

POST /customers/{cUUID}/yba-backups Create YBA Backup #

POST /customers/{cUUID}/yba-backups/restore Restore YBA Backup #

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-isolated-backup-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: Yugabytedb Isolated Backup API
  version: v2
  contact:
    email: support@yugabyte.com
    name: YugabyteDB Anywhere Support
    url: 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
  description: 'Operations tagged Isolated Backup across 2 of this provider''s published API definitions: openapi.yaml, yugabytedb-anywhere-v2-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- description: API endpoint of YBA server
  url: '{protocol}://{host_port}/api/v2'
  variables:
    protocol:
      default: http
      enum:
      - http
      - https
    host_port:
      default: localhost:9000
tags:
- description: Isolated backup/restore of YBA to local filesystem
  name: Isolated Backup
paths:
  /customers/{cUUID}/yba-backups:
    post:
      description: Trigger a one time backup of YBA to the desired storage location
      operationId: CreateYbaBackup
      parameters:
      - description: Customer UUID
        explode: false
        in: path
        name: cUUID
        required: true
        schema:
          format: uuid
          type: string
        style: simple
      requestBody:
        $ref: '#/components/requestBodies/IsolatedBackupCreateReq'
      responses:
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/YBATask'
          description: task accepted
        '400':
          description: Invalid input
        '500':
          description: Server error
      security:
      - apiKeyAuth: []
      summary: Create YBA Backup
      tags:
      - Isolated Backup
      x-yba-api-audit:
        auditTargetType: IsolatedBackup
        auditTargetId: 'null'
        auditActionType: Create
      x-yba-api-authz:
      - requiredPermission:
          resourceType: other
          action: SUPER_ADMIN_ACTIONS
        resourceLocation:
          path: customers
          sourceType: endpoint
      x-yba-api-since: 2024.2.0.0
      x-yba-api-visibility: preview
      x-content-type: application/json
      x-accepts:
      - application/json
    servers:
    - description: API endpoint of YBA server
      url: '{protocol}://{host_port}/api/v2'
      variables:
        protocol:
          default: http
          enum:
          - http
          - https
        host_port:
          default: localhost:9000
  /customers/{cUUID}/yba-backups/restore:
    post:
      description: Trigger a one time restore of YBA from the desired storage location
      operationId: RestoreYbaBackup
      parameters:
      - description: Customer UUID
        explode: false
        in: path
        name: cUUID
        required: true
        schema:
          format: uuid
          type: string
        style: simple
      requestBody:
        $ref: '#/components/requestBodies/IsolatedBackupRestoreReq'
      responses:
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/YBATask'
          description: task accepted
        '400':
          description: Invalid input
        '500':
          description: Server error
      security:
      - apiKeyAuth: []
      summary: Restore YBA Backup
      tags:
      - Isolated Backup
      x-yba-api-audit:
        auditTargetType: IsolatedBackup
        auditTargetId: 'null'
        auditActionType: Restore
      x-yba-api-authz:
      - requiredPermission:
          resourceType: other
          action: SUPER_ADMIN_ACTIONS
        resourceLocation:
          path: customers
          sourceType: endpoint
      x-yba-api-since: 2024.2.0.0
      x-yba-api-visibility: preview
      x-content-type: application/json
      x-accepts:
      - application/json
    servers:
    - description: API endpoint of YBA server
      url: '{protocol}://{host_port}/api/v2'
      variables:
        protocol:
          default: http
          enum:
          - http
          - https
        host_port:
          default: localhost:9000
components:
  requestBodies:
    IsolatedBackupCreateReq:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/IsolatedBackupCreateSpec'
      required: true
    IsolatedBackupRestoreReq:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/IsolatedBackupRestoreSpec'
      required: true
    IsolatedBackupCreateReq_2:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/IsolatedBackupCreateSpec_2'
          examples:
            IsolatedBackupCreateReqExample:
              summary: Default IsolatedBackupCreateReq request
              x-microcks-default: true
              value:
                components:
                - YBA
                - YBA
                local_dir: /opt/yba_backups
      required: true
    IsolatedBackupRestoreReq_2:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/IsolatedBackupRestoreSpec'
          examples:
            IsolatedBackupRestoreReqExample:
              summary: Default IsolatedBackupRestoreReq request
              x-microcks-default: true
              value:
                local_path: /opt/yba_backups/yba_backup.tar.gz
      required: true
  schemas:
    YBATask:
      description: 'YBATask


        YugabyteDB Anywhere Task object is used to represent a task that is being executed on a resource. This Task object can be polled for progress and status of the task. This object is returned as a response to most of the YugabyteDB Anywhere API calls.

        '
      example:
        resource_uuid: f33e3c9b-75ab-4c30-80ad-cba85646ea39
        task_uuid: 89a46d52-4edd-4736-922a-35177a0b990c
      properties:
        resource_uuid:
          description: UUID of the resource being modified by the task
          example: f33e3c9b-75ab-4c30-80ad-cba85646ea39
          format: uuid
          readOnly: true
          type: string
        task_uuid:
          description: Task UUID
          example: 89a46d52-4edd-4736-922a-35177a0b990c
          format: uuid
          readOnly: true
          type: string
      title: YBATask
      type: object
    IsolatedBackupCreateSpec:
      description: 'IsolatedBackupCreateSpec


        User provided details to trigger a one time backup of YBA to a particular local directory.

        '
      example:
        components:
        - YBA
        - YBA
        local_dir: /opt/yba_backups
      properties:
        local_dir:
          description: local directory to store backup
          example: /opt/yba_backups
          type: string
        components:
          description: the components to include in YBA backup
          items:
            $ref: '#/components/schemas/YbaComponent'
          type: array
      required:
      - components
      - local_dir
      title: IsolatedBackupCreateSpec
      type: object
    IsolatedBackupRestoreSpec:
      description: 'IsolatedBackupRestoreSpec


        User provided details to trigger a restore of YBA from a local filepath.

        '
      example:
        local_path: /opt/yba_backups/yba_backup.tar.gz
      properties:
        local_path:
          description: full path to YBA backup file on host
          example: /opt/yba_backups/yba_backup.tar.gz
          type: string
      required:
      - local_path
      title: IsolatedBackupRestoreSpec
      type: object
    YbaComponent:
      description: 'Individual YBA components to be backed up

        '
      enum:
      - YBA
      - PROMETHEUS
      - RELEASES
      title: YbaComponent
      type: string
    IsolatedBackupCreateSpec_2:
      description: 'IsolatedBackupCreateSpec


        User provided details to trigger a one time backup of YBA to a particular local directory.

        '
      example:
        components:
        - YBA
        - YBA
        local_dir: /opt/yba_backups
      properties:
        local_dir:
          description: local directory to store backup
          example: /opt/yba_backups
          type: string
        components:
          description: the components to include in YBA backup
          items:
            $ref: '#/components/schemas/YbaComponent'
          type: array
          example:
          - YBA
      required:
      - components
      - local_dir
      title: IsolatedBackupCreateSpec
      type: object
  securitySchemes:
    apiKeyAuth:
      in: header
      name: X-AUTH-YW-API-TOKEN
      type: apiKey
x-refined-from:
- openapi.yaml
- yugabytedb-anywhere-v2-openapi.yaml