BioFlow
API Reference

Get API usage

GET /v1/usage — Current billing-period API usage: requests used/remaining against the plan's monthly quota, the reset instant, and the per-key burst limit. Polling…

GET
/v1/usage

Current billing-period API usage: requests used/remaining against the plan's monthly quota, the reset instant, and the per-key burst limit. Polling this endpoint never consumes quota.

Requires scope: pages:read or pages:write or analytics:read or contacts:read or files:read or publish. Plan entitlement: public_api (Creator and Pro).

Authorization

AuthorizationBearer <token>

API key (bf_live_… / bf_test_…) as a Bearer token.

In: header

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/usage"
{  "plan": "string",  "period_start": "2019-08-24T14:15:22Z",  "period_end": "2019-08-24T14:15:22Z",  "meters": [    {      "name": "string",      "used": 0,      "limit": 0,      "remaining": 0    }  ],  "burst": {    "per_minute": -9007199254740991  }}

List files GET

GET /v1/files — The workspace's uploaded files (name, MIME type, size, public path), newest first. Pass a file's public_path as file_url to Add block to wire it…

List webhook endpoints GET

GET /v1/webhook-endpoints — Every webhook endpoint in the workspace (at most 10 — no pagination). Signing secrets are never included. Requires scope webhooks:read.