# Hourtick Tasks API

**Canonical:** https://apis.io/apis/hourtick/hourtick-tasks-api/  
**Provider:** Hourtick — https://apis.io/providers/hourtick/  
**Base URL:** https://hourtick.com  
**Documentation:** https://hourtick.com/developers

Hourtick Tasks API is one of 13 APIs that [Hourtick](https://apis.io/providers/hourtick/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Task. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

The task board: tasks (work items), checklist, chat and files. Any member can create and edit.

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/work-items` | Tasks on the board: open ones plus done in the last 14 days (`done=all` for… |
| POST | `/api/v1/work-items` | Create a task (any member) |
| GET | `/api/v1/work-items/{id}` | A task with description, checklist, timeline (comments, files, events) and time… |
| PATCH | `/api/v1/work-items/{id}` | Update a task. |
| DELETE | `/api/v1/work-items/{id}` | Delete a task with its comments and files (creator or managers). |
| GET | `/api/v1/work-items/{id}/comments` | The task's comments, oldest first, with their files (an agent's comment has… |
| POST | `/api/v1/work-items/{id}/comments` | Post in the task's chat; `attachmentIds` links files you uploaded |
| PATCH | `/api/v1/work-items/{id}/comments/{commentId}` | Edit your comment |
| DELETE | `/api/v1/work-items/{id}/comments/{commentId}` | Delete a comment and its files (author or managers) |
| POST | `/api/v1/work-items/{id}/checklist` | Add a checklist item |
| PATCH | `/api/v1/work-items/{id}/checklist/{itemId}` | Tick, rename or move a checklist item |
| DELETE | `/api/v1/work-items/{id}/checklist/{itemId}` | Remove a checklist item |
| POST | `/api/v1/work-items/{id}/attachments` | Upload a file (multipart/form-data, field `file`, up to 25 MB). |
| GET | `/api/v1/attachments/{id}` | Redirects to a 5-minute signed URL. |
| DELETE | `/api/v1/attachments/{id}` | Delete a file (uploader or managers) |
| GET | `/api/v1/task-views` | Your saved Tasks views (personal) |
| POST | `/api/v1/task-views` | Save a view: people, agents, projects, clients and labels (any-of; `none` for… |
| PATCH | `/api/v1/task-views/{id}` | Rename, move or update a view's filters |
| DELETE | `/api/v1/task-views/{id}` | Delete a view |
| POST | `/api/v1/work-items/{id}/dependencies` | Mark this task blocked by another (type blocked_by) or blocking another (type… |
| DELETE | `/api/v1/work-items/{id}/dependencies` | Remove the dependency; a task with no open blockers left unlocks |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/hourtick/openapi/hourtick-tasks-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/hourtick/json-schema/hourtick-time-entry-schema.json
- **JSONSchema** — https://artifacts.apis.io/hourtick/json-schema/hourtick-work-item-schema.json

## Other Hourtick APIs (12)

- [Hourtick API](https://apis.io/apis/hourtick/hourtick-api/)
- [Hourtick Account API](https://apis.io/apis/hourtick/hourtick-account-api/)
- [Hourtick Agents API](https://apis.io/apis/hourtick/hourtick-agents-api/)
- [Hourtick Billing API](https://apis.io/apis/hourtick/hourtick-billing-api/)
- [Hourtick Catalog API](https://apis.io/apis/hourtick/hourtick-catalog-api/)
- [Hourtick Chat API](https://apis.io/apis/hourtick/hourtick-chat-api/)
- [Hourtick Integrations API](https://apis.io/apis/hourtick/hourtick-integrations-api/)
- [Hourtick Invoices API](https://apis.io/apis/hourtick/hourtick-invoices-api/)
- [Hourtick Notes and files API](https://apis.io/apis/hourtick/hourtick-notes-and-files-api/)
- [Hourtick Reports API](https://apis.io/apis/hourtick/hourtick-reports-api/)
- [Hourtick Team API](https://apis.io/apis/hourtick/hourtick-team-api/)
- [Hourtick Time API](https://apis.io/apis/hourtick/hourtick-time-api/)

## Tags

Task

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hourtick/hourtick-tasks-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hourtick/.