curl --request PATCH \
--url https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/statuses/{statusId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"description": "<string>",
"color": "<string>",
"position": "<string>",
"status": "<string>"
}
'import requests
url = "https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/statuses/{statusId}"
payload = {
"name": "<string>",
"description": "<string>",
"color": "<string>",
"position": "<string>",
"status": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
description: '<string>',
color: '<string>',
position: '<string>',
status: '<string>'
})
};
fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/statuses/{statusId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
description: '<string>',
color: '<string>',
position: '<string>',
status: '<string>'
})
};
fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/statuses/{statusId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"position": "<string>",
"color": "<string>",
"status": "<string>",
"transition_state": "not_started",
"closeMode": "off",
"team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}Update a workflow status
Updates a team status name, order, analytics state, or close mode.
curl --request PATCH \
--url https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/statuses/{statusId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"description": "<string>",
"color": "<string>",
"position": "<string>",
"status": "<string>"
}
'import requests
url = "https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/statuses/{statusId}"
payload = {
"name": "<string>",
"description": "<string>",
"color": "<string>",
"position": "<string>",
"status": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
description: '<string>',
color: '<string>',
position: '<string>',
status: '<string>'
})
};
fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/statuses/{statusId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
description: '<string>',
color: '<string>',
position: '<string>',
status: '<string>'
})
};
fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/statuses/{statusId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"position": "<string>",
"color": "<string>",
"status": "<string>",
"transition_state": "not_started",
"closeMode": "off",
"team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}Authorizations
Personal access token. The scopes granted at issuance determine both which
operations the key may call and the ceiling on the resource permissions it
can exercise. Each scope family is a ladder: projects:manage implies
projects:write and projects:read; cards:manage implies cards:write
and cards:read; and teams:manage implies teams:write and teams:read.
These are named API capability bundles, not blanket domain roles:
manage exposes only the permissions enumerated for that scope and never
bypasses the acting user's current role-based access.
Path Parameters
Organization id.
Agile team id.
Team workflow-status id.
Body
Response
Updated workflow status.
Hide child attributes
Hide child attributes
Workflow-status lifecycle flag; active is the database default.
not_started, started, closed off, manual, automatic