---
title: "Manage Tasks"
method: POST
path: "/api/tasks/manage"
tags: ["tasks"]
---

# Manage Tasks

`POST /api/tasks/manage`

## Request

- Base URL: `https://api.vruum.ai`
- URL: `https://api.vruum.ai/api/tasks/manage`
- Auth: `HTTPBearer` (a scheme the document does not define)

Create / update / complete / cancel / bulk-complete / delete a **Vruum CRM**
task (attached to a person / deal / company) — one compound call via `action`.
These are Vruum's native CRM tasks, distinct from Apollo's task tools.

## Request body

- ManageTasksRequest
  - `action` 'create' | 'update' | 'complete' | 'cancel' | 'bulk_complete' | 'delete', required
  - `task_id` string, nullable: Required for update/complete/cancel/delete.
  - `task_ids` string[], nullable: Required for bulk_complete.
  - `title` string, nullable
  - `description` string, nullable
  - `person_id` string, nullable
  - `deal_id` string, nullable
  - `company_id` string, nullable
  - `assigned_to` string, nullable
  - `due_at` string, nullable
  - `status` 'open' | 'in_progress' | 'completed' | 'cancelled', nullable
  - `priority` 'low' | 'medium' | 'high' | 'urgent', nullable
  - `external_id` string, nullable
  - `expected_updated_at` string, date-time, nullable: Delete only: remove the task only if it is unchanged since this updated_at; 409 when someone edited or completed it since.

## Response `200`

Successful Response

- ManageTasksResponse
  - `success` boolean, required
  - `task` TaskSummary
    - `id` string, required
    - `user_company_id` string, required
    - `person_id` string, nullable
    - `deal_id` string, nullable
    - `company_id` string, nullable
    - `title` string, required
    - `description` string, nullable
    - `assigned_to` string, nullable
    - `due_at` string, nullable
    - `status` 'open' | 'in_progress' | 'completed' | 'cancelled', required
    - `priority` 'low' | 'medium' | 'high' | 'urgent', nullable
    - `completed_at` string, nullable
    - `created_at` string, required
    - `updated_at` string, required
  - `tasks` TaskSummary[], nullable
    - `id` string, required
    - `user_company_id` string, required
    - `person_id` string, nullable
    - `deal_id` string, nullable
    - `company_id` string, nullable
    - `title` string, required
    - `description` string, nullable
    - `assigned_to` string, nullable
    - `due_at` string, nullable
    - `status` 'open' | 'in_progress' | 'completed' | 'cancelled', required
    - `priority` 'low' | 'medium' | 'high' | 'urgent', nullable
    - `completed_at` string, nullable
    - `created_at` string, required
    - `updated_at` string, required
  - `message` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/vruum/apis/vruum-public-api.md) · [All operations](https://skmtc.dev/vruum/apis/vruum-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vruum/apis/vruum-public-api/revisions/b8ada111c30a?raw)