# Hourtick Notes and files API

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

Hourtick Notes and files 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 Notes and files. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

Documents and files on a client or a project. Everyone in the workspace can read and add them; the author or a manager deletes. Notes are Tiptap JSON with a plain-text copy (`text`); saves carry a `version` and a stale one answers 409.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/notes` | Notes on a project (`projectId`) or client (`clientId`): titles and previews… |
| POST | `/api/v1/notes` | Create a note on a project or client |
| GET | `/api/v1/notes/{id}` | One note: title, Tiptap `content`, `markdown`, plain `text` and `version` |
| PATCH | `/api/v1/notes/{id}` | Save a note |
| DELETE | `/api/v1/notes/{id}` | Delete a note (its creator or a manager) |
| GET | `/api/v1/files` | Files on a project (`projectId`) or client (`clientId`), newest first |
| POST | `/api/v1/files` | Upload a file to a project or client (multipart: file, projectId or clientId… |
| GET | `/api/v1/files/{id}` | Open a file: redirects to a short-lived signed URL (`?download=1` to download… |
| DELETE | `/api/v1/files/{id}` | Delete a file (its uploader or a manager) |
| GET | `/api/v1/records/counts` | Notes and files per project and client |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/hourtick/openapi/hourtick-notes-and-files-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 Reports API](https://apis.io/apis/hourtick/hourtick-reports-api/)
- [Hourtick Tasks API](https://apis.io/apis/hourtick/hourtick-tasks-api/)
- [Hourtick Team API](https://apis.io/apis/hourtick/hourtick-team-api/)
- [Hourtick Time API](https://apis.io/apis/hourtick/hourtick-time-api/)

## Tags

Notes and files

---

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