Discourse

Discourse Backups API

The Backups API from Discourse — 2 operation(s) for backups.

Documentation GitHub OpenAPI

Operations 4

GET /admin/backups.json List backups #

POST /admin/backups.json Create backup #

PUT /admin/backups/{filename} Send download backup email #

GET /admin/backups/{filename} Download 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/discourse-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 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: Discourse API Documentation Backups API
  x-logo:
    url: https://docs.discourse.org/logo.svg
  version: latest
  description: This page contains the documentation on how to use Discourse through API calls.
  license:
    name: MIT
    url: https://docs.discourse.org/LICENSE.txt
servers:
- url: https://{defaultHost}
  variables:
    defaultHost:
      default: discourse.example.com
tags:
- name: Backups
paths:
  /admin/backups.json:
    get:
      summary: List backups
      tags:
      - Backups
      operationId: getBackups
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                minItems: 1
                uniqueItems: true
                items:
                  type: object
                  properties:
                    filename:
                      type: string
                    size:
                      type: integer
                    last_modified:
                      type: string
                  required:
                  - filename
                  - size
                  - last_modified
    post:
      summary: Create backup
      tags:
      - Backups
      operationId: createBackup
      parameters: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  success:
                    type: string
                    example: OK
                required:
                - success
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: false
              properties:
                with_uploads:
                  type: boolean
              required:
              - with_uploads
  /admin/backups/{filename}:
    put:
      summary: Send download backup email
      tags:
      - Backups
      operationId: sendDownloadBackupEmail
      parameters:
      - name: filename
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: success response
    get:
      summary: Download backup
      tags:
      - Backups
      operationId: downloadBackup
      parameters:
      - name: filename
        in: path
        required: true
        schema:
          type: string
      - name: token
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: success response