workspace:read reads accessible workspaces and trees. workspace:manage only manages them when the owner has the required current permissions. Global homepage settings, deleted-workspace lists and restore require an administrator. Workspace deletion is recoverable.
Create a workspace with name; supply slug or let the system derive it. visibility is public, authenticated or restricted. Translation maps are name_translations/description_translations; primary_language and supported_languages must match installed languages. tree_visibility and contents_visibility control tree/content presentation, without bypassing ACLs.
ACL PUT replaces all direct assignments. subjects is a list of {type,id,permissions} objects. Workspace type supports user or group; permissions are can_view, can_add, can_edit, can_publish, can_delete, can_manage. Inherited/system rights are not removed simply by omitting them. The individual node-restriction API currently accepts only users already assigned to the workspace; it is not a complete API for every access exception supported by the web interface.
POST nodes creates only internal_link or external_link nodes. Create HTML documents with the page API. Reordering needs the complete placements list, each with id, parent_id and sort_order. Changing node metadata does not edit its HTML document.
shorts uses page, limit, depth, order; limit=all is available only below100 visible entries. It does not use per_page. Theme endpoints manage a workspace private theme, not the global site theme. Upload an image in multipart asset with role; theme ZIP import uses theme. Image upload returns the entire theme model and its assets list, not a single image object. Find the added file there. Only unused images can be deleted. Theme export requires an administrator.
HTML export returns a ZIP of accessible published pages, optionally narrowed by node_ids. It does not recreate functional surveys. It is not a backup of responses, history and settings.
Homepage settings use public_target/authenticated_target: default, page:<nodeId> or shorts:<workspaceId>, plus presentation flags. Personal PUT accepts selection as a page ID (0 restores default) or a target object, only when the administrator enables personal selection.
Operations and verified examples
GET /api/v1/workspaces
Purpose: Returns workspaces visible to the API key owner.
Permission: workspace:read. Current workspace/node permissions; global administration and restore require administrator rights.
Query parameters: page[after], page[limit].
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces?page[limit]=1"
Actual response: HTTP 200.
{
"data": [
{
"id": 2,
"uuid": "4cd08aa0-7377-400e-a330-469da66b60f6",
"slug": "editing-guide",
"name": "Editing guide",
"name_translations": {
"en": "Editing guide"
},
"description": "Example pages for collaborative work.",
"description_translations": {
"en": "Example pages for collaborative work."
},
"visibility": "public",
"tree_visibility": "inherit",
"contents_visibility": "inherit",
"is_archived": false,
"is_deleted": false,
"created_at": "2026-11-06 22:35:54",
"updated_at": "2026-11-06 22:35:54",
"deleted_at": "",
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": true,
"can_delete": true,
"can_manage": true
}
}
],
"meta": {
"request_id": "613cd338ec6a74ef447a39df54e39cea",
"page": {
"limit": 1,
"total": 4,
"has_more": true,
"next_cursor": "eyJvZmZzZXQiOjF9"
}
},
"links": {
"self": "/api/v1/workspaces?page%5Blimit%5D=1",
"next": "/api/v1/workspaces?page%5Blimit%5D=1&page%5Bafter%5D=eyJvZmZzZXQiOjF9"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
POST /api/v1/workspaces
Purpose: Creates a new Workspace subject to the application's creation policy.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Query parameters: none.
Body / supported fields: contents_visibility, description, description_translations, is_archived, name, name_translations, primary_language, slug, supported_languages, tree_visibility, visibility. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"name": "Ogledno API područje",
"slug": "api-ogledno-podrucje",
"description": "Sintetički sadržaj za provjeru cjelokupnog API-ja.",
"visibility": "restricted"
}' \
"$BASE_URL/api/v1/workspaces"
Actual response: HTTP 201.
{
"data": {
"id": 4,
"uuid": "25fcd84a-f5cd-4361-ad82-aa56ad37eae5",
"slug": "api-ogledno-podrucje",
"name": "Ogledno API područje",
"name_translations": {
"en": "Ogledno API područje"
},
"description": "Sintetički sadržaj za provjeru cjelokupnog API-ja.",
"description_translations": {
"en": "Sintetički sadržaj za provjeru cjelokupnog API-ja."
},
"visibility": "restricted",
"tree_visibility": "inherit",
"contents_visibility": "inherit",
"is_archived": false,
"is_deleted": false,
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:44:20",
"deleted_at": "",
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": true,
"can_delete": true,
"can_manage": true
}
},
"meta": {
"request_id": "40109227f06c007cdfd19c562fd53308"
},
"links": {
"self": "/api/v1/workspaces"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
GET /api/v1/workspaces/deleted
Purpose: Returns the administrator-only list of soft-deleted workspaces.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Query parameters: page[after], page[limit].
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces/deleted?page[limit]=100"
Actual response: HTTP 200.
{
"data": [
{
"id": 4,
"uuid": "25fcd84a-f5cd-4361-ad82-aa56ad37eae5",
"slug": "api-ogledno-podrucje",
"name": "Ogledno API područje",
"name_translations": {
"en": "Ogledno API područje"
},
"description": "Ažurirano preko API-ja.",
"description_translations": {
"en": "Ažurirano preko API-ja."
},
"visibility": "restricted",
"tree_visibility": "inherit",
"contents_visibility": "inherit",
"is_archived": false,
"is_deleted": true,
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 23:20:32",
"deleted_at": "2026-11-06 23:20:32",
"permissions": []
}
],
"meta": {
"request_id": "337679c1372f56ec4cc2e5510beb8f0b",
"page": {
"limit": 100,
"total": 1,
"has_more": false,
"next_cursor": null
}
},
"links": {
"self": "/api/v1/workspaces/deleted?page%5Blimit%5D=100",
"next": null
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
POST /api/v1/workspaces/deleted/{workspaceId}/restore
Purpose: Restores a soft-deleted Workspace under an available slug.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceId. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body / supported fields: slug. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"slug": "api-ogledno-podrucje"
}' \
"$BASE_URL/api/v1/workspaces/deleted/4/restore"
Actual response: HTTP 200.
{
"data": {
"id": 4,
"uuid": "25fcd84a-f5cd-4361-ad82-aa56ad37eae5",
"slug": "api-ogledno-podrucje",
"name": "Ogledno API područje",
"name_translations": {
"en": "Ogledno API područje"
},
"description": "Ažurirano preko API-ja.",
"description_translations": {
"en": "Ažurirano preko API-ja."
},
"visibility": "restricted",
"tree_visibility": "inherit",
"contents_visibility": "inherit",
"is_archived": false,
"is_deleted": false,
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 23:20:32",
"deleted_at": "",
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": true,
"can_delete": true,
"can_manage": true
}
},
"meta": {
"request_id": "22962d6ee7bb686754b06152ff10ba62"
},
"links": {
"self": "/api/v1/workspaces/deleted/4/restore"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
GET /api/v1/workspaces/homepage/preference
Purpose: Returns the API-key owner's personal homepage when selection is enabled.
Permission: workspace:read. Current workspace/node permissions; global administration and restore require administrator rights.
Query parameters: none.
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces/homepage/preference" | jq '{data: (.data | {selectedNodeId,selectedTarget,selectedTargetValue,selectionUnavailable,viewOptionsReady}), meta, links}'
Actual response: HTTP 200.This is the actual output of the shown jq filter.
{
"data": {
"selectedNodeId": 0,
"selectedTarget": {
"type": "default",
"node_id": 0,
"workspace_id": 0,
"show_tree": true,
"show_display_options": true
},
"selectedTargetValue": "default",
"selectionUnavailable": false,
"viewOptionsReady": true
},
"meta": {
"request_id": "efe455081ae8c6a2599cf235290fa053"
},
"links": {
"self": "/api/v1/workspaces/homepage/preference"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
PUT /api/v1/workspaces/homepage/preference
Purpose: Stores the API-key owner's personal homepage after a fresh ACL check.
Permission: workspace:read. Current workspace/node permissions; global administration and restore require administrator rights.
Query parameters: none.
Body / supported fields: selection. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request PUT \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"selection": 0
}' \
"$BASE_URL/api/v1/workspaces/homepage/preference" | jq '{data: (.data | {selectedNodeId,selectedTarget,selectedTargetValue,selectionUnavailable,viewOptionsReady}), meta, links}'
Actual response: HTTP 200.This is the actual output of the shown jq filter.
{
"data": {
"selectedNodeId": 0,
"selectedTarget": {
"type": "default",
"node_id": 0,
"workspace_id": 0,
"show_tree": true,
"show_display_options": true
},
"selectedTargetValue": "default",
"selectionUnavailable": false,
"viewOptionsReady": true
},
"meta": {
"request_id": "c0575c57cbeb8fb18fdd07daa34ad587"
},
"links": {
"self": "/api/v1/workspaces/homepage/preference"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
GET /api/v1/workspaces/homepage/settings
Purpose: Returns administrator-only public and authenticated homepage policy.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Query parameters: none.
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces/homepage/settings" | jq '{data: (.data | {settings,view_options_ready}), meta, links}'
Actual response: HTTP 200.This is the actual output of the shown jq filter.
{
"data": {
"settings": {
"public_node_id": 0,
"authenticated_node_id": 0,
"public_target": {
"type": "default",
"node_id": 0,
"workspace_id": 0,
"show_tree": true,
"show_display_options": true
},
"authenticated_target": {
"type": "default",
"node_id": 0,
"workspace_id": 0,
"show_tree": true,
"show_display_options": true
},
"allow_user_selection": true
},
"view_options_ready": true
},
"meta": {
"request_id": "0bb93172f325cd23a0fd269bbf59e7f5"
},
"links": {
"self": "/api/v1/workspaces/homepage/settings"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
PUT /api/v1/workspaces/homepage/settings
Purpose: Stores administrator-only public and authenticated homepage policy.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Query parameters: none.
Body / supported fields: allow_user_selection, authenticated_show_display_options, authenticated_show_tree, authenticated_target, public_show_display_options, public_show_tree, public_target. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request PUT \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"public_target": "default",
"authenticated_target": "default",
"public_show_tree": true,
"public_show_display_options": true,
"authenticated_show_tree": true,
"authenticated_show_display_options": true,
"allow_user_selection": true
}' \
"$BASE_URL/api/v1/workspaces/homepage/settings" | jq '{data: (.data | {settings,view_options_ready}), meta, links}'
Actual response: HTTP 200.This is the actual output of the shown jq filter.
{
"data": {
"settings": {
"public_node_id": 0,
"authenticated_node_id": 0,
"public_target": {
"type": "default",
"node_id": 0,
"workspace_id": 0,
"show_tree": true,
"show_display_options": true
},
"authenticated_target": {
"type": "default",
"node_id": 0,
"workspace_id": 0,
"show_tree": true,
"show_display_options": true
},
"allow_user_selection": true
},
"view_options_ready": true
},
"meta": {
"request_id": "4e069414636ec0f7a9ae9b197dd191e1"
},
"links": {
"self": "/api/v1/workspaces/homepage/settings"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
DELETE /api/v1/workspaces/{workspaceSlug}
Purpose: Soft-deletes a Workspace with the effective can_manage permission.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body: no additional input fields; follow the example.
Before writing: refresh the GET and set ETAG from its ETag header.
curl --globoff --silent --show-error \
--request DELETE \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "If-Match: $ETAG" \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje"
Actual response: HTTP 204. The body is empty.
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
GET /api/v1/workspaces/{workspaceSlug}
Purpose: Returns one Workspace when the key owner may view it.
Permission: workspace:read. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje"
Actual response: HTTP 200.
{
"data": {
"id": 4,
"uuid": "25fcd84a-f5cd-4361-ad82-aa56ad37eae5",
"slug": "api-ogledno-podrucje",
"name": "Ogledno API područje",
"name_translations": {
"en": "Ogledno API područje"
},
"description": "Sintetički sadržaj za provjeru cjelokupnog API-ja.",
"description_translations": {
"en": "Sintetički sadržaj za provjeru cjelokupnog API-ja."
},
"visibility": "restricted",
"tree_visibility": "inherit",
"contents_visibility": "inherit",
"is_archived": false,
"is_deleted": false,
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:44:20",
"deleted_at": "",
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": true,
"can_delete": true,
"can_manage": true
}
},
"meta": {
"request_id": "e0e85fd92c7a001921444f4175228ec0"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje"
}
}
Errors verified for this operation: 401, 403, 404. See shared rules for status meanings and problem responses.
PATCH /api/v1/workspaces/{workspaceSlug}
Purpose: Partially updates a Workspace with the effective can_manage permission.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body / supported fields: contents_visibility, description, description_translations, is_archived, name, name_translations, primary_language, slug, supported_languages, tree_visibility, visibility. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
Before writing: refresh the GET and set ETAG from its ETag header.
curl --globoff --silent --show-error \
--request PATCH \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--header "If-Match: $ETAG" \
--data-raw '{
"description": "Ažurirano preko API-ja."
}' \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje"
Actual response: HTTP 200.
{
"data": {
"id": 4,
"uuid": "25fcd84a-f5cd-4361-ad82-aa56ad37eae5",
"slug": "api-ogledno-podrucje",
"name": "Ogledno API područje",
"name_translations": {
"en": "Ogledno API područje"
},
"description": "Ažurirano preko API-ja.",
"description_translations": {
"en": "Ažurirano preko API-ja."
},
"visibility": "restricted",
"tree_visibility": "inherit",
"contents_visibility": "inherit",
"is_archived": false,
"is_deleted": false,
"created_at": "2026-11-06 22:44:20",
"updated_at": "2026-11-06 22:44:20",
"deleted_at": "",
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": true,
"can_delete": true,
"can_manage": true
}
},
"meta": {
"request_id": "135a815aac013227e2c0dad8cb3a7e86"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje"
}
}
Errors verified for this operation: 400, 401, 403, 412, 428. See shared rules for status meanings and problem responses.
GET /api/v1/workspaces/{workspaceSlug}/acl
Purpose: Returns the direct Workspace ACL to a user who may manage it.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/acl"
Actual response: HTTP 200.
{
"data": [
{
"type": "user",
"id": 1,
"label": "Administrator",
"is_builtin": false,
"is_read_only": false,
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": true,
"can_delete": true,
"can_manage": true
}
}
],
"meta": {
"request_id": "b6aa7159a0807a86e4ecec28837632c8"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/acl"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
PUT /api/v1/workspaces/{workspaceSlug}/acl
Purpose: Replaces the complete Workspace ACL.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body / supported fields: subjects. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request PUT \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"subjects": [
{
"type": "user",
"id": 2,
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": false,
"can_delete": false,
"can_manage": false
}
}
]
}' \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/acl"
Actual response: HTTP 200.
{
"data": [
{
"type": "user",
"id": 2,
"label": "Ana Author",
"is_builtin": false,
"is_read_only": false,
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": false,
"can_delete": false,
"can_manage": false
}
}
],
"meta": {
"request_id": "c7bc6b2bc47f17e6da17a6f25bba9d5b"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/acl"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
GET /api/v1/workspaces/{workspaceSlug}/acl/subjects
Purpose: Searches users or groups for the Workspace ACL picker.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: category, q.
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/acl/subjects?category=user&q=Ana"
Actual response: HTTP 200.
{
"data": [
{
"id": 2,
"label": "Ana Author",
"type": "user",
"category": "user",
"is_builtin": false,
"is_read_only": false
}
],
"meta": {
"request_id": "a00b8b79c556ffb217e854bb4df6781f"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/acl/subjects?category=user&q=Ana"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
POST /api/v1/workspaces/{workspaceSlug}/exports/html
Purpose: Downloads an ACL-filtered offline HTML ZIP of a Workspace or selected pages.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body / supported fields: node_ids. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"node_ids": [
36
]
}' \
--dump-header response-headers.txt \
--output response.zip \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/exports/html"
Actual response: HTTP 200.
cache-control: private, no-store
content-type: application/zip
content-disposition: attachment; filename="simbioza-api-ogledno-podrucje-20261106-231026.zip"
content-length: 117723
The file is saved as response.*. The verified content has 117723 bytes; do not decode it as JSON.
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
POST /api/v1/workspaces/{workspaceSlug}/nodes
Purpose: Adds an internal or external link to the tree.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body / supported fields: contents_visibility, is_homepage, node_type, parent_id, primary_language, route_name, slug, sort_order, supported_languages, target_url, title, title_translations. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"node_type": "internal_link",
"title": "api-internal",
"slug": "api-internal",
"target_url": "/about",
"sort_order": 200
}' \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/nodes"
Actual response: HTTP 201.
{
"data": {
"id": 37,
"uuid": "e26c1075-3a3b-4daf-96c5-8984258964e9",
"parent_id": null,
"node_type": "internal_link",
"slug": "api-internal",
"title": "api-internal",
"title_translations": {
"en": "api-internal"
},
"document_key": "",
"route_name": "",
"target_url": "/about",
"sort_order": 200,
"is_homepage": false,
"contents_visibility": "inherit",
"labels": [],
"properties": [],
"permissions": []
},
"meta": {
"request_id": "b75c597c0414ff8e3cf18d976e9f03a9"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/nodes"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
DELETE /api/v1/workspaces/{workspaceSlug}/nodes/{nodeId}
Purpose: Deletes a link node; documents remain the Editor API's responsibility.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug, nodeId. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request DELETE \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/nodes/37"
Actual response: HTTP 204. The body is empty.
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
PATCH /api/v1/workspaces/{workspaceSlug}/nodes/{nodeId}
Purpose: Updates structural data for one tree node.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug, nodeId. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body / supported fields: contents_visibility, is_homepage, labels, node_type, parent_id, primary_language, properties, route_name, slug, sort_order, supported_languages, target_url, title, title_translations. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request PATCH \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"title": "API poveznica"
}' \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/nodes/37"
Actual response: HTTP 200.
{
"data": {
"id": 37,
"uuid": "e26c1075-3a3b-4daf-96c5-8984258964e9",
"parent_id": null,
"node_type": "internal_link",
"slug": "api-internal",
"title": "API poveznica",
"title_translations": {
"en": "API poveznica"
},
"document_key": "",
"route_name": "",
"target_url": "/about",
"sort_order": 200,
"is_homepage": false,
"contents_visibility": "inherit",
"labels": [],
"properties": [],
"permissions": []
},
"meta": {
"request_id": "89fef7d6bff70c6a19e5dc398783d33f"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/nodes/37"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
GET /api/v1/workspaces/{workspaceSlug}/nodes/{nodeId}/acl
Purpose: Returns direct ACL restrictions for one node.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug, nodeId. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/nodes/37/acl"
Actual response: HTTP 200.
{
"data": [],
"meta": {
"request_id": "a376426ba7d7e2cdbd47d084edcd9e9e"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/nodes/37/acl"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
PUT /api/v1/workspaces/{workspaceSlug}/nodes/{nodeId}/acl
Purpose: Replaces direct ACL restrictions for one node.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug, nodeId. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body / supported fields: subjects. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request PUT \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"subjects": [
{
"type": "user",
"id": 2,
"permissions": {
"can_view": true
}
}
]
}' \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/nodes/37/acl"
Actual response: HTTP 200.
{
"data": [
{
"type": "user",
"id": 2,
"label": "Ana Author",
"is_builtin": false,
"is_read_only": false,
"permissions": {
"can_view": true,
"can_add": false,
"can_edit": false,
"can_publish": false,
"can_delete": false,
"can_manage": false
}
}
],
"meta": {
"request_id": "3991706d28cfe0d2ce50650e27891ff0"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/nodes/37/acl"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
GET /api/v1/workspaces/{workspaceSlug}/shorts
Purpose: Returns ACL-filtered summaries of published Workspace pages.
Permission: workspace:read. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: lang, page, limit, depth, order.
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/shorts?lang=hr&page=1&limit=10"
Actual response: HTTP 200.
{
"data": {
"tree": [
{
"id": 40,
"uuid": "f85dfce8-f123-4dd9-969a-f29b068dae06",
"workspace_id": 4,
"parent_id": null,
"node_type": "document",
"slug": "api-vodic-za-integracije",
"title": "Vodič za integracije",
"title_translations": "{\"en\":\"Vodič za integracije\",\"hr\":\"Vodič za integracije\"}",
"document_key": "api-vodic-za-integracije",
"route_name": null,
"target_url": null,
"sort_order": 100,
"is_homepage": 1,
"is_tree_hidden": 0,
"is_enabled": 1,
"contents_visibility": "inherit",
"created_by_user_id": 1,
"updated_by_user_id": 1,
"created_at": "2026-11-06 23:24:07",
"updated_at": "2026-11-06 23:24:07",
"is_tree_hidden_effective": false,
"is_tree_temporarily_visible": false,
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": true,
"can_delete": true,
"can_manage": true
},
"children": [],
"title_translations_map": {
"en": "Vodič za integracije",
"hr": "Vodič za integracije"
},
"href": "/workspace/api-ogledno-podrucje/api-vodic-za-integracije?lang=hr"
}
],
"articles": [],
"depth": 2,
"limit": "10",
"order": "newest",
"total": 1,
"all_available": true,
"pagination": {
"page": 1,
"pages": 1,
"total": 1,
"from": 1,
"to": 1,
"page_numbers": [
1
]
},
"shorts_path": "/workspace/api-ogledno-podrucje/shorts?lang=hr",
"workspace_path": "/workspace/api-ogledno-podrucje?lang=hr"
},
"meta": {
"request_id": "59be13951d906db537a449e60e0c472c"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/shorts?lang=hr&page=1&limit=10"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
GET /api/v1/workspaces/{workspaceSlug}/theme
Purpose: Returns Workspace theme settings, system choices, and private files.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/theme" | jq '{data: {workspace_id: .data.workspace_id, settings: .data.settings, selected_theme: (.data.selected_theme | {id,label}), assets: [.data.assets[] | {file,role,used}], can_export: .data.can_export}, meta, links}'
Actual response: HTTP 200.This is the actual output of the shown jq filter.
{
"data": {
"workspace_id": 4,
"settings": {
"enabled": true,
"active_theme": "__default__",
"mode_policy": "light"
},
"selected_theme": {
"id": "simbioza",
"label": {
"hr": "Simbioza",
"en": "Simbioza"
}
},
"assets": [
{
"file": "hero-adriatic-dark.png",
"role": "hero",
"used": false
},
{
"file": "hero-adriatic-dark.svg",
"role": "hero",
"used": true
},
{
"file": "hero-adriatic-light.png",
"role": "hero",
"used": false
},
{
"file": "hero-adriatic-light.svg",
"role": "hero",
"used": true
},
{
"file": "hero-botanical-dark.png",
"role": "hero",
"used": false
},
{
"file": "hero-botanical-dark.svg",
"role": "hero",
"used": false
},
{
"file": "hero-botanical-light.png",
"role": "hero",
"used": false
},
{
"file": "hero-botanical-light.svg",
"role": "hero",
"used": false
},
{
"file": "hero-natural-dark.png",
"role": "hero",
"used": false
},
{
"file": "hero-natural-dark.svg",
"role": "hero",
"used": false
},
{
"file": "hero-natural-light.png",
"role": "hero",
"used": false
},
{
"file": "hero-natural-light.svg",
"role": "hero",
"used": false
},
{
"file": "icon-adriatic-dark.png",
"role": "icon",
"used": true
},
{
"file": "icon-adriatic-dark.svg",
"role": "icon",
"used": false
},
{
"file": "icon-adriatic-light.png",
"role": "icon",
"used": true
},
{
"file": "icon-adriatic-light.svg",
"role": "icon",
"used": false
},
{
"file": "icon-botanical-dark.png",
"role": "icon",
"used": false
},
{
"file": "icon-botanical-dark.svg",
"role": "icon",
"used": false
},
{
"file": "icon-botanical-light.png",
"role": "icon",
"used": false
},
{
"file": "icon-botanical-light.svg",
"role": "icon",
"used": false
},
{
"file": "icon-natural-dark.png",
"role": "icon",
"used": false
},
{
"file": "icon-natural-dark.svg",
"role": "icon",
"used": false
},
{
"file": "icon-natural-light.png",
"role": "icon",
"used": false
},
{
"file": "icon-natural-light.svg",
"role": "icon",
"used": false
}
],
"can_export": false
},
"meta": {
"request_id": "d2a84727c1eea4b947872cc8fb0452d9"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/theme"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
PATCH /api/v1/workspaces/{workspaceSlug}/theme
Purpose: Stores a private theme configuration only for the supplied Workspace.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body / supported fields: mode_policy, theme. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
The following examples use the public Simbioza theme and assume the Workspace inherits that theme. The responses illustrate the API contract; the file list and request identifier depend on the installation.
curl --globoff --silent --show-error \
--request PATCH \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"theme": {
"id": "simbioza",
"label": {
"hr": "Simbioza",
"en": "Simbioza"
},
"font_family": "Aptos, \"Segoe UI\", system-ui, -apple-system, BlinkMacSystemFont, sans-serif",
"menu_font_family": "Aptos, \"Segoe UI\", system-ui, -apple-system, BlinkMacSystemFont, sans-serif",
"menu_font_size": "1rem",
"menu_font_weight": "600",
"menu_font_style": "normal",
"system": true,
"components": {
"skip_link": true,
"header": {
"enabled": true,
"sticky": true,
"container": "fluid",
"height_px": 72,
"items": [
{
"id": "header-1",
"type": "logo",
"position": "start",
"text": [],
"href": "@app",
"src_light": "@theme-assets/simbioza/icon-adriatic-light.png",
"src_dark": "@theme-assets/simbioza/icon-adriatic-dark.png",
"alt": {
"hr": "Simbioza znak",
"en": "Simbioza mark"
},
"height": 48,
"new_tab": false
},
{
"id": "header-2",
"type": "text",
"position": "start",
"text": {
"hr": "Simbioza",
"en": "Simbioza"
},
"href": "",
"src_light": "",
"src_dark": "",
"alt": [],
"height": 44,
"new_tab": false
},
{
"id": "header-3",
"type": "language",
"position": "end",
"text": [],
"href": "",
"src_light": "",
"src_dark": "",
"alt": [],
"height": 44,
"new_tab": false
},
{
"id": "header-4",
"type": "account",
"position": "end",
"text": [],
"href": "",
"src_light": "",
"src_dark": "",
"alt": [],
"height": 44,
"new_tab": false
}
]
},
"navigation": {
"placement": "standalone",
"container": "fluid",
"height_px": 56,
"breakpoint": "lg",
"tabs_style": "standard",
"tabs_accent_enabled": true,
"tabs_radius": "small",
"tabs_active_border_width_px": 2,
"show_brand": false,
"brand_display": "none",
"show_mobile_label": false,
"mobile_label": {
"hr": "Izbornik",
"en": "Menu"
},
"sticky": true,
"show_icons": false,
"mark_external_links": true
},
"hero": {
"home_enabled": true,
"inner_enabled": true,
"container": "fluid",
"home_size": "medium",
"inner_size": "medium",
"alignment": "start",
"content_min_height_px": 0,
"content_padding_top_px": 0,
"content_padding_bottom_px": 0,
"visual_enabled": true,
"visual_src_light": "@theme-assets/simbioza/hero-adriatic-light.svg",
"visual_src_dark": "@theme-assets/simbioza/hero-adriatic-dark.svg",
"visual_alt": [],
"visual_decorative": true,
"visual_allow_overflow": false,
"visual_width_px": 560,
"visual_max_height_px": 0,
"visual_top_px": -48,
"visual_right_px": 24,
"visual_rotation_deg": 0,
"wave": true
},
"content": {
"container": "fluid",
"inner_title_placement": "hero",
"application_title_placement": "hero",
"surface": "plain",
"inner_hero_overlap": "large",
"density": "comfortable",
"title_accent": "none",
"title_shadow": false,
"content_accent": "top",
"content_shadow": false,
"sidebar_accent": "top",
"sidebar_shadow": false
},
"cards": {
"style": "quiet",
"density": "comfortable",
"radius": "medium"
}
},
"light": {
"colors": {
"body_bg": "#FFF8EE",
"body_text": "#123F4B",
"muted_text": "#547078",
"surface_bg": "#FFFFFF",
"surface_text": "#123F4B",
"border": "#D9E3DF",
"link": "#A83F2E",
"primary": "#0E6268",
"secondary": "#C7543A",
"success": "#287A68",
"warning": "#D39B2F",
"danger": "#B93636",
"info": "#27979A",
"document_action_bg": "#FFFFFF",
"document_action_text": "#C7543A",
"document_action_border": "#D9E3DF",
"document_action_hover_bg": "#C7543A",
"document_action_hover_text": "#FFF8EE",
"document_action_active_bg": "#0E6268",
"document_action_active_text": "#FFF8EE",
"card_bg": "#FFFFFF",
"card_text": "#123F4B",
"card_border": "#D9E3DF",
"card_accent": "#FF8064",
"card_shadow": "#071F27",
"title_card_bg": "#FFFFFF",
"title_card_text": "#123F4B",
"title_card_border": "#D9E3DF",
"title_card_accent": "#FF8064",
"content_card_bg": "#FFFFFF",
"content_card_text": "#123F4B",
"content_card_border": "#D9E3DF",
"content_card_accent": "#FF8064",
"sidebar_card_bg": "#FFFFFF",
"sidebar_card_text": "#123F4B",
"sidebar_card_border": "#D9E3DF",
"sidebar_card_accent": "#E9B84A",
"title_supporting_text": "#276E82",
"hero_gradient_1": "#25408F",
"hero_gradient_2": "#2872A0",
"hero_gradient_3": "#2F9EAA",
"hero_gradient_4": "#3CB4AD",
"hero_gradient_5": "#4CC0AD",
"hero_text": "#FFF8EE",
"hero_title": "#FFF8EE",
"hero_subtitle": "#D9F2EE",
"hero_muted": "#B7D8D5",
"table_header_bg": "#EAF3F0",
"table_header_text": "#123F4B",
"table_row_bg": "#FFFFFF",
"table_row_text": "#123F4B",
"table_row_alt_bg": "#F5F7F4",
"table_border": "#D9E3DF",
"alert_primary_bg": "#CFE2FF",
"alert_primary_text": "#084298",
"alert_primary_border": "#B6D4FE",
"alert_success_bg": "#D1E7DD",
"alert_success_text": "#0F5132",
"alert_success_border": "#BADBCC",
"alert_warning_bg": "#FFF3CD",
"alert_warning_text": "#664D03",
"alert_warning_border": "#FFECB5",
"alert_danger_bg": "#F8D7DA",
"alert_danger_text": "#842029",
"alert_danger_border": "#F5C2C7",
"alert_info_bg": "#CFF4FC",
"alert_info_text": "#055160",
"alert_info_border": "#B6EFFB",
"badge_bg": "#123F4B",
"badge_text": "#FFF8EE",
"tag_bg": "#EAF3F0",
"tag_text": "#123F4B",
"nav_default_bg": "#071F27",
"nav_default_text": "#FFF8EE",
"nav_border": "#72D4C8",
"nav_active_bg": "#071F27",
"nav_active_text": "#FFFFFF",
"nav_active_accent": "#E9B84A",
"nav_hover_bg": "#0D424B",
"left_menu_hover_bg": "#EAF3F0",
"left_menu_hover_text": "#123F4B",
"left_menu_active_bg": "#0E6268",
"left_menu_active_text": "#FFFFFF",
"special_left_menu_accent": "#FF8064",
"pagination_bg": "#FFFFFF",
"pagination_text": "#0E6268",
"pagination_active_bg": "#0E6268",
"pagination_active_text": "#FFFFFF",
"breadcrumb_text": "#547078",
"breadcrumb_link": "#0E6268",
"editor_tab_bg": "#F8F9FA",
"editor_tab_text": "#495057",
"editor_tab_border": "#DEE2E6",
"editor_tab_hover_bg": "#E9ECEF",
"editor_tab_active_bg": "#FFFFFF",
"editor_tab_active_text": "#212529",
"editor_tab_active_accent": "#0D6EFD",
"editor_tab_panel_bg": "#FFFFFF",
"editor_tab_panel_text": "#212529",
"editor_accordion_header_bg": "#F8F9FA",
"editor_accordion_header_text": "#212529",
"editor_accordion_body_bg": "#FFFFFF",
"editor_accordion_body_text": "#212529",
"focus_ring": "#FF8064",
"disabled_bg": "#E7ECE9",
"disabled_text": "#667C81",
"valid": "#287A68",
"invalid": "#B93636",
"code_bg": "#EEF4F1",
"code_text": "#8B3653",
"blockquote_border": "#72D4C8",
"callout_bg": "#EAF3F0",
"callout_text": "#123F4B",
"callout_border": "#72D4C8",
"navbar_gradient_1": "#25408F",
"navbar_gradient_2": "#2872A0",
"navbar_gradient_3": "#2F9EAA",
"navbar_gradient_4": "#3CB4AD",
"navbar_gradient_5": "#4CC0AD",
"navbar_text": "#FFF8EE",
"navbar_link": "#FFF8EE",
"navbar_active": "#FFFFFF",
"navbar_active_bg": "#0D424B",
"primary_text": "auto",
"secondary_text": "#FFFFFF",
"success_text": "auto",
"warning_text": "auto",
"danger_text": "auto",
"info_text": "auto"
}
},
"dark": {
"colors": {
"body_bg": "#071F27",
"body_text": "#E7F3F0",
"muted_text": "#A9C5C3",
"surface_bg": "#0B2A32",
"surface_text": "#E7F3F0",
"border": "#31515A",
"link": "#8AE1D7",
"primary": "#45AFA6",
"secondary": "#FF8064",
"success": "#62C6A8",
"warning": "#E9B84A",
"danger": "#F07979",
"info": "#72D4C8",
"document_action_bg": "#0B2A32",
"document_action_text": "#FF8064",
"document_action_border": "#31515A",
"document_action_hover_bg": "#FF8064",
"document_action_hover_text": "#071F27",
"document_action_active_bg": "#45AFA6",
"document_action_active_text": "#071F27",
"card_bg": "#0B2A32",
"card_text": "#E7F3F0",
"card_border": "#31515A",
"card_accent": "#FF8064",
"card_shadow": "#000000",
"title_card_bg": "#0B2A32",
"title_card_text": "#E7F3F0",
"title_card_border": "#31515A",
"title_card_accent": "#FF8064",
"content_card_bg": "#0B2A32",
"content_card_text": "#E7F3F0",
"content_card_border": "#31515A",
"content_card_accent": "#FF8064",
"sidebar_card_bg": "#0B2A32",
"sidebar_card_text": "#E7F3F0",
"sidebar_card_border": "#31515A",
"sidebar_card_accent": "#E9B84A",
"title_supporting_text": "#A9C5C3",
"hero_gradient_1": "#25408F",
"hero_gradient_2": "#2872A0",
"hero_gradient_3": "#2F9EAA",
"hero_gradient_4": "#3CB4AD",
"hero_gradient_5": "#4CC0AD",
"hero_text": "#FFF8EE",
"hero_title": "#FFF8EE",
"hero_subtitle": "#D9F2EE",
"hero_muted": "#B7D8D5",
"table_header_bg": "#113A43",
"table_header_text": "#F7FBFA",
"table_row_bg": "#0B2A32",
"table_row_text": "#E7F3F0",
"table_row_alt_bg": "#102F37",
"table_border": "#31515A",
"alert_primary_bg": "#031633",
"alert_primary_text": "#6EA8FE",
"alert_primary_border": "#084298",
"alert_success_bg": "#051B11",
"alert_success_text": "#75B798",
"alert_success_border": "#0F5132",
"alert_warning_bg": "#332701",
"alert_warning_text": "#FFDA6A",
"alert_warning_border": "#664D03",
"alert_danger_bg": "#2C0B0E",
"alert_danger_text": "#EA868F",
"alert_danger_border": "#842029",
"alert_info_bg": "#032830",
"alert_info_text": "#6EDFF6",
"alert_info_border": "#055160",
"badge_bg": "#E9B84A",
"badge_text": "#071F27",
"tag_bg": "#153A42",
"tag_text": "#E7F3F0",
"nav_default_bg": "#071F27",
"nav_default_text": "#FFF8EE",
"nav_border": "#31515A",
"nav_active_bg": "#0D424B",
"nav_active_text": "#FFFFFF",
"nav_active_accent": "#E9B84A",
"nav_hover_bg": "#0D424B",
"left_menu_hover_bg": "#153A42",
"left_menu_hover_text": "#FFFFFF",
"left_menu_active_bg": "#45AFA6",
"left_menu_active_text": "#071F27",
"special_left_menu_accent": "#FF8064",
"pagination_bg": "#0B2A32",
"pagination_text": "#8AE1D7",
"pagination_active_bg": "#45AFA6",
"pagination_active_text": "#071F27",
"breadcrumb_text": "#A9C5C3",
"breadcrumb_link": "#8AE1D7",
"editor_tab_bg": "#212529",
"editor_tab_text": "#ADB5BD",
"editor_tab_border": "#495057",
"editor_tab_hover_bg": "#343A40",
"editor_tab_active_bg": "#2B3035",
"editor_tab_active_text": "#FFFFFF",
"editor_tab_active_accent": "#6EA8FE",
"editor_tab_panel_bg": "#2B3035",
"editor_tab_panel_text": "#DEE2E6",
"editor_accordion_header_bg": "#212529",
"editor_accordion_header_text": "#DEE2E6",
"editor_accordion_body_bg": "#2B3035",
"editor_accordion_body_text": "#DEE2E6",
"focus_ring": "#FF8064",
"disabled_bg": "#183941",
"disabled_text": "#8DA4A5",
"valid": "#62C6A8",
"invalid": "#F07979",
"code_bg": "#102F37",
"code_text": "#FF9F89",
"blockquote_border": "#72D4C8",
"callout_bg": "#102F37",
"callout_text": "#E7F3F0",
"callout_border": "#31515A",
"navbar_gradient_1": "#25408F",
"navbar_gradient_2": "#2872A0",
"navbar_gradient_3": "#2F9EAA",
"navbar_gradient_4": "#3CB4AD",
"navbar_gradient_5": "#4CC0AD",
"navbar_text": "#FFF8EE",
"navbar_link": "#FFF8EE",
"navbar_active": "#FFFFFF",
"navbar_active_bg": "#0D424B",
"primary_text": "auto",
"secondary_text": "auto",
"success_text": "auto",
"warning_text": "auto",
"danger_text": "auto",
"info_text": "auto"
}
}
},
"mode_policy": "light"
}' \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/theme" | jq '{data: {workspace_id: .data.workspace_id, settings: .data.settings, selected_theme: (.data.selected_theme | {id,label}), assets: [.data.assets[] | {file,role,used}], can_export: .data.can_export}, meta, links}'
Example response: HTTP 200.
{
"data": {
"workspace_id": 4,
"settings": {
"enabled": true,
"active_theme": "workspace-4",
"mode_policy": "light"
},
"selected_theme": {
"id": "workspace-4",
"label": {
"hr": "Simbioza – Ogledno API područje",
"en": "Simbioza – Ogledno API područje"
}
},
"assets": [
{
"file": "hero-adriatic-dark.svg",
"role": "hero",
"used": true
},
{
"file": "hero-adriatic-light.svg",
"role": "hero",
"used": true
},
{
"file": "icon-adriatic-dark.png",
"role": "other",
"used": true
},
{
"file": "icon-adriatic-light.png",
"role": "other",
"used": true
}
],
"can_export": true
},
"meta": {
"request_id": "fa8a2e1360c17a2b204df8cebd36ea8c"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/theme"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
POST /api/v1/workspaces/{workspaceSlug}/theme/assets
Purpose: Stores an image from the asset multipart field in the private theme library.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body / supported fields: asset, role. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--form 'asset=@./api-circle.svg;type=image/svg+xml' \
--form role=other \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/theme/assets" | jq '{data: {workspace_id: .data.workspace_id, settings: .data.settings, selected_theme: (.data.selected_theme | {id,label}), assets: [.data.assets[] | {file,role,used}], can_export: .data.can_export}, meta, links}'
Example response: HTTP 200.
{
"data": {
"workspace_id": 4,
"settings": {
"enabled": true,
"active_theme": "workspace-4",
"mode_policy": "light"
},
"selected_theme": {
"id": "workspace-4",
"label": {
"hr": "Simbioza – Ogledno API područje",
"en": "Simbioza – Ogledno API područje"
}
},
"assets": [
{
"file": "hero-adriatic-dark.svg",
"role": "hero",
"used": true
},
{
"file": "hero-adriatic-light.svg",
"role": "hero",
"used": true
},
{
"file": "api-circle.svg",
"role": "other",
"used": false
},
{
"file": "icon-adriatic-dark.png",
"role": "other",
"used": true
},
{
"file": "icon-adriatic-light.png",
"role": "other",
"used": true
}
],
"can_export": true
},
"meta": {
"request_id": "b47707737f33e9b0db3941383cbaa65b"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/theme/assets"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
DELETE /api/v1/workspaces/{workspaceSlug}/theme/assets/{file}
Purpose: Deletes an unused Workspace private-theme file.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug, file. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request DELETE \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/theme/assets/api-circle.svg" | jq '{data: {workspace_id: .data.workspace_id, settings: .data.settings, selected_theme: (.data.selected_theme | {id,label}), assets: [.data.assets[] | {file,role,used}], can_export: .data.can_export}, meta, links}'
Example response: HTTP 200.
{
"data": {
"workspace_id": 4,
"settings": {
"enabled": true,
"active_theme": "workspace-4",
"mode_policy": "light"
},
"selected_theme": {
"id": "workspace-4",
"label": {
"hr": "Simbioza – Ogledno API područje",
"en": "Simbioza – Ogledno API područje"
}
},
"assets": [
{
"file": "hero-adriatic-dark.svg",
"role": "hero",
"used": true
},
{
"file": "hero-adriatic-light.svg",
"role": "hero",
"used": true
},
{
"file": "icon-adriatic-dark.png",
"role": "other",
"used": true
},
{
"file": "icon-adriatic-light.png",
"role": "other",
"used": true
}
],
"can_export": true
},
"meta": {
"request_id": "97a72aa130fa5380e38c2f24cdf948ba"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/theme/assets/api-circle.svg"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
GET /api/v1/workspaces/{workspaceSlug}/theme/export
Purpose: Downloads a Workspace private-theme ZIP for an administrator.
Permission: a valid API key. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--dump-header response-headers.txt \
--output api-workspace-theme.zip \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/theme/export"
Example response: HTTP 200.
cache-control: private, no-store
content-type: application/zip
content-disposition: attachment; filename="workspace-theme-api-ogledno-podrucje.zip"
The ZIP is saved as api-workspace-theme.zip and can be used in the following import example. Its size depends on the contents; do not decode it as JSON.
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
POST /api/v1/workspaces/{workspaceSlug}/theme/import
Purpose: Imports a theme ZIP from the theme multipart field into a private Workspace theme.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body / supported fields: mode_policy, theme. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request POST \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--form 'theme=@./api-workspace-theme.zip;type=application/zip' \
--form mode_policy=auto \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/theme/import" | jq '{data: {workspace_id: .data.workspace_id, settings: .data.settings, selected_theme: (.data.selected_theme | {id,label}), assets: [.data.assets[] | {file,role,used}], can_export: .data.can_export}, meta, links}'
Example response: HTTP 200.
{
"data": {
"workspace_id": 4,
"settings": {
"enabled": true,
"active_theme": "workspace-4",
"mode_policy": "auto"
},
"selected_theme": {
"id": "workspace-4",
"label": {
"hr": "Simbioza – Ogledno API područje",
"en": "Simbioza – Ogledno API područje"
}
},
"assets": [
{
"file": "hero-adriatic-dark.svg",
"role": "hero",
"used": true
},
{
"file": "hero-adriatic-light.svg",
"role": "hero",
"used": true
},
{
"file": "icon-adriatic-dark.png",
"role": "other",
"used": true
},
{
"file": "icon-adriatic-light.png",
"role": "other",
"used": true
}
],
"can_export": true
},
"meta": {
"request_id": "c8eee8b7fe118a2c8e40873aa94ac9c9"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/theme/import"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
PUT /api/v1/workspaces/{workspaceSlug}/theme/selection
Purpose: Selects inheritance or one unchanged system theme for a Workspace.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: none.
Body / supported fields: mode_policy, theme_id. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request PUT \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"theme_id": "simbioza",
"mode_policy": "auto"
}' \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/theme/selection" | jq '{data: {workspace_id: .data.workspace_id, settings: .data.settings, selected_theme: (.data.selected_theme | {id,label}), assets: [.data.assets[] | {file,role,used}], can_export: .data.can_export}, meta, links}'
Example response: HTTP 200.
{
"data": {
"workspace_id": 4,
"settings": {
"enabled": true,
"active_theme": "simbioza",
"mode_policy": "auto"
},
"selected_theme": {
"id": "simbioza",
"label": {
"hr": "Simbioza",
"en": "Simbioza"
}
},
"assets": [
{
"file": "hero-adriatic-dark.png",
"role": "hero",
"used": false
},
{
"file": "hero-adriatic-dark.svg",
"role": "hero",
"used": true
},
{
"file": "hero-adriatic-light.png",
"role": "hero",
"used": false
},
{
"file": "hero-adriatic-light.svg",
"role": "hero",
"used": true
},
{
"file": "hero-botanical-dark.png",
"role": "hero",
"used": false
},
{
"file": "hero-botanical-dark.svg",
"role": "hero",
"used": false
},
{
"file": "hero-botanical-light.png",
"role": "hero",
"used": false
},
{
"file": "hero-botanical-light.svg",
"role": "hero",
"used": false
},
{
"file": "hero-natural-dark.png",
"role": "hero",
"used": false
},
{
"file": "hero-natural-dark.svg",
"role": "hero",
"used": false
},
{
"file": "hero-natural-light.png",
"role": "hero",
"used": false
},
{
"file": "hero-natural-light.svg",
"role": "hero",
"used": false
},
{
"file": "icon-adriatic-dark.png",
"role": "icon",
"used": true
},
{
"file": "icon-adriatic-dark.svg",
"role": "icon",
"used": false
},
{
"file": "icon-adriatic-light.png",
"role": "icon",
"used": true
},
{
"file": "icon-adriatic-light.svg",
"role": "icon",
"used": false
},
{
"file": "icon-botanical-dark.png",
"role": "icon",
"used": false
},
{
"file": "icon-botanical-dark.svg",
"role": "icon",
"used": false
},
{
"file": "icon-botanical-light.png",
"role": "icon",
"used": false
},
{
"file": "icon-botanical-light.svg",
"role": "icon",
"used": false
},
{
"file": "icon-natural-dark.png",
"role": "icon",
"used": false
},
{
"file": "icon-natural-dark.svg",
"role": "icon",
"used": false
},
{
"file": "icon-natural-light.png",
"role": "icon",
"used": false
},
{
"file": "icon-natural-light.svg",
"role": "icon",
"used": false
}
],
"can_export": false
},
"meta": {
"request_id": "3a8b382e6a363076a026c05f7c899268"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/theme/selection"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
GET /api/v1/workspaces/{workspaceSlug}/tree
Purpose: Returns the filtered Workspace tree and effective node permissions.
Permission: workspace:read. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: lang.
Body: no additional input fields; follow the example.
curl --globoff --silent --show-error \
--request GET \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/tree"
Actual response: HTTP 200.
{
"data": [
{
"id": 36,
"uuid": "e810e7a1-ff77-42f2-ae4e-57bed7370354",
"parent_id": null,
"node_type": "document",
"slug": "api-plan-radionice",
"title": "Plan API radionice",
"title_translations": {
"en": "Plan API radionice",
"hr": "Plan API radionice"
},
"document_key": "api-plan-radionice",
"route_name": "",
"target_url": "",
"sort_order": 100,
"is_homepage": true,
"contents_visibility": "inherit",
"labels": [],
"properties": [],
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": true,
"can_delete": true,
"can_manage": true
},
"children": []
}
],
"meta": {
"request_id": "78d6b87d8ee7c962567b443c82af5111"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/tree"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
PUT /api/v1/workspaces/{workspaceSlug}/tree/order
Purpose: Stores the complete tree order and hierarchy.
Permission: workspace:manage. Current workspace/node permissions; global administration and restore require administrator rights.
Path: workspaceSlug. Take values from the preceding response. A page ID is its document key; nodeId is numeric, and a UUID is not a slug.
Query parameters: lang.
Body / supported fields: placements. The example below uses verified values; conditions and list-replacement rules are described at the start of the chapter.
curl --globoff --silent --show-error \
--request PUT \
--header "Authorization: Bearer $SIMBIOZA_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"placements": [
{
"id": 36,
"parent_id": null,
"sort_order": 100
},
{
"id": 37,
"parent_id": null,
"sort_order": 200
},
{
"id": 38,
"parent_id": null,
"sort_order": 201
}
]
}' \
"$BASE_URL/api/v1/workspaces/api-ogledno-podrucje/tree/order"
Actual response: HTTP 200.
{
"data": [
{
"id": 36,
"uuid": "e810e7a1-ff77-42f2-ae4e-57bed7370354",
"parent_id": null,
"node_type": "document",
"slug": "api-plan-radionice",
"title": "Plan API radionice",
"title_translations": {
"en": "Plan API radionice",
"hr": "Plan API radionice"
},
"document_key": "api-plan-radionice",
"route_name": "",
"target_url": "",
"sort_order": 100,
"is_homepage": true,
"contents_visibility": "inherit",
"labels": [],
"properties": [],
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": true,
"can_delete": true,
"can_manage": true
},
"children": []
},
{
"id": 37,
"uuid": "e26c1075-3a3b-4daf-96c5-8984258964e9",
"parent_id": null,
"node_type": "internal_link",
"slug": "api-internal",
"title": "API poveznica",
"title_translations": {
"en": "API poveznica"
},
"document_key": "",
"route_name": "",
"target_url": "/about",
"sort_order": 200,
"is_homepage": false,
"contents_visibility": "inherit",
"labels": [],
"properties": [],
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": true,
"can_delete": true,
"can_manage": true
},
"children": []
},
{
"id": 38,
"uuid": "5947a07a-179f-433e-9030-7abbbe9eaa6d",
"parent_id": null,
"node_type": "external_link",
"slug": "api-external",
"title": "api-external",
"title_translations": {
"en": "api-external"
},
"document_key": "",
"route_name": "",
"target_url": "https://example.com/",
"sort_order": 201,
"is_homepage": false,
"contents_visibility": "inherit",
"labels": [],
"properties": [],
"permissions": {
"can_view": true,
"can_add": true,
"can_edit": true,
"can_publish": true,
"can_delete": true,
"can_manage": true
},
"children": []
}
],
"meta": {
"request_id": "98e3352a89089722cf08b382db4fc6d2"
},
"links": {
"self": "/api/v1/workspaces/api-ogledno-podrucje/tree/order"
}
}
Errors verified for this operation: 401, 403. See shared rules for status meanings and problem responses.
Kommentare
0Es liegen noch keine Kommentare vor.
Sie müssen sich anmelden, um einen Kommentar hinzuzufügen.