XISUITEDokumentation

Sprints

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

List sprints for a board#

GET/boards/{boardId}/sprintsToken

Parameter

NameOrtTypBeschreibung
boardIdPflichtPfadstring–
include_completedQuerystring–
includeCompletedPflichtQuerystring–

Antworten

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

Create a sprint#

POST/boards/{boardId}/sprintsToken

Parameter

NameOrtTypBeschreibung
boardIdPflichtPfadstring–

Request-Bodyapplication/jsonCreateSprintDto

NameTypBeschreibung
organizationIdstring

Legacy organization UUID from Next clients (ignored)

namePflichtstring

Beispiel: Sprint 1

goalstring

Beispiel: Ship user authentication

start_datestring

Beispiel: 2026-04-21

end_datestring

Beispiel: 2026-05-04

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{boardId}/sprints" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sprint 1"}'

Get sprint by ID#

GET/boards/{boardId}/sprints/{sprintId}Token

Parameter

NameOrtTypBeschreibung
boardIdPflichtPfadstring–
sprintIdPflichtPfadstring–

Antworten

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

Update sprint fields#

PATCH/boards/{boardId}/sprints/{sprintId}Token

Parameter

NameOrtTypBeschreibung
boardIdPflichtPfadstring–
sprintIdPflichtPfadstring–

Request-Bodyapplication/jsonUpdateSprintDto

NameTypBeschreibung
idstring

Legacy sprint ID echo from clients

organizationIdstring

Legacy organization UUID from Next clients (ignored)

namestring

Beispiel: Sprint 1

goalstring

Beispiel: Ship user authentication

sort_ordernumber

Beispiel: 1

Antworten

  • 200OK
Beispiel (cURL)
curl -X PATCH "https://xapi.ambertech.cloud/api/v1/boards/{boardId}/sprints/{sprintId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"…","organizationId":"…","name":"Sprint 1"}'

Delete a sprint (planning status only)#

DELETE/boards/{boardId}/sprints/{sprintId}Token

Parameter

NameOrtTypBeschreibung
boardIdPflichtPfadstring–
sprintIdPflichtPfadstring–

Antworten

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

Complete a sprint and handle incomplete tasks#

POST/boards/{boardId}/sprints/{sprintId}/completeToken

Parameter

NameOrtTypBeschreibung
boardIdPflichtPfadstring–
sprintIdPflichtPfadstring–

Request-Bodyapplication/jsonCompleteSprintDto

NameTypBeschreibung
sprint_idstring

Legacy sprint UUID echoed by Next clients (ignored; path param is authoritative)

organizationIdstring

Legacy organization UUID from Next clients (ignored)

actionPflichtstring

Werte: move_to_sprintmove_to_backlog

target_sprint_idstring

Required when action is move_to_sprint

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{boardId}/sprints/{sprintId}/complete" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"move_to_sprint"}'

Start a sprint (planning → active)#

POST/boards/{boardId}/sprints/{sprintId}/startToken

Parameter

NameOrtTypBeschreibung
boardIdPflichtPfadstring–
sprintIdPflichtPfadstring–

Request-Bodyapplication/jsonStartSprintDto

NameTypBeschreibung
organizationIdstring–
start_datePflichtstring

Beispiel: 2026-04-21

end_datePflichtstring

Beispiel: 2026-05-04

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{boardId}/sprints/{sprintId}/start" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"start_date":"2026-04-21","end_date":"2026-05-04"}'

Get backlog view with sprint tasks (scrum boards only)#

GET/boards/{boardId}/sprints/backlogToken

Parameter

NameOrtTypBeschreibung
boardIdPflichtPfadstring–

Antworten

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

Reorder tasks in the backlog#

PUT/boards/{boardId}/sprints/backlog/reorderToken

Parameter

NameOrtTypBeschreibung
boardIdPflichtPfadstring–

Request-Bodyapplication/jsonReorderBacklogDto

NameTypBeschreibung
organizationIdstring–
task_idsPflichtstring[]–

Antworten

  • 200OK
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/boards/{boardId}/sprints/backlog/reorder" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"task_ids":[]}'

Move tasks between sprints or to backlog#

POST/boards/{boardId}/sprints/move-tasksToken

Parameter

NameOrtTypBeschreibung
boardIdPflichtPfadstring–

Request-Bodyapplication/jsonMoveTasksDto

NameTypBeschreibung
organizationIdstring

Legacy organization UUID from Next clients (ignored)

task_idsPflichtstring[]–
target_sprint_idobject

UUID of target sprint, or null to move to backlog

Antworten

  • 200OK
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/boards/{boardId}/sprints/move-tasks" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"task_ids":[]}'
Stand: 25. Oktober 2026© 2026 XISUITE · AmberTech Solutions