Space Templates
7 Endpunkte. Basis-URL: https://xapi.ambertech.cloud/api/v1
List space templates#
GET
/space-templatesTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
organizationIdPflicht | Query | string | – |
Antworten
- 200List of space templates
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/space-templates" \
-H "Authorization: Bearer $XISUITE_TOKEN"Create a space template#
POST
/space-templatesTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
organizationId | Query | string | – |
Request-Body
| Name | Typ | Beschreibung |
|---|---|---|
namePflicht | string | Template display name |
description | string | Short description of the template |
icon | string | Icon identifier |
color | string | Hex color |
category | string | Category label |
config | object | Template config (JSONB snapshot) |
is_active | boolean | Whether this template is active |
Antworten
- 201Created
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/space-templates" \
-H "Authorization: Bearer $XISUITE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Risk Workspace"}'Get a space template by id#
GET
/space-templates/{id}TokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
idPflicht | Pfad | string | – |
organizationId | Query | string | – |
Antworten
- 200Space template detail
- 404Not found
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/space-templates/{id}" \
-H "Authorization: Bearer $XISUITE_TOKEN"Update a space template#
PUT
/space-templates/{id}TokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
idPflicht | Pfad | string | – |
organizationId | Query | string | – |
Request-Body
| Name | Typ | Beschreibung |
|---|---|---|
name | string | Template display name |
description | string | Short description |
icon | string | Icon identifier |
color | string | Hex color |
category | string | Category label |
config | object | Template config (JSONB snapshot) |
is_active | boolean | Whether this template is active |
Antworten
- 200Updated
- 403Cannot modify system template
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/space-templates/{id}" \
-H "Authorization: Bearer $XISUITE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"…","description":"…","icon":"…"}'Delete a space template#
DELETE
/space-templates/{id}TokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
idPflicht | Pfad | string | – |
organizationId | Query | string | – |
Antworten
- 204Deleted
- 403Cannot delete system template
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/space-templates/{id}" \
-H "Authorization: Bearer $XISUITE_TOKEN"Apply a template to an existing space#
POST
/space-templates/{id}/apply/{spaceId}TokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
idPflicht | Pfad | string | Template id |
spaceIdPflicht | Pfad | string | Target space id |
organizationId | Query | string | – |
Antworten
- 200Template applied
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/space-templates/{id}/apply/{spaceId}" \
-H "Authorization: Bearer $XISUITE_TOKEN"Save a space config as a template#
POST
/space-templates/from-space/{spaceId}TokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
spaceIdPflicht | Pfad | string | – |
organizationId | Query | string | – |
Request-Body
| Name | Typ | Beschreibung |
|---|---|---|
namePflicht | string | Template name |
description | string | Short description |
icon | string | Icon identifier |
color | string | Hex color |
Antworten
- 201Template created from space
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/space-templates/from-space/{spaceId}" \
-H "Authorization: Bearer $XISUITE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"My Space Template"}'