Skip to main content
POST
/
block
/
get-blocks
Retrieve multiple blocks
curl --request POST \
  --url https://app.myhero.so/block/get-blocks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": [
    "<string>"
  ]
}
'
{
  "data": [
    {
      "_id": "<string>",
      "type": "clauseBlock",
      "properties": {
        "attributes": {},
        "content": [
          {
            "id": "<string>",
            "type": "<string>",
            "text": "<string>",
            "marks": [
              {
                "type": "<string>",
                "attributes": {}
              }
            ]
          }
        ],
        "marks": [
          {
            "type": "<string>",
            "attributes": {}
          }
        ]
      },
      "nodeId": "<string>",
      "userId": "<string>",
      "projectId": "<string>",
      "workspaceId": "<string>",
      "createdAt": 123,
      "updatedAt": 123,
      "originId": "<string>",
      "parentId": "<string>",
      "isDeleted": false
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.myhero.so/llms.txt

Use this file to discover all available pages before exploring further.

Accepts an array of block IDs and returns the matching block documents. Access is validated against each block’s parent document; if any document is inaccessible the entire request is rejected with 403.

Authorizations

Authorization
string
header
required

HERO personal access token

Body

application/json
data
string[]
required
Minimum array length: 1
Minimum string length: 1

Response

200 response

data
object[]
required