BioFlow / API docs / removeBlock
DELETE /v1/pages/{page_id}/blocks/{block_id}Delete one block from the page DRAFT, preserving everything else. Removing the last remaining block is refused. Requires expected_updated_at (query parameter).
Requires scope: pages:write. Plan entitlement: public_api (Creator and Pro).
curl "https://app.getbioflow.com/v1/pages/PAGE_ID/blocks/BLOCK_ID" \
-X DELETE \
-H "Authorization: Bearer bf_live_YOUR_KEY"| Name | In | Type | Required | Description |
|---|---|---|---|---|
page_id | path | string | yes | — |
block_id | path | string | yes | Block ID from the page's draft.blocks |
expected_updated_at | query | string | yes | Concurrency stamp: the draft.updated_at you last read. A mismatch is refused with 409 stale_snapshot — re-read the page and retry. |
| Field | Type | Description |
|---|---|---|
id | string | — |
title | string | — |
description | string | — |
slug | string | — |
status | DRAFT | PUBLISHED | ARCHIVED | — |
locale | string | — |
public_url | string | null | Live URL when routed; null for unrouted drafts |
theme | object | — |
draft | object | — |
published | object | — |
Every response also carries X-Request-Id plus the IETF draft-11 RateLimit / RateLimit-Policy headers.
| Code | Status | Meaning |
|---|---|---|
invalid_request | 400 | The request body or parameters failed validation |
invalid_api_key | 401 | Missing, malformed, unknown, disabled, or expired API key |
insufficient_scope | 403 | The API key was not granted the required scope |
feature_not_enabled | 403 | The workspace plan does not include public API access |
test_key_read_only | 403 | Test-mode keys are restricted to read operations |
rate_limited | 429 | Per-key rate limit exceeded |
quota_exhausted | 429 | Monthly API quota exhausted |
internal_error | 500 | Something went wrong on our side |
All errors are RFC 9457 application/problem+json — branch on code, quote request_id to support. Full registry on the API docs hub; interactive playground in the API reference.