Skip to Content
Blocks

Get a content block by ID

GET
/api/v1/blocks/{id}

Retrieve a single content block including its field metadata.

Authorization

headerAuthorizationBearer <token>

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

Path Parameters

id*string

The block ID.

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
id*string

The block ID.

name*string
description*string|null
visibility*string

PRIVATE for your own blocks in this workspace, WORKSPACE for blocks shared in the workspace, ORGANIZATION for blocks shared across the organization, and SHARED for the blocks sajn curates for everyone.

Value in"PRIVATE""WORKSPACE""ORGANIZATION""SHARED"
category*string|null
language*string

The block's language, an ISO 639-1 code such as sv.

isPublished*boolean
sortOrder*integer
Range-9007199254740991 <= value <= 9007199254740991
workspaceId*|

The workspace ID.

organizationId*|

The organization ID.

createdBy*|

A sajn user

createdAt*string

When the block was created.

Formatdate-time
updatedAt*string

When the block was last updated.

Formatdate-time
content*array<>

The block's content blocks in position order

Example Request
curl -X GET 'https://app.sajn.se/api/v1/blocks/cm4k2x9p10028abcd1234efgh'
Example Response
{  "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": {}    }  ]}

Was this page helpful?