Boards

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

List boards#

GET/boardsToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`	Query	`string`	–
`search`	Query	`any`	–
`isArchived`	Query	`any`	–
`boardType`	Query	`any`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/boards" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a board#

POST/boardsToken

Request-Body`application/jsonCreateBoardDto`

Name	Typ	Beschreibung
`organizationId`	`string`	Legacy organization UUID from Next clients (ignored)
`space_id`Pflicht	`string`	Space this board belongs to
`name`Pflicht	`string`	Beispiel: `Engineering Kanban`
`board_type`Pflicht	`string`	Werte: `kanbanscrum`
`description`	`string`	–
`filter_id`	`string`	Saved filter UUID
`settings`	`object`	–
`auto_create_columns`	`boolean`	Auto-create default columns from task-statuses Standard: `false`
`default_swimlane_name`	`string`	Standard: `"Everything else"`

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/boards" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"space_id":"…","name":"Engineering Kanban","board_type":"kanban"}'

Get board detail with columns, swimlanes, card-fields, quick-filters#

GET/boards/{id}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/boards/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

PATCH /boards/{id}#

PATCH/boards/{id}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Request-Body`application/jsonUpdateBoardDto`

Name	Typ	Beschreibung
`id`	`string`	Legacy ID echo from Next clients
`organizationId`	`string`	Legacy organization UUID from Next clients (ignored)
`name`	`string`	–
`description`	`string`	–
`board_type`	`string`	Legacy board type field emitted by board settings forms Werte: `kanbanscrum`
`default_swimlane_name`	`string`	Legacy default swimlane field emitted by board settings forms
`settings`	`object`	–
`is_archived`	`boolean`	–
`sort_order`	`number`	–
`filter_id`	`object`	Saved filter UUID

Antworten

200OK

Beispiel (cURL)

curl -X PATCH "https://xapi.ambertech.cloud/api/v1/boards/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"…","organizationId":"…","name":"…"}'

DELETE /boards/{id}#

DELETE/boards/{id}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/boards/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Archive a board#

POST/boards/{id}/archiveToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{id}/archive" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Restore an archived board#

DELETE/boards/{id}/archiveToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/boards/{id}/archive" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Get card fields configured for the board#

GET/boards/{id}/card-fieldsToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/boards/{id}/card-fields" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Replace card fields for the board (atomic)#

PUT/boards/{id}/card-fieldsToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X PUT "https://xapi.ambertech.cloud/api/v1/boards/{id}/card-fields" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Add a task card to this board (inserts board_issue_ranking row)#

POST/boards/{id}/cardsToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{id}/cards" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Add a task card to this board (legacy path)#

POST/boards/{id}/cards/addToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{id}/cards/add" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Move a card across columns (optimistic lock)#

POST/boards/{id}/cards/moveToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Request-Body`application/jsonMoveCardDto`

Name	Typ	Beschreibung
`organizationId`	`string`	Legacy organization UUID from Next clients (ignored)
`task_id`Pflicht	`string`	–
`source_column_id`Pflicht	`string`	–
`target_column_id`Pflicht	`string`	–
`new_position`Pflicht	`number`	New position in target column Beispiel: `0`
`expected_version`Pflicht	`number`	Expected version for optimistic lock

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{id}/cards/move" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"task_id":"…","source_column_id":"…","target_column_id":"…","new_position":"0","expected_version":0}'

Reorder cards within a single column#

PUT/boards/{id}/cards/reorderToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Request-Body`application/jsonReorderCardsDto`

Name	Typ	Beschreibung
`organizationId`	`string`	–
`column_id`Pflicht	`string`	–
`task_ids`Pflicht	`string[]`	–

Antworten

200OK

Beispiel (cURL)

curl -X PUT "https://xapi.ambertech.cloud/api/v1/boards/{id}/cards/reorder" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"column_id":"…","task_ids":[]}'

Add a column to the board#

POST/boards/{id}/columnsToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Request-Body`application/jsonCreateColumnDto`

Name	Typ	Beschreibung
`board_id`	`string`	Legacy board UUID echo (ignored)
`organizationId`	`string`	Legacy organization UUID from Next clients (ignored)
`name`Pflicht	`string`	Beispiel: `In Progress`
`sort_order`	`number`	Beispiel: `0`
`min_wip`	`number`	Minimum WIP
`max_wip`	`number`	Maximum WIP (0 = unlimited)
`color`	`string`	Beispiel: `#3B82F6`
`is_backlog`	`boolean`	–
`is_kanban_backlog`	`boolean`	–
`is_done`	`boolean`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{id}/columns" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"In Progress"}'

PATCH /boards/{id}/columns/{columnId}#

PATCH/boards/{id}/columns/{columnId}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–
`columnId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonUpdateColumnDto`

Name	Typ	Beschreibung
`id`	`string`	Legacy column ID echo from clients
`organizationId`	`string`	Legacy organization UUID from Next clients (ignored)
`name`	`string`	–
`sort_order`	`number`	–
`min_wip`	`number`	–
`max_wip`	`number`	–
`color`	`string`	–
`is_backlog`	`boolean`	–
`is_kanban_backlog`	`boolean`	–
`is_done`	`boolean`	–

Antworten

200OK

Beispiel (cURL)

curl -X PATCH "https://xapi.ambertech.cloud/api/v1/boards/{id}/columns/{columnId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"…","organizationId":"…","name":"…"}'

