Skip to content

Task Pipelines and Labels ​

Two short lists you need to fill task fields: the task pipelines (the boards of the Tasks module, grouped by project) and the task labels. Both require tasks:read.

List task pipelines ​

GET /external/v1/task-pipelines

Active task pipelines of the account. Use the id as task_pipeline_id when creating or filtering tasks. A task created without task_pipeline_id goes to the pipeline with is_default: true.

bash
curl --request GET \
  --url "https://app.getraze.com/external/v1/task-pipelines" \
  --header "X-API-Key: YOUR_API_KEY"
json
{
  "success": true,
  "data": [
    {
      "id": "4a0631b8-b1cb-48c6-af5e-9df2bca56645",
      "name": "General",
      "color": "#6366f1",
      "is_default": true,
      "project": { "id": "900b9b7e-7bb2-4162-b611-091905d2a90d", "name": "CRM" }
    }
  ]
}
FieldTypeDescription
idstringTask pipeline identifier
namestringPipeline name
colorstringHex color
is_defaultbooleanWhere tasks go when no pipeline is given
projectobjectProject the pipeline belongs to (nullable)

List task labels ​

GET /external/v1/task-labels

Labels used on tasks (separate from the contact tags). Use the ids in label_ids.

bash
curl --request GET \
  --url "https://app.getraze.com/external/v1/task-labels" \
  --header "X-API-Key: YOUR_API_KEY"
json
{
  "success": true,
  "data": [
    { "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d", "name": "VIP", "color": "#ef4444" }
  ]
}

GetRaze - AI-Powered Lead Generation