Overview

Drive your files and your CDN from your own code. Plain REST, plain JSON, no SDK to install. If you can make an HTTP request, you already know this API.

Base URL   https://api.hypastack.com/v3

Your first call

export HYPASTACK_API_KEY="hsk_your_key_here"

curl "https://api.hypastack.com/v3/files" \
  -H "Authorization: Bearer $HYPASTACK_API_KEY"

That returns your files. If it returns 401, the key is wrong. If it returns 403 plan_required, your plan has no API access, see Pricing & Plans.

Getting a key

Open Settings → Account, turn on Developer mode, then go to the Developer tab and hit New key. Pick a name and tick only the permissions you need. The key is shown once and never again, so copy it then. Full walkthrough in Account & Passkeys.

What’s covered here

Authentication & Scopes

Bearer tokens and the six scopes a key can hold.

Uploading

The three-step reserve / PUT / commit flow.

Pagination

Cursor-based, not offsets.

Errors

One error shape, switch on the code.

Rate Limits

Per-key budgets by plan.

Full Example

One runnable script covering everything.

Guide

Endpoints

Your first call

Getting a key

What’s covered here

Authentication & Scopes

Uploading

Pagination

Errors

Rate Limits

Full Example

​Your first call

​Getting a key

​What’s covered here

Authentication & Scopes

Uploading

Pagination

Errors

Rate Limits

Full Example

Your first call

Getting a key

What’s covered here