API Reference

The Spronta REST API handles image uploads, management, presets, and signing configuration. The CDN itself is just URL parameters — no API calls needed for delivery.

Base URL: https://app.spronta.com/api

Authentication: All endpoints require a Bearer token (your project API key).

curl -H "Authorization: Bearer spronta_img_..." \
  https://app.spronta.com/api/images/projects

OpenAPI spec: Download the full spec at /openapi.yaml for use with code generators, Postman, or any OpenAPI-compatible tool.

Sections

• Projects — Create, list, update, and delete image projects
• Upload — Upload images via presigned URLs
• Images — List, update metadata, and delete images
• Presets — Named transform presets
• Signing — URL signing configuration and generation
• Usage — Usage analytics and metrics

Error format

All errors return JSON with an error field:

{ "error": "Image not found" }

Validation errors include a details field with per-field errors:

{
  "error": "Validation failed",
  "details": {
    "fieldErrors": { "name": ["String must contain at least 1 character(s)"] },
    "formErrors": []
  }
}

HTTP status codes

Code	Meaning
200	Success
201	Created
400	Validation error or bad request
401	Missing or invalid API key
403	Forbidden (limit reached or signing required)
404	Resource not found
409	Conflict (duplicate name)