Work items

Operations of the Work API. Paths are relative to your deployment's API host.

GET /api/work-api/items

List the work items of the project of the request that the caller may read

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
cursorquerystringnoOpaque cursor from a previous page. Bound to the filters it was minted under; do not construct or modify one.
dispatchablequerybooleannoOnly items that are ready with every need done.
limitquerynumberno
ownerIdquerystringno
ownerKindqueryWorkSubjectKindno
priorityqueryWorkItemPriorityno
statequeryWorkItemStateno
StatusDescriptionBody
200application/json WorkItemSummaryDtoCursorPaginatedEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/work-api/items

Create a work item in the project of the request

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json CreateWorkItemDto

StatusDescriptionBody
201application/json WorkItemDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

GET /api/work-api/items/{id}

Read a work item

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes
StatusDescriptionBody
200application/json WorkItemDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

PATCH /api/work-api/items/{id}

Edit the fields, needs or criteria of a draft or ready work item

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes

Request body: application/json UpdateWorkItemDto

StatusDescriptionBody
200application/json WorkItemDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/work-api/items/{id}/accept

Accept a work item as done, once every criterion is met

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes

Request body: application/json AcceptWorkItemDto

StatusDescriptionBody
200application/json WorkItemDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/work-api/items/{id}/assign

Give a work item a new owner

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes

Request body: application/json AssignWorkItemDto

StatusDescriptionBody
200application/json WorkItemDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/work-api/items/{id}/block

Block a work item on another item, a decision or something external

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes

Request body: application/json BlockWorkItemDto

StatusDescriptionBody
200application/json WorkItemDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

PATCH /api/work-api/items/{id}/criteria/{criterionId}

Mark an acceptance criterion met or unmet

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
criterionIdpathstringyes
idpathstringyes

Request body: application/json UpdateCriterionDto

StatusDescriptionBody
200application/json WorkItemDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/work-api/items/{id}/drop

Drop a work item

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes

Request body: application/json DropWorkItemDto

StatusDescriptionBody
200application/json WorkItemDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/work-api/items/{id}/ready

Make a draft work item ready

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes

Request body: application/json ReadyWorkItemDto

StatusDescriptionBody
200application/json WorkItemDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/work-api/items/{id}/unblock

Release a blocked work item back to ready

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes

Request body: application/json UnblockWorkItemDto

StatusDescriptionBody
200application/json WorkItemDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto