Integrate

API Reference

The Parabellum OS API is a Fastify-based REST surface tunneled through Cloudflare. All endpoints require a bearer token issued at the operator level.

Base URL

https://api.parabellum.tech

Authentication

Pass Authorization: Bearer <token> on every request. Tokens are scoped to a single operator and can be rotated from the Command Interface.

bash

curl https://api.parabellum.tech/v1/operator \
  -H "Authorization: Bearer $PRBL_TOKEN"

60 requests per minute per token. Burst capacity of 20. Exceeded limits return 429 with a Retry-After header.

GET/v1/operator

Returns the authenticated operator profile.

GET/v1/missions

Lists missions for the authenticated operator.

Param	Type	Required	Description
state	string	no	Filter by mission state.
limit	number	no	Page size. Default 25.
cursor	string	no	Pagination cursor from a prior response.

POST/v1/missions

Creates a new mission.

Param	Type	Required	Description
type	string	yes	Mission type identifier.
payload	object	yes	Mission-specific payload.
priority	number	no	Optional priority hint for the orchestrator.

GET/v1/signals

Lists verified biometric signals.

POST/v1/signals

Submits a manual signal for verification.

GET/v1/rewards

Lists settled PRBL rewards.

GET/v1/agents

Lists available agents and their current state.

Standard HTTP codes. Error body returns { code, message, request_id }. Include the request_id when filing issues.

json

{
  "code": "rate_limited",
  "message": "Too many requests.",
  "request_id": "req_01HXYZAB12345"
}