API Reference

The Upblit backend exposes a REST API on port 8080. All endpoints (except OAuth2 callbacks and SDK ingest) require a valid JWT.

Base URL

http://localhost:8080        # local development
https://api.upblit.com       # production (when deployed)

Authentication

Most endpoints require a JWT Bearer token:

Authorization: Bearer {your-jwt-token}

SDK ingest endpoints use an API key instead:

x-api-key: {your-api-key}

See Authentication for details.

Endpoint Groups

OpenAPI / Swagger

An interactive API reference is available at the Swagger UI:

Upblit/swagger/swagger/

The OpenAPI spec is at Upblit/swagger/swagger/public/swagger.json.

Response Format

All endpoints return JSON. Error responses include a message:

{
  "message": "Organization not found",
  "status": 404
}

Pagination

Some list endpoints support pagination via page and size query parameters. Paginated responses use the PaginatedResponse<T> wrapper:

{
  "content": [...],
  "totalElements": 42,
  "totalPages": 5,
  "page": 0,
  "size": 10
}