HEhellobonsai
Tasks

List subtasks

Lists the tasks nested under a parent task, in the order they appear beneath it. Each one carries the same fields as a task in the list endpoint.

Archived and deleted subtasks are left out; completed ones are not.

get/public-api/v1/tasks/{task_id}/subtasks

Request

  • Base URL
    https://app.hellobonsai.com
  • URL
    https://app.hellobonsai.com/public-api/v1/tasks/{task_id}/subtasks
  • Auth
    • OAuth 2
      Authorization code: https://app.hellobonsai.com/oauth/authorize
      Token URL: https://app.hellobonsai.com/oauth/token
    • or HTTP bearer

Path parameters

task_idstring required

The parent task's uuid.

Query parameters

page[number]integer

Page to return, starting at 1.

page[size]integer

Records per page. Defaults to 25; anything above 100 is reduced to 100.

Response

A page of the parent's subtasks.

Example response

{
  "data": [
    {
      "uuid": "ad3fdad8-5072-46df-8800-bb57299179df",
      "title": "Finalize homepage mockups",
      "number": "ACME-00104",
      "due_date": "2026-05-15",
      "start_date": "2026-05-01",
      "time_estimate_in_minutes": 90,
      "priority": "high",
      "completed_at": "2026-04-14T09:12:04.000Z",
      "archived_at": "2026-04-14T09:12:04.000Z",
      "assignee_id": 6012,
      "assignee_member_id": 314,
      "creator_member_id": 315,
      "project_id": 51,
      "billable": true,
      "deal_id": 17,
      "parent_task_uuid": "e5b1c7d2-91aa-4f30-8f6d-2c1b4a5e7f80",
      "project_title": "Acme Website",
      "assignee_member_name": "Maria Santos",
      "url": "https://app.hellobonsai.com/tasks/ad3fdad8-5072-46df-8800-bb57299179df",
      "task_status": {
        "id": "e1c4b06e-3a0f-4a52-9c8f-6a1d2b3c4d5e",
        "status": "In Progress",
        "state": "active",
        "color": "#520EB0",
        "position": 1
      },
      "company_tags": [
        {
          "id": 7,
          "name": "VIP"
        }
      ]
    }
  ],
  "meta": {
    "request_id": "b1f0d2c4-7a9e-4c3b-8d5f-1e2a3b4c5d6e",
    "pagination": {
      "page": 1,
      "page_size": 25,
      "has_more": true
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.