Skip to Content
Blocks

List reusable content blocks

GET
/api/v1/blocks

List reusable content blocks (library entries) visible to the authenticated user.

Blocks come in their library order (sortOrder), then newest first. Filter by visibility, or omit it for every block you can see:

  • PRIVATE: your private blocks in this workspace
  • WORKSPACE: blocks shared at workspace level
  • ORGANIZATION: blocks shared at organization level
  • SHARED: blocks sajn curates for everyone

Authorization

headerAuthorizationBearer <token>

API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.

Query Parameters

limit?integer

Maximum number of items to return, from 1 to 100. Default: 25.

Range1 <= value <= 100
Default25
cursor?string

The nextCursor from the previous response, to get the next page. Keep the other parameters unchanged.

Length1 <= length <= 2048
include?array<>

total adds the number of items that match the filters. Counting takes time, so ask for it only when you need it.

query?string

Free-text search across name, description, and field metadata

category?string

Returns only blocks in this category.

language?string

Returns only blocks in this language, an ISO 639-1 code such as sv.

visibility?string

Returns only blocks with this visibility. Omit for every block you can see.

Value in"PRIVATE""WORKSPACE""ORGANIZATION""SHARED"
fieldType?string

Filter to blocks whose single field has this FieldType

Value in"TEXT""HTML""FORM""PDF""PRODUCT_TABLE""TABLE""SPACER""PAGE_BREAK""DURATION"
createdAfter?string

Only blocks created at or after this ISO 8601 date or date-time.

createdBefore?string

Only blocks created at or before this ISO 8601 date or date-time.

updatedAfter?string

Only blocks updated at or after this ISO 8601 date or date-time. Use it for incremental sync.

updatedBefore?string

Only blocks updated at or before this ISO 8601 date or date-time.

Header Parameters

Sajn-Version?string

API version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.

Value in"2026-09""2026-10"
Sajn-Workspace?string

ID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.

Response Body

200

application/json
  1. response
data*array<>
hasMore*boolean

True if more items follow this page.

nextCursor*|

Pass this as cursor to get the next page. Null on the last page.

total?integer

The number of items that match the filters. Present only with include=total.

Range-9007199254740991 <= value <= 9007199254740991
Example Request
curl -X GET 'https://app.sajn.se/api/v1/blocks'
Example Response
{  "data": [    {      "id": "cm4k2x9p10028abcd1234efgh",      "name": "Sekretessklausul",      "description": "Standardklausul om sekretess för anställda.",      "visibility": "WORKSPACE",      "category": "Avtal",      "language": "sv",      "isPublished": true,      "sortOrder": 0,      "workspaceId": "cm4k2x9p10001abcd1234efgh",      "organizationId": "cm4k2x9p10000abcd1234efgh",      "createdBy": {        "id": "cm4k2x9p10002abcd1234efgh",        "email": "alex@example.com",        "name": "Alex Berg"      },      "createdAt": "2026-09-28T09:12:00.000Z",      "updatedAt": "2026-09-28T09:15:00.000Z",      "content": [        {          "id": "cm4k2x9p10028abcd1234efgh",          "type": "Sekretessklausul",          "position": 0,          "fieldMeta": {}        }      ]    }  ],  "hasMore": false,  "nextCursor": null,  "total": 1}

Was this page helpful?