API Authentication

All API requests require authentication via an API key or access token.

Looking for the full endpoint catalog? See the interactive API Reference, generated from the live API definitions.

API Keys

Generate an API key from Settings → API Keys in the web app. Include it as a Bearer token:

curl -H "Authorization: Bearer <api-key>" \
  https://api.hyperfile.io/fs

Access Tokens

If you're building an integration that uses the OAuth flow, you'll receive access and refresh tokens. Access tokens expire after 15 minutes and must be refreshed.

Base URL

Error Responses

All errors return a consistent JSON structure:

{
  "error": {
    "message": "Human-readable description",
    "code": "machine_readable_code",
    "status": 401
  }
}

Common Error Codes