API reference

The REST API is available at https://fr.pushbyte.cc/api/v1. Authenticate with a bearer token from Settings → API keys.

Push metrics

curl -X POST https://fr.pushbyte.cc/api/v1/series \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"series":[{"metric":"queue.depth","points":[[1735689600,42]]}]}'

Query

curl -G https://fr.pushbyte.cc/api/v1/query \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode 'q=avg:queue.depth{service:ingest}'

Rate limits

1,000 requests per minute per token. Responses include X-RateLimit-Remaining and Retry-After when throttled.

Status codes

Code	Meaning
200	OK
202	Accepted (async ingest)
401	Missing or invalid token
429	Rate limited