# API Reference

> Every BioFlow /v1 operation — 22 endpoints with parameters, schemas, examples, and a request builder, rendered from the OpenAPI 3.1 spec.

Page: https://getbioflow.com/docs/api-reference

{/* Generated by apps/docs/scripts/generate-api-surface.mjs from openapi/v1.json — do not edit by hand. */}

The full BioFlow `/v1` surface, rendered from the
[OpenAPI 3.1 spec](https://getbioflow.com/docs/api/openapi.json). Start with the
[API documentation hub](https://getbioflow.com/docs/api) for auth, quotas, pagination, idempotency,
and the error registry.

| Operation                                                          | Endpoint                                                                   | Scope                                                                       |
| ------------------------------------------------------------------ | -------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| [Get analytics summary](https://getbioflow.com/docs/api-reference/getAnalyticsSummary)        | `GET /v1/analytics/summary`                                                | analytics:read                                                              |
| [List contacts](https://getbioflow.com/docs/api-reference/listContacts)                       | `GET /v1/contacts`                                                         | contacts:read                                                               |
| [List files](https://getbioflow.com/docs/api-reference/listFiles)                             | `GET /v1/files`                                                            | files:read                                                                  |
| [List pages](https://getbioflow.com/docs/api-reference/listPages)                             | `GET /v1/pages`                                                            | pages:read                                                                  |
| [Create a page](https://getbioflow.com/docs/api-reference/createPage)                         | `POST /v1/pages`                                                           | pages:write                                                                 |
| [Delete a page](https://getbioflow.com/docs/api-reference/deletePage)                         | `DELETE /v1/pages/{page_id}`                                               | pages:write                                                                 |
| [Get a page](https://getbioflow.com/docs/api-reference/getPage)                               | `GET /v1/pages/{page_id}`                                                  | pages:read                                                                  |
| [Update a page](https://getbioflow.com/docs/api-reference/updatePage)                         | `PATCH /v1/pages/{page_id}`                                                | pages:write                                                                 |
| [Add a block](https://getbioflow.com/docs/api-reference/addBlock)                             | `POST /v1/pages/{page_id}/blocks`                                          | pages:write                                                                 |
| [Remove a block](https://getbioflow.com/docs/api-reference/removeBlock)                       | `DELETE /v1/pages/{page_id}/blocks/{block_id}`                             | pages:write                                                                 |
| [Publish a page](https://getbioflow.com/docs/api-reference/publishPage)                       | `POST /v1/pages/{page_id}/publish`                                         | publish                                                                     |
| [Get API usage](https://getbioflow.com/docs/api-reference/getUsage)                           | `GET /v1/usage`                                                            | pages:read, pages:write, analytics:read, contacts:read, files:read, publish |
| [List webhook endpoints](https://getbioflow.com/docs/api-reference/listWebhookEndpoints)      | `GET /v1/webhook-endpoints`                                                | webhooks:read                                                               |
| [Create a webhook endpoint](https://getbioflow.com/docs/api-reference/createWebhookEndpoint)  | `POST /v1/webhook-endpoints`                                               | webhooks:write                                                              |
| [Delete a webhook endpoint](https://getbioflow.com/docs/api-reference/deleteWebhookEndpoint)  | `DELETE /v1/webhook-endpoints/{endpoint_id}`                               | webhooks:write                                                              |
| [Get a webhook endpoint](https://getbioflow.com/docs/api-reference/getWebhookEndpoint)        | `GET /v1/webhook-endpoints/{endpoint_id}`                                  | webhooks:read                                                               |
| [Update a webhook endpoint](https://getbioflow.com/docs/api-reference/updateWebhookEndpoint)  | `PATCH /v1/webhook-endpoints/{endpoint_id}`                                | webhooks:write                                                              |
| [List deliveries](https://getbioflow.com/docs/api-reference/listWebhookDeliveries)            | `GET /v1/webhook-endpoints/{endpoint_id}/deliveries`                       | webhooks:read                                                               |
| [Resend a delivery](https://getbioflow.com/docs/api-reference/resendWebhookDelivery)          | `POST /v1/webhook-endpoints/{endpoint_id}/deliveries/{delivery_id}/resend` | webhooks:write                                                              |
| [Replay failed deliveries](https://getbioflow.com/docs/api-reference/replayWebhookDeliveries) | `POST /v1/webhook-endpoints/{endpoint_id}/replay`                          | webhooks:write                                                              |
| [Rotate the signing secret](https://getbioflow.com/docs/api-reference/rotateWebhookSecret)    | `POST /v1/webhook-endpoints/{endpoint_id}/rotate-secret`                   | webhooks:write                                                              |
| [Send a test event](https://getbioflow.com/docs/api-reference/testWebhookEndpoint)            | `POST /v1/webhook-endpoints/{endpoint_id}/test`                            | webhooks:write                                                              |