Custom task statuses can be created to be used on tasks (stories). Custom task statuses are associated to task status sets, which can be applied to projects (workspaces).
This endpoint returns structured Custom Task Status objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results
array
and will be indexed by ID in the custom_task_statuses
top-level JSON key.
Please see our Response Format section for more information.
{- "count": 0,
- "meta": {
- "count": 0,
- "page_count": 0,
- "page_number": 0,
- "page_size": 0
}, - "results": [
- {
- "key": "string",
- "id": "string"
}
], - "custom_task_statuses": {
- "property1": {
- "category": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "position": 0,
- "status": "string",
- "status_set_id": 0,
- "task_status_set_id": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "property2": {
- "category": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "position": 0,
- "status": "string",
- "status_set_id": 0,
- "task_status_set_id": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}, - "task_status_sets": {
- "property1": {
- "created_at": "2019-08-24T14:15:22Z",
- "custom_task_status_ids": [
- "string"
], - "name": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "property2": {
- "created_at": "2019-08-24T14:15:22Z",
- "custom_task_status_ids": [
- "string"
], - "name": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
}
Adds a new custom status to a task status set.
This endpoint returns structured Custom Task Status objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results
array
and will be indexed by ID in the custom_task_statuses
top-level JSON key.
Please see our Response Format section for more information.
{- "custom_task_status": {
- "status": "string",
- "category": "string",
- "status_set_id": 0
}
}
{- "count": 0,
- "meta": {
- "count": 0,
- "page_count": 0,
- "page_number": 0,
- "page_size": 0
}, - "results": [
- {
- "key": "string",
- "id": "string"
}
], - "custom_task_statuses": {
- "property1": {
- "category": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "position": 0,
- "status": "string",
- "status_set_id": 0,
- "task_status_set_id": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "property2": {
- "category": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "position": 0,
- "status": "string",
- "status_set_id": 0,
- "task_status_set_id": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}, - "task_status_sets": {
- "property1": {
- "created_at": "2019-08-24T14:15:22Z",
- "custom_task_status_ids": [
- "string"
], - "name": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "property2": {
- "created_at": "2019-08-24T14:15:22Z",
- "custom_task_status_ids": [
- "string"
], - "name": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
}
This endpoint returns structured Custom Task Status objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results
array
and will be indexed by ID in the custom_task_statuses
top-level JSON key.
Please see our Response Format section for more information.
include | string Any of the below associations can be included in your request by providing the
|
{- "count": 0,
- "meta": {
- "count": 0,
- "page_count": 0,
- "page_number": 0,
- "page_size": 0
}, - "results": [
- {
- "key": "string",
- "id": "string"
}
], - "custom_task_statuses": {
- "property1": {
- "category": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "position": 0,
- "status": "string",
- "status_set_id": 0,
- "task_status_set_id": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "property2": {
- "category": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "position": 0,
- "status": "string",
- "status_set_id": 0,
- "task_status_set_id": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}, - "task_status_sets": {
- "property1": {
- "created_at": "2019-08-24T14:15:22Z",
- "custom_task_status_ids": [
- "string"
], - "name": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "property2": {
- "created_at": "2019-08-24T14:15:22Z",
- "custom_task_status_ids": [
- "string"
], - "name": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
}
Updates a custom task status. The name and position in the task status set can be updated. The status cannot be moved to a different status set and the category cannot be changed.
This endpoint returns structured Custom Task Status objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results
array
and will be indexed by ID in the custom_task_statuses
top-level JSON key.
Please see our Response Format section for more information.
include | string Any of the below associations can be included in your request by providing the
|
{- "custom_task_status": {
- "status": "string",
- "position": 0
}
}
{- "count": 0,
- "meta": {
- "count": 0,
- "page_count": 0,
- "page_number": 0,
- "page_size": 0
}, - "results": [
- {
- "key": "string",
- "id": "string"
}
], - "custom_task_statuses": {
- "property1": {
- "category": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "position": 0,
- "status": "string",
- "status_set_id": 0,
- "task_status_set_id": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "property2": {
- "category": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "position": 0,
- "status": "string",
- "status_set_id": 0,
- "task_status_set_id": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}, - "task_status_sets": {
- "property1": {
- "created_at": "2019-08-24T14:15:22Z",
- "custom_task_status_ids": [
- "string"
], - "name": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "property2": {
- "created_at": "2019-08-24T14:15:22Z",
- "custom_task_status_ids": [
- "string"
], - "name": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
}
Deletes a custom task status within a task status set. If assigned to a task (story), the task’s status
will default to the status type (category)—not started
, started
, needs info
, or completed
.
The response will contain no content and an HTTP 204 status code if the request was successful, or a standard Kantata OX error message explaining why the object could not be deleted.
Custom Task Status has been deleted.
Bad Request
Unauthorized request
Forbidden request
Page Not Found
Unprocessable Entity
Service is unavailable
{- "errors": [
- {
- "type": "string",
- "message": "string"
}
]
}