Skip to main content
GET
/
blocks
List blocks
curl --request GET \
  --url https://api.bedrock.cv/blocks \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "blk_01JABCD123",
      "sheet_id": "sht_01JABCD123",
      "type": "PLAN",
      "uri": "gs://bedrock-files/projects/prj_01JABCD123/blocks/blk_01JABCD123.png",
      "bounds": {
        "x": 120,
        "y": 80,
        "width": 2400,
        "height": 1800
      },
      "ocr": null,
      "description": "First floor architectural plan",
      "created_at": "2024-06-16T14:10:00Z"
    }
  ],
  "_meta": {
    "next": "eyJpZCI6ImN1cnNvcl8xMjM0NTYiLCJjcmVhdGVkX2F0IjoiMjAyNC0wNi0xNVQxMDozMDowMFoifQ==",
    "prev": null,
    "limit": 1
  }
}
Returns a list of blocks detected on a sheet.

Authorizations

Authorization
string
header
required

API key prefixed with sk_. Example: Authorization: Bearer sk_xxx

Headers

X-API-Version
string
default:2026-01-01

API version

Query Parameters

cursor
string

Pagination cursor

limit
integer
default:20

Number of items per page

Required range: 1 <= x <= 100
sheet_id
string

Filter by sheet

Response

Success

data
object[]
_meta
object