POST /data/task-status-links

Create a link between a project and a task status. Sets the priority and roles that can view it on the board.

application/json

Body Required

  • project_id string(uuid) Required
  • task_status_id string(uuid) Required
  • priority integer

    Priority of the task status in the project

    Default value is 1.

  • roles_for_board array[string]

    Roles allowed to see this status on the board

Responses

  • 201 application/json

    Project task status link created successfully

    Hide response attributes Show response attributes object
    • id string(uuid)
    • project_id string(uuid)
    • task_status_id string(uuid)
    • priority integer
    • roles_for_board array[string]
  • 400

    Invalid project or task status

POST /data/task-status-links
curl -X POST "http://api.example.com/data/task-status-links" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "project_id": "a24a6ea4-ce75-4665-a070-57453082c25",
  "task_status_id": "b24a6ea4-ce75-4665-a070-57453082c25",
  "priority": 1,
  "roles_for_board": [
    "admin",
    "manager"
  ]
}'
import requests

url = "http://api.example.com/data/task-status-links"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
}
params = {}
payload = {
    "project_id": "a24a6ea4-ce75-4665-a070-57453082c25",
    "task_status_id": "b24a6ea4-ce75-4665-a070-57453082c25",
    "priority": 1,
    "roles_for_board": [
        "admin",
        "manager"
    ]
}

response = requests.post(
    url,
    headers=headers,
    params=params,
    json=payload
)

response.raise_for_status()

if response.content:
    print(response.json())
curl \
 --request POST 'http://api.example.com/data/task-status-links' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"project_id":"a24a6ea4-ce75-4665-a070-57453082c25","task_status_id":"b24a6ea4-ce75-4665-a070-57453082c25","priority":1,"roles_for_board":["admin","manager"]}'
Request examples
{
  "project_id": "a24a6ea4-ce75-4665-a070-57453082c25",
  "task_status_id": "b24a6ea4-ce75-4665-a070-57453082c25",
  "priority": 1,
  "roles_for_board": [
    "admin",
    "manager"
  ]
}
Response examples (201)
{
  "id": "c24a6ea4-ce75-4665-a070-57453082c25",
  "project_id": "a24a6ea4-ce75-4665-a070-57453082c25",
  "task_status_id": "b24a6ea4-ce75-4665-a070-57453082c25",
  "priority": 1,
  "roles_for_board": [
    "admin",
    "manager"
  ]
}