DELETE /boards/{id}/columns/{columnId}#

DELETE/boards/{id}/columns/{columnId}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–
`columnId`Pflicht	Pfad	`string`	–
`target_column_id`	Query	`string`	UUID of column to receive cards from the deleted column

Antworten

200OK

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/boards/{id}/columns/{columnId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Reorder columns on a board#

PUT/boards/{id}/columns/reorderToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X PUT "https://xapi.ambertech.cloud/api/v1/boards/{id}/columns/reorder" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List quick filters for the board#

GET/boards/{id}/quick-filtersToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/boards/{id}/quick-filters" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Add a quick filter to the board#

POST/boards/{id}/quick-filtersToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{id}/quick-filters" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

PATCH /boards/{id}/quick-filters/{filterId}#

PATCH/boards/{id}/quick-filters/{filterId}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–
`filterId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X PATCH "https://xapi.ambertech.cloud/api/v1/boards/{id}/quick-filters/{filterId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

DELETE /boards/{id}/quick-filters/{filterId}#

DELETE/boards/{id}/quick-filters/{filterId}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–
`filterId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/boards/{id}/quick-filters/{filterId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Reorder quick filters#

PUT/boards/{id}/quick-filters/reorderToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X PUT "https://xapi.ambertech.cloud/api/v1/boards/{id}/quick-filters/reorder" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Sync all space tasks onto the board#

POST/boards/{id}/refreshToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{id}/refresh" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Map a status to a board column#

POST/boards/{id}/statusesToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{id}/statuses" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Remove a status-to-column mapping#

DELETE/boards/{id}/statuses/{mappingId}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–
`mappingId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/boards/{id}/statuses/{mappingId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Get statuses not yet mapped to any column#

GET/boards/{id}/statuses/unmappedToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/boards/{id}/statuses/unmapped" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List swimlanes for a board#

GET/boards/{id}/swimlanesToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/boards/{id}/swimlanes" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Add a swimlane to the board#

POST/boards/{id}/swimlanesToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{id}/swimlanes" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

PATCH /boards/{id}/swimlanes/{swimlaneId}#

PATCH/boards/{id}/swimlanes/{swimlaneId}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–
`swimlaneId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X PATCH "https://xapi.ambertech.cloud/api/v1/boards/{id}/swimlanes/{swimlaneId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

DELETE /boards/{id}/swimlanes/{swimlaneId}#

DELETE/boards/{id}/swimlanes/{swimlaneId}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–
`swimlaneId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/boards/{id}/swimlanes/{swimlaneId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Reorder swimlanes#

PUT/boards/{id}/swimlanes/reorderToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X PUT "https://xapi.ambertech.cloud/api/v1/boards/{id}/swimlanes/reorder" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Toggle column collapse state for the current user#

POST/boards/{id}/user-state/columns/{columnId}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–
`columnId`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{id}/user-state/columns/{columnId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Set quick filter active state#

PUT/boards/{id}/user-state/quick-filters/{filterId}Token

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–
`filterId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X PUT "https://xapi.ambertech.cloud/api/v1/boards/{id}/user-state/quick-filters/{filterId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Get board render view data#

GET/boards/{id}/viewToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/boards/{id}/view" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Boards

List boards#

Parameter

Antworten

Create a board#

Request-Bodyapplication/jsonCreateBoardDto

Antworten

Get board detail with columns, swimlanes, card-fields, quick-filters#

Parameter

Antworten

PATCH /boards/{id}#

Parameter

Request-Bodyapplication/jsonUpdateBoardDto

Antworten

DELETE /boards/{id}#

Parameter

Antworten

Archive a board#

Parameter

Antworten

Restore an archived board#

Parameter

Antworten

Get card fields configured for the board#

Parameter

Antworten

Replace card fields for the board (atomic)#

Parameter

Antworten

Add a task card to this board (inserts board_issue_ranking row)#

Parameter

Antworten

Add a task card to this board (legacy path)#

Parameter

Antworten

Move a card across columns (optimistic lock)#

Parameter

Request-Bodyapplication/jsonMoveCardDto

Antworten

Reorder cards within a single column#

Parameter

Request-Bodyapplication/jsonReorderCardsDto

Antworten

Add a column to the board#

Parameter

Request-Bodyapplication/jsonCreateColumnDto

Antworten

PATCH /boards/{id}/columns/{columnId}#

Parameter

Request-Bodyapplication/jsonUpdateColumnDto

Antworten

DELETE /boards/{id}/columns/{columnId}#

Parameter

Antworten

Reorder columns on a board#

Parameter

Antworten

List quick filters for the board#

Parameter

Antworten

Add a quick filter to the board#

Parameter

Antworten

PATCH /boards/{id}/quick-filters/{filterId}#

Parameter

Antworten

DELETE /boards/{id}/quick-filters/{filterId}#

Parameter

Antworten

Reorder quick filters#

Parameter

Antworten

Sync all space tasks onto the board#

Parameter

Antworten

Map a status to a board column#

Parameter

Antworten

Remove a status-to-column mapping#

Parameter

Request-Body`application/jsonCreateBoardDto`

Request-Body`application/jsonUpdateBoardDto`

Request-Body`application/jsonMoveCardDto`

Request-Body`application/jsonReorderCardsDto`

Request-Body`application/jsonCreateColumnDto`

Request-Body`application/jsonUpdateColumnDto`