Documentation
Public API

Informations

The public API is currently under development. Some elements may be subject to change. Announcements will be made on our Discord. For more information, please contact us on Discord.

Overview

The DiapStash Public API enables secure, read-oriented access to your Cloud Sync data outside of the DiapStash application.
It is designed for developers who want to integrate DiapStash datasets into their services, dashboards, or automation workflows.

  • Base URL: https://api.diapstash.com
  • OpenAPI/Swagger documentation: https://api.diapstash.com/api/docs

Requirements

Before calling the API, ensure the following prerequisites are met:

  1. Cloud Sync linked to DiapStash account
    • Your DiapStash account must be linked with your Cloud Sync.
      You can link your Cloud Sync to your DiapStash account in the app's settings under the "Cloud Sync" section (you must have a Cloud Sync account from
  2. Registered API client (OAuth 2.0)
    • You must register an API client in your DiapStash account to obtain your client credentials.
    • These credentials are required to perform OAuth 2.0 flows and obtain access tokens.

Long term access for server-side services

If your service follows its users from your own servers over months, refreshing a token per user quickly becomes impractical. A restricted mode lets you hold one long term access token per consenting user and read the ordinary API endpoints with it, without anyone signing in again.

It is granted client by client, after a justified request: see Long Term Access.

Support

Questions or issues: Please reach out via our Discord