Aha.io

Aha.io Account backups API

The Account backups API from Aha.io — 3 operation(s) for account backups.

Documentation GitHub OpenAPI

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/aha-account-backups-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 email required.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.1.0
info:
  title: Aha! Account backups API
  version: 1.0.0
  description: Complete API documentation for Aha! generated from actual test responses
  contact:
    name: Aha! Support
    url: https://www.aha.io/support
servers:
- url: https://{account-domain}.aha.io/api/v1
  description: Aha! API Server
  variables:
    account-domain:
      description: Your Aha! account domain
      default: company
security:
- OAuth2: []
- ApiKeyAuth: []
- CookieAuth: []
tags:
- name: Account backups
paths:
  /api/v1/account_backups:
    get:
      summary: List account backups
      description: "Account backups let you create a complete off-site backup of your Aha! account.\nThey can be [created](/api/resources/account_backups/create_an_account_backup),\n[listed](/api/resources/account_backups/list_account_backups), and [downloaded](/api/resources/account_backups/download_an_account_backup) via the API.\n\nAn account backup may only be created once every 24 hours.\n\nThe backup file contains a representation of all of the data in the Aha! account, including all relationships. \nIt does not contain user authentication data or integration secrets. The backup does not include any uploaded files.\n\n**[Account backups](https://www.aha.io/support/roadmaps/account/security-and-system-requirements/export-backup-aha-data) are an Enterprise+ exclusive feature.**"
      tags:
      - Account backups
      parameters: []
      responses:
        '200':
          description: Successful operation
          headers:
            Content-Type:
              description: application/json; charset=utf-8
              schema:
                type: string
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/AccountbackupsGetResponse'
              example:
                account_backups:
                - id: '1'
                  status_code: 2
                  status_description: Completed
                  created_at: '2019-01-01T00:00:00.000Z'
                  file_size: ''
                  download_url: http://company.aha.io/api/v1/account_backups/1.tgz
                - id: '2'
                  status_code: 2
                  status_description: Completed
                  created_at: '2019-01-01T00:00:00.000Z'
                  file_size: ''
                  download_url: http://company.aha.io/api/v1/account_backups/2.tgz
      security:
      - OAuth2: []
      - ApiKeyAuth: []
      - CookieAuth: []
    post:
      summary: Create an account backup
      description: "The backup may take some time to generate (as long as ten minutes in a \nlarge account). You should poll the GET endpoint to see when the backup \nis complete. You should not poll more frequently than once every twenty \nseconds. Returns an HTTP status of 429 if a backup was already created\nwithin the last 24 hours."
      tags:
      - Account backups
      parameters: []
      responses:
        '200':
          description: Successful operation
          headers:
            Content-Type:
              description: application/json; charset=utf-8
              schema:
                type: string
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/AccountbackupsPostResponse'
              example:
                account_backup:
                  id: '6776881149498172525'
                  status_code: 0
                  status_description: In Queue
                  created_at: '2019-01-01T00:00:00.000Z'
      security:
      - OAuth2: []
      - ApiKeyAuth: []
      - CookieAuth: []
  /api/v1/account_backups/{id}:
    get:
      summary: Get a specific account backup
      description: 'The status field indicates whether the backup is ready. The possible

        values are: 0 (queued), 1 (in progress), 2 (completed), 3 (error).'
      tags:
      - Account backups
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Id identifier
      responses:
        '200':
          description: Successful operation
          headers:
            Content-Type:
              description: application/json; charset=utf-8
              schema:
                type: string
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/AccountbackupsGetResponse'
              example:
                account_backup:
                  id: '6776881149499462668'
                  status_code: 3
                  status_description: Error
                  created_at: '2019-01-01T00:00:00.000Z'
      security:
      - OAuth2: []
      - ApiKeyAuth: []
      - CookieAuth: []
  /api/v1/account_backups/{id}.tgz:
    get:
      summary: Download an account backup
      description: "Account backups let you create a complete off-site backup of your Aha! account.\nThey can be [created](/api/resources/account_backups/create_an_account_backup),\n[listed](/api/resources/account_backups/list_account_backups), and [downloaded](/api/resources/account_backups/download_an_account_backup) via the API.\n\nAn account backup may only be created once every 24 hours.\n\nThe backup file contains a representation of all of the data in the Aha! account, including all relationships. \nIt does not contain user authentication data or integration secrets. The backup does not include any uploaded files.\n\n**[Account backups](https://www.aha.io/support/roadmaps/account/security-and-system-requirements/export-backup-aha-data) are an Enterprise+ exclusive feature.**"
      tags:
      - Account backups
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Id identifier
      responses:
        '200':
          description: Successful operation
          headers:
            Content-Type:
              description: application/gzip
              schema:
                type: string
      security:
      - OAuth2: []
      - ApiKeyAuth: []
      - CookieAuth: []
components:
  schemas:
    AccountbackupsGetResponse:
      type: object
      properties:
        account_backup:
          type: object
          properties:
            id:
              type: string
              example: '6776881149499462668'
            status_code:
              type: integer
              example: 3
            status_description:
              type: string
              example: Error
            created_at:
              type: string
              example: '2019-01-01T00:00:00.000Z'
          example:
            id: '6776881149499462668'
            status_code: 3
            status_description: Error
            created_at: '2019-01-01T00:00:00.000Z'
      example:
        account_backup:
          id: '6776881149499462668'
          status_code: 3
          status_description: Error
          created_at: '2019-01-01T00:00:00.000Z'
    AccountbackupsPostResponse:
      type: object
      properties:
        account_backup:
          type: object
          properties:
            id:
              type: string
              example: '6776881149498172525'
            status_code:
              type: integer
              example: 0
            status_description:
              type: string
              example: In Queue
            created_at:
              type: string
              example: '2019-01-01T00:00:00.000Z'
          example:
            id: '6776881149498172525'
            status_code: 0
            status_description: In Queue
            created_at: '2019-01-01T00:00:00.000Z'
      example:
        account_backup:
          id: '6776881149498172525'
          status_code: 0
          status_description: In Queue
          created_at: '2019-01-01T00:00:00.000Z'
  securitySchemes:
    OAuth2:
      type: oauth2
      description: OAuth2 authentication with bearer tokens
      flows:
        authorizationCode:
          authorizationUrl: https://{account-domain}.aha.io/oauth/authorize
          tokenUrl: https://{account-domain}.aha.io/oauth/token
          scopes: {}
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: API key authentication using Bearer token in Authorization header. Generate API keys at https://secure.aha.io/settings/api_keys
    CookieAuth:
      type: apiKey
      in: cookie
      name: session
      description: Cookie-based authentication for web browser integration