API
The API reference is being prepared.
- Docs
- API
On this page
Envelope
Every response uses the same envelope: d holds the payload or the error code, s is ok or error, t is an ISO 8601 timestamp.
Success
{
"d": { "items": [] },
"s": "ok",
"t": "2026-11-03T12:05:00.000Z"
}Error
{
"d": "careers_posting_not_found",
"s": "error",
"t": "2026-11-03T10:00:00.000Z"
}Errors
On an error, d is a machine-readable error code and the HTTP status tells the kind of problem.
- 404: the resource does not exist, for example careers_posting_not_found.
- 429: too many requests. Slow down and cache responses.
Authentication
- Public endpoints need no key or token.
- Signed-in calls use your user session (JWT).
- Sign-in uses OpenID Connect (Authorization Code with PKCE). The discovery document (/.well-known/openid-configuration) and the JWKS (/.well-known/jwks.json) are public.
Public endpoints
| Method | Path | Auth | Returns | Example |
|---|---|---|---|---|
| GET | /apps/catalog | Public | The app catalog. | — |
| GET | /apps/catalog/top?limit=3 | Public | Top apps; limit sets how many. | — |
| GET | /apps/:slug | Public | One app by its slug. | — |
| GET | /news/public | Public | Published release notes, newest first (60 requests per minute). | See example |
| GET | /news/public/:version | Public | One release with its article; 404 release_not_found for an unknown version. | See example |
| GET | /careers | Public | Open positions. | — |
| GET | /careers/:slug | Public | One open position by its slug; 404 careers_posting_not_found. | — |
Examples
GET /news/public
{
"d": {
"items": [
{
"id": "7290000000000000031",
"app": "ultralabs",
"version": "0.31.0",
"publishedAt": "2026-11-03T12:00:00.000Z",
"summary": { "sk": "Bezpečnostná oprava prihlásenia.", "en": "Sign-in security fix." },
"items": [
{
"type": "fixed",
"text": {
"sk": "Kontrola pôvodu pri lazy claime, claim URL na Studio hoste.",
"en": "Lazy claim origin check, claim URL on the Studio host."
}
}
],
"announce": false
}
]
},
"s": "ok",
"t": "2026-11-03T12:05:00.000Z"
}GET /news/public/:version
{
"d": {
"release": {
"id": "7290000000000000031",
"app": "ultralabs",
"version": "0.31.0",
"publishedAt": "2026-11-03T12:00:00.000Z",
"summary": { "sk": "Bezpečnostná oprava prihlásenia.", "en": "Sign-in security fix." },
"items": [],
"announce": false,
"body": { "sk": "## Čo sa zmenilo\n…", "en": "## What changed\n…" }
}
},
"s": "ok",
"t": "2026-11-03T12:05:00.000Z"
}Conventions
- IDs are strings, never numbers.
- Dates are ISO 8601 timestamps.
- Amounts are integers in cents.
- Localized fields hold sk and optionally en and de. Show the requested language, then English, then Slovak.