← Back to Home

ArkSpace RESTful API v2

Integrate our zero-knowledge storage engine directly into your applications using our RESTful API. All requests must be authenticated using Bearer Tokens.

Authentication

curl -X POST https://api.arkspace.io/v2/auth \
-H "Content-Type: application/json" \
-d '{"client_id": "YOUR_ID", "client_secret": "YOUR_SECRET"}'

Endpoints

GET /v2/files/list - Retrieves a list of objects in your current bucket.

POST /v2/files/upload - Uploads an encrypted blob. (Max chunk size: 5GB).

DELETE /v2/files/{object_id} - Permanently purges the ciphertext from all edge nodes.

Rate Limits

To ensure stability across the network, API requests are rate-limited to 1,000 requests per IP per minute. Exceeding this limit will result in a 429 Too Many Requests response.