XISUITEDokumentation

User Preferences

14 Endpunkte. Basis-URL: https://xapi.ambertech.cloud/api/v1

Get column preferences for a view#

GET/users/column-preferencesToken

Returns saved preferences or defaults (is_default: true) when no record exists.

Parameter

NameOrtTypBeschreibung
viewIdPflichtQuerystring–

Antworten

  • 200Column preferences returned
  • 400viewId is required
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/users/column-preferences" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Save column preferences for a view (upsert)#

POST/users/column-preferencesToken

Request-Bodyapplication/jsonSaveColumnPreferencesDto

NameTypBeschreibung
view_idPflichtstring

View identifier (e.g. tasks, processes, gdpr, list-items, backlog, plan_gantt)

column_configPflichtColumnConfigItemDto[]–
column_config[].idPflichtstring

Column identifier

column_config[].visiblePflichtboolean

Whether the column is visible

column_config[].orderPflichtnumber

Display order (0-based)

Antworten

  • 201Preferences saved
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/users/column-preferences" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"view_id":"…","column_config":[]}'

Reset column preferences to defaults#

DELETE/users/column-preferencesToken

Parameter

NameOrtTypBeschreibung
viewIdPflichtQuerystring–

Antworten

  • 200Preferences reset
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/users/column-preferences" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Get recent items#

GET/users/recent-itemsToken

Returns recently accessed items for the authenticated user, ordered by most recent first.

Parameter

NameOrtTypBeschreibung
limitQuerynumber

Maximum number of items to return (default: 10)

item_typeQuerystring

Filter by item type (e.g., space, page, issue)

Antworten

  • 200Recent items returned
  • 401Not authenticated
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/users/recent-items" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Track item access#

POST/users/recent-itemsToken

Records or updates a recently accessed item for the authenticated user.

Request-Bodyapplication/jsonTrackRecentItemDto

NameTypBeschreibung
item_typePflichtstring

Type of item accessed

Beispiel: space

item_idPflichtstring

UUID of the accessed item

Beispiel: 550e8400-e29b-41d4-a716-446655440000

item_namePflichtstring

Display name of the item

Beispiel: Project Alpha

item_keystring

Short key or identifier

Beispiel: PA-123

item_iconstring

Icon identifier

Beispiel: folder

item_metadataobject

Additional metadata

Antworten

  • 201Item access tracked
  • 400Validation error
  • 401Not authenticated
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/users/recent-items" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"item_type":"space","item_id":"550e8400-e29b-41d4-a716-446655440000","item_name":"Project Alpha"}'

Clear all recent items#

DELETE/users/recent-itemsToken

Deletes all recent item records for the authenticated user.

Antworten

  • 200All recent items cleared
  • 401Not authenticated
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/users/recent-items" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Remove specific recent item#

DELETE/users/recent-items/{itemType}/{itemId}Token

Deletes a specific recent item by its type and ID for the authenticated user.

Parameter

NameOrtTypBeschreibung
itemTypePflichtPfadstring

Item type (e.g., space, page)

itemIdPflichtPfadstring

UUID of the item

Antworten

  • 200Recent item removed
  • 401Not authenticated
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/users/recent-items/{itemType}/{itemId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Get sidebar preferences#

GET/users/sidebar-preferencesToken

Returns the authenticated user's sidebar configuration, or defaults if none set.

Antworten

  • 200Sidebar preferences returned
  • 401Not authenticated
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/users/sidebar-preferences" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Update sidebar preferences#

PATCH/users/sidebar-preferencesToken

Updates the authenticated user's sidebar configuration. Only provided fields are merged.

Request-Bodyapplication/jsonUpdateSidebarPreferencesDto

NameTypBeschreibung
sectionsstring[]

Sidebar sections with id, visible flag, and order

externalLinksstring[]

External links displayed in the sidebar

spacesExpandedboolean

Whether the spaces section is expanded

Beispiel: true

recentItemsCountnumber

Number of recent items to display (5–30)

Beispiel: 10

Antworten

  • 200Sidebar preferences updated
  • 400Validation error
  • 401Not authenticated
Beispiel (cURL)
curl -X PATCH "https://xapi.ambertech.cloud/api/v1/users/sidebar-preferences" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sections":[],"externalLinks":[],"spacesExpanded":"true"}'

Reset sidebar preferences#

POST/users/sidebar-preferences/resetToken

Deletes the stored sidebar configuration and returns defaults.

Antworten

  • 201Sidebar preferences reset
  • 401Not authenticated
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/users/sidebar-preferences/reset" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Get starred spaces#

GET/users/starred-spacesToken

Returns all spaces starred by the authenticated user, with space details.

Antworten

  • 200Starred spaces returned
  • 401Not authenticated
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/users/starred-spaces" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Toggle star on a space#

POST/users/starred-spacesToken

Stars a space if not already starred, or unstars it if already starred.

Request-Bodyapplication/jsonToggleStarDto

NameTypBeschreibung
space_idPflichtstring

UUID of the space to star or unstar

Beispiel: 550e8400-e29b-41d4-a716-446655440000

Antworten

  • 201Star toggled successfully
  • 400Validation error
  • 401Not authenticated
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/users/starred-spaces" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"space_id":"550e8400-e29b-41d4-a716-446655440000"}'

Get task comment sort preference#

GET/users/task-comment-preferencesToken

Antworten

  • 200Sort preference returned
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/users/task-comment-preferences" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Save task comment sort preference (upsert)#

PUT/users/task-comment-preferencesToken

Request-Bodyapplication/jsonSaveTaskCommentPreferencesDto

NameTypBeschreibung
sortPflichtstring

Task comment sort order

Werte: oldestnewestupdated_descupdated_ascauthor_ascauthor_descmessage_ascmessage_desc

thenstring[]

Orders for comments with the same user name or text, applied in sequence (one created and one updated at most)

Werte: oldestnewestupdated_descupdated_asc

Antworten

  • 200Sort preference saved
  • 400Validation error
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/users/task-comment-preferences" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sort":"oldest"}'
Stand: 25. Oktober 2026© 2026 XISUITE · AmberTech Solutions