Public API / v1

Fluxus Central read API

Versioned, read-only JSON responses for public Fluxus Central data. The browser and external consumers never receive database credentials or raw database records.

Check API health Safe public contract
Response contract{ data, meta: { apiVersion, generatedAt, dataStatus, nextCursor, hasMore } }Errors use { error: { code, message, requestId } }. Provenance-bearing records include source, source kind, canonical URL, observation time, confidence when classified, and whether the source is official.

Query parameters

limit1–50 records; defaults to 20.
cursorOpaque cursor returned by the previous page.
repositoryApproved repository in owner/name format.
from / toInclusive calendar filters in YYYY-MM-DD format.
branch / author / changeTypeCommit and finding filters where supported.
source / state / status / platform / typeDomain-specific filters used by feed, issue, artifact and release lists.

Examples

Successful empty list
{
  "data": [],
  "meta": {
    "apiVersion": "v1",
    "dataStatus": "fresh",
    "nextCursor": null,
    "hasMore": false
  }
}
Error
{
  "error": {
    "code": "INVALID_QUERY",
    "message": "One or more query parameters are invalid.",
    "requestId": "request-id"
  }
}

Endpoint reference

GET/api/v1/overview

Homepage overview with partial-data support.

GET/api/v1/status

Fluxer service status summary.

GET/api/v1/status/services

Publicly safe monitored services.

GET/api/v1/status/services/:key

One service and its stored summary.

GET/api/v1/status/services/:key/history

Stored observations for one service.

GET/api/v1/status/history?service=:key

Historical observations for a selected service.

GET/api/v1/development/commits

Allowlisted commit records with cursor pagination.

GET/api/v1/development/commits/:sha

One allowlisted commit record.

GET/api/v1/commits/:sha

Short alias for one allowlisted commit record.

GET/api/v1/development/findings

Fluxus findings with evidence and confidence.

GET/api/v1/releases

Allowlisted releases with cursor pagination.

GET/api/v1/releases/:owner/:name/:tag

One allowlisted release.

GET/api/v1/builds

Release artifacts, never CI jobs.

GET/api/v1/rollouts

Stored rollout-derived states without fabricated percentages.

GET/api/v1/missions

Allowlisted public issues classified as missions.

GET/api/v1/news

Configured public news feed records.

GET/api/v1/articles

Public article/help/changelog records.

GET/api/v1/videos

Public video records identifiable from configured feeds.

GET/api/v1/repositories

Explicitly allowlisted repositories only.

GET/api/v1/sources

Safe source classes and configured public origins.

GET/api/v1/health

Safe Fluxus Central read-layer health.

Rate limits are applied per client address and returned through X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. A limited response uses HTTP 429 and Retry-After. Successful reads include ETag and explicit cache semantics.