XISUITEDokumentation

Lists

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

GET /lists/display-config/{spaceId}/{schemaId}#

GET/lists/display-config/{spaceId}/{schemaId}Token

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
schemaIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/display-config/{spaceId}/{schemaId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

PUT /lists/display-config/{spaceId}/{schemaId}#

PUT/lists/display-config/{spaceId}/{schemaId}Token

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
schemaIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/lists/display-config/{spaceId}/{schemaId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a list schema and rows from CSV or Excel#

POST/lists/importToken

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/import" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List items in a schema (paginated)#

GET/lists/itemsToken

Parameter

NameOrtTypBeschreibung
schemaIdPflichtQuerystring–
pageQuerystring–
pageSizeQuerystring–
searchQuerystring–
isArchivedQuerystring–
sortColumnPflichtQuerystring–
sortDirectionPflichtQuerystring–
column_filtersPflichtQuerystring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/items" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a list item#

POST/lists/itemsToken

Request-Bodyapplication/jsonCreateListItemDto

NameTypBeschreibung
schema_idPflichtstring

List schema UUID (asset_schemas.id)

space_idstring

Space UUID — inferred from schema if omitted

titlePflichtstring

Beispiel: Row title

descriptionstring–
fields_dataobject

Structured field values keyed by column ID

custom_field_valuesobject

Custom field values keyed by field ID

row_ordernumber

Sort position — auto-assigned if omitted

is_archivedboolean

Standard: false

versionnumber

Initial version (defaults to 1)

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/items" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"schema_id":"…","title":"Row title"}'

GET /lists/items/{itemId}#

GET/lists/items/{itemId}Token

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

PATCH /lists/items/{itemId}#

PATCH/lists/items/{itemId}Token

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–

Request-Bodyapplication/jsonUpdateListItemDto

NameTypBeschreibung
titlestring–
descriptionstring–
fields_dataobject

Structured field values keyed by column ID

custom_field_valuesobject

Custom field values keyed by field ID

row_ordernumber

Sort position within schema

is_archivedboolean–
versionnumber

Current version for optimistic locking

Antworten

  • 200OK
Beispiel (cURL)
curl -X PATCH "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"…","description":"…","fields_data":{}}'

DELETE /lists/items/{itemId}#

DELETE/lists/items/{itemId}Token

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Get attachments for a list item#

GET/lists/items/{itemId}/attachmentsToken

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/attachments" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Upload an attachment for a list item#

POST/lists/items/{itemId}/attachmentsToken

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/attachments" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Get download URL for an attachment#

GET/lists/items/{itemId}/attachments/{attachmentId}Token

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–
attachmentIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/attachments/{attachmentId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Delete an attachment from a list item#

DELETE/lists/items/{itemId}/attachments/{attachmentId}Token

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–
attachmentIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/attachments/{attachmentId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Get comments for a list item#

GET/lists/items/{itemId}/commentsToken

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/comments" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a comment on a list item#

POST/lists/items/{itemId}/commentsToken

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/comments" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Update a comment on a list item#

PUT/lists/items/{itemId}/comments/{commentId}Token

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–
commentIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/comments/{commentId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Delete a comment from a list item#

DELETE/lists/items/{itemId}/comments/{commentId}Token

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–
commentIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/comments/{commentId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Get custom field values for a list item#

GET/lists/items/{itemId}/custom-fieldsToken

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/custom-fields" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Update custom field values for a list item#

PUT/lists/items/{itemId}/custom-fieldsToken

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/custom-fields" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Get change history for a list item#

GET/lists/items/{itemId}/historyToken

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/history" \
  -H "Authorization: Bearer $XISUITE_TOKEN"
GET/lists/items/{itemId}/linksToken

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/links" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a link for a list item#

POST/lists/items/{itemId}/linksToken

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/links" \
  -H "Authorization: Bearer $XISUITE_TOKEN"
DELETE/lists/items/{itemId}/links/{linkId}Token

Parameter

NameOrtTypBeschreibung
itemIdPflichtPfadstring–
linkIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/lists/items/{itemId}/links/{linkId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Bulk archive list items#

POST/lists/items/bulk-archiveToken

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/items/bulk-archive" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Bulk delete list items#

POST/lists/items/bulk-deleteToken

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/items/bulk-delete" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Bulk restore archived list items#

POST/lists/items/bulk-restoreToken

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/items/bulk-restore" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Bulk update individual cells across items#

POST/lists/items/bulk-update-cellsToken

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/items/bulk-update-cells" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Reorder items within a schema#

POST/lists/items/reorderToken

Request-Bodyapplication/jsonReorderListItemsDto

NameTypBeschreibung
list_idPflichtstring

List schema UUID

item_idsPflichtstring[]

Item IDs in their desired order

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/items/reorder" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"list_id":"…","item_ids":[]}'

List schemas#

GET/lists/schemasToken

Parameter

NameOrtTypBeschreibung
spaceIdQuerystring–
isArchivedQuerystring–
searchQuerystring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/schemas" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a list schema#

POST/lists/schemasToken

Request-Bodyapplication/jsonCreateListSchemaDto

NameTypBeschreibung
space_idPflichtstring–
namePflichtstring

Beispiel: Asset Register

descriptionstring–
typestring

Werte: kanbanchecklisttable

Standard: "table"

keystring–
iconstring–
fields_definitionstring[]–
column_configstring[]–
settingsobject–
permissionsobject–
field_group_idsstring[]–
statusstring

Standard: "active"

versionnumber

Standard: 1

is_activeboolean

Standard: true

ispublicboolean–

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/schemas" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"space_id":"…","name":"Asset Register"}'

GET /lists/schemas/{schemaId}#

GET/lists/schemas/{schemaId}Token

Parameter

NameOrtTypBeschreibung
schemaIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/schemas/{schemaId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

PUT /lists/schemas/{schemaId}#

PUT/lists/schemas/{schemaId}Token

Parameter

NameOrtTypBeschreibung
schemaIdPflichtPfadstring–

Request-Bodyapplication/jsonUpdateListSchemaDto

NameTypBeschreibung
namestring–
descriptionstring–
typestring

Werte: kanbanchecklisttable

keystring–
iconstring–
fields_definitionstring[]–
column_configstring[]–
settingsobject–
permissionsobject–
field_group_idsstring[]–
statusstring–
versionnumber–
is_activeboolean–
ispublicboolean–

Antworten

  • 200OK
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/lists/schemas/{schemaId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"…","description":"…","type":"kanban"}'

DELETE /lists/schemas/{schemaId}#

DELETE/lists/schemas/{schemaId}Token

Parameter

NameOrtTypBeschreibung
schemaIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/lists/schemas/{schemaId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Add a column to a schema#

POST/lists/schemas/{schemaId}/columnsToken

Parameter

NameOrtTypBeschreibung
schemaIdPflichtPfadstring–

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/schemas/{schemaId}/columns" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Rename a column#

PUT/lists/schemas/{schemaId}/columns/{columnId}Token

Parameter

NameOrtTypBeschreibung
schemaIdPflichtPfadstring–
columnIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/lists/schemas/{schemaId}/columns/{columnId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Remove a column from a schema#

DELETE/lists/schemas/{schemaId}/columns/{columnId}Token

Parameter

NameOrtTypBeschreibung
schemaIdPflichtPfadstring–
columnIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/lists/schemas/{schemaId}/columns/{columnId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Reorder columns in a schema#

PUT/lists/schemas/{schemaId}/columns/reorderToken

Parameter

NameOrtTypBeschreibung
schemaIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/lists/schemas/{schemaId}/columns/reorder" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Export schema items to CSV#

GET/lists/schemas/{schemaId}/exportToken

Parameter

NameOrtTypBeschreibung
schemaIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/schemas/{schemaId}/export" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Import CSV or Excel rows into a list schema#

POST/lists/schemas/{schemaId}/importToken

Parameter

NameOrtTypBeschreibung
schemaIdPflichtPfadstring–

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/schemas/{schemaId}/import" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Permanently delete a schema and all its items#

DELETE/lists/schemas/{schemaId}/permanentToken

Parameter

NameOrtTypBeschreibung
schemaIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/lists/schemas/{schemaId}/permanent" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Restore an archived schema (set is_active=true)#

POST/lists/schemas/{schemaId}/restoreToken

Parameter

NameOrtTypBeschreibung
schemaIdPflichtPfadstring–

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/lists/schemas/{schemaId}/restore" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

GET /lists/schemas/by-key/{key}#

GET/lists/schemas/by-key/{key}Token

Parameter

NameOrtTypBeschreibung
keyPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/schemas/by-key/{key}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"
GET/lists/task-links/{taskId}Token

Parameter

NameOrtTypBeschreibung
taskIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/lists/task-links/{taskId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

POST /spaces/{spaceId}/lists/import#

POST/spaces/{spaceId}/lists/importToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/lists/import" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

GET /spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields#

GET/spaces/{spaceId}/lists/schemas/{schemaId}/custom-fieldsToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
schemaIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

POST /spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields#

POST/spaces/{spaceId}/lists/schemas/{schemaId}/custom-fieldsToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
schemaIdPflichtPfadstring–

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

PATCH /spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields/{assignmentId}#

PATCH/spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields/{assignmentId}Token

Parameter

NameOrtTypBeschreibung
assignmentIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X PATCH "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields/{assignmentId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

DELETE /spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields/{assignmentId}#

DELETE/spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields/{assignmentId}Token

Parameter

NameOrtTypBeschreibung
assignmentIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields/{assignmentId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

PUT /spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields/reorder#

PUT/spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields/reorderToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
schemaIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields/reorder" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

PUT /spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields/sync#

PUT/spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields/syncToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
schemaIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/lists/schemas/{schemaId}/custom-fields/sync" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

POST /spaces/{spaceId}/lists/schemas/{schemaId}/import#

POST/spaces/{spaceId}/lists/schemas/{schemaId}/importToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
schemaIdPflichtPfadstring–

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/lists/schemas/{schemaId}/import" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

POST /spaces/{spaceId}/lists/schemas/{schemaId}/import/preview#

POST/spaces/{spaceId}/lists/schemas/{schemaId}/import/previewToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
schemaIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/lists/schemas/{schemaId}/import/preview" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

POST /spaces/{spaceId}/lists/schemas/{schemaId}/restore#

POST/spaces/{spaceId}/lists/schemas/{schemaId}/restoreToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
schemaIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/lists/schemas/{schemaId}/restore" \
  -H "Authorization: Bearer $XISUITE_TOKEN"
Stand: 25. Oktober 2026© 2026 XISUITE · AmberTech Solutions