HEhellobonsai
Tasks

Delete a task

Deletes a task. It stops appearing in every subsequent read, and the response hands back its final state so you can log or undo from it. Archived tasks can be deleted without unarchiving them first.

Anyone can delete a task they created; deleting someone else's needs permission to delete tasks. A task the token cannot see returns 404, and one it can see but may not delete returns 403.

delete/public-api/v1/tasks/{uuid}

Request

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

Path parameters

uuidstring required

The task's uuid.

Response

The task was deleted. Its final state is in data.

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"
      }
    ],
    "description_html": "<p>Draft the <strong>brief</strong></p>",
    "description_plain_text": "Draft the brief"
  },
  "meta": {
    "request_id": "b1f0d2c4-7a9e-4c3b-8d5f-1e2a3b4c5d6e"
  }
}

Changes

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