# Hourtick Chat API

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

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

Channels, DMs, threads, reactions, files and search. Message bodies are Markdown; reference things with links: `[#12 Title](hourtick://task/<id>)`, `hourtick://project/<id>`, `hourtick://client/<id>`, `hourtick://entry/<id>`, and mention with `[@Name](hourtick://user/<id>)` or `hourtick://agent/<id>`. `[@all](hourtick://user/all)` mentions everyone in a channel (not in DMs; managers and admins only beyond 50 people; people can mute it per channel; it never starts agents). Pages come with `refs`: live data for every referenced task, project, client and time entry.

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/chat/channels` | Your channels and DMs with unread and mention counts. |
| POST | `/api/v1/chat/channels` | Create a channel (name is slugged; private channels need `memberIds`) |
| PATCH | `/api/v1/chat/channels/{id}` | Rename, set the topic or archive |
| POST | `/api/v1/chat/channels/{id}/join` | Join a public channel |
| GET | `/api/v1/gifs` | GIFs for the chat picker (Powered by GIPHY) |
| PATCH | `/api/v1/chat/channels/{id}/preferences` | Your preferences for a channel |
| POST | `/api/v1/chat/channels/{id}/leave` | Leave a channel |
| POST | `/api/v1/chat/channels/{id}/members` | Add people and agents |
| POST | `/api/v1/chat/channels/{id}/read` | Mark the channel read |
| GET | `/api/v1/chat/channels/{id}/messages` | 50 top-level messages, newest last, with `refs`. |
| POST | `/api/v1/chat/channels/{id}/messages` | Post a message (`parentId` replies in a thread; `attachmentIds` links uploaded… |
| POST | `/api/v1/chat/channels/{id}/files` | Upload a file (multipart/form-data, field `file`, up to 25 MB), then send its… |
| GET | `/api/v1/chat/files/{id}` | Redirects to a 5-minute signed URL; `?download=1` forces a download |
| POST | `/api/v1/chat/dms` | Open (or reuse) a DM with one or more people and agents |
| PATCH | `/api/v1/chat/messages/{id}` | Edit your message |
| DELETE | `/api/v1/chat/messages/{id}` | Delete a message and its files (author or managers) |
| POST | `/api/v1/chat/messages/{id}/reactions` | Toggle an emoji reaction |
| POST | `/api/v1/chat/messages/{id}/task` | Turn a message into a task; a reply links to it |
| POST | `/api/v1/chat/typing` | Say you're typing (shown for 5 seconds) |
| GET | `/api/v1/chat/search` | Full-text search in messages you can read |
| GET | `/api/v1/presence` | Who's online, what they're tracking (if they share it) and which agents are… |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/hourtick/openapi/hourtick-chat-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 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 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

Chat

---

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