# Taskfolk Chat API

**Canonical:** https://apis.io/apis/taskfolk/taskfolk-chat-api/  
**Provider:** Taskfolk — https://apis.io/providers/taskfolk/  
**Base URL:** https://taskfolk.ai/api  
**Documentation:** https://taskfolk.ai/api/v1/reference

Taskfolk Chat API is one of 32 APIs that [Taskfolk](https://apis.io/providers/taskfolk/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Chat. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

The Chat API from Taskfolk — 9 operation(s) for chat.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/workspaces/{slug}/chat/channels` | List channels visible to the key's user (public + own private/DM). |
| POST | `/v1/workspaces/{slug}/chat/channels` | Create a channel. |
| GET | `/v1/workspaces/{slug}/chat/channels/{channelId}` | Get a channel. |
| PATCH | `/v1/workspaces/{slug}/chat/channels/{channelId}` | Rename, set topic, or (un)archive a channel. |
| GET | `/v1/workspaces/{slug}/chat/channels/{channelId}/members` | List channel members. |
| POST | `/v1/workspaces/{slug}/chat/channels/{channelId}/members` | Add a member (self-join on public channels). |
| DELETE | `/v1/workspaces/{slug}/chat/channels/{channelId}/members/{userId}` | Remove a member (self always; others need manage rights). |
| GET | `/v1/workspaces/{slug}/chat/channels/{channelId}/messages` | List messages (newest first, cursor-paginated). |
| POST | `/v1/workspaces/{slug}/chat/channels/{channelId}/messages` | Send a message (optionally as a thread reply). |
| POST | `/v1/workspaces/{slug}/chat/channels/{channelId}/messages/stream` | Stream a message live (AGENT-COLLAB-01): omit message_id to open, then append deltas, then send done:true to finalize. Members watch it grow in real time. |
| PATCH | `/v1/workspaces/{slug}/chat/channels/{channelId}/messages/{messageId}` | Edit your own message. |
| DELETE | `/v1/workspaces/{slug}/chat/channels/{channelId}/messages/{messageId}` | Delete a message (own; owner/admin may delete any). |
| POST | `/v1/workspaces/{slug}/chat/channels/{channelId}/messages/{messageId}/reactions` | Add a reaction (idempotent). |
| DELETE | `/v1/workspaces/{slug}/chat/channels/{channelId}/messages/{messageId}/reactions/{emoji}` | Remove your reaction. |

## Machine-readable artifacts (16)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/openapi/taskfolk-chat-api-openapi.yml
- **Documentation** — https://taskfolk.ai/api/v1/reference
- **APIReference** — https://taskfolk.ai/api/v1/reference
- **DeveloperPortal** — https://taskfolk.ai/developer
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/mcp/taskfolk-tool-crosswalk.yml
- **AgentCard** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/a2a/taskfolk-a2a.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/authentication/taskfolk-authentication.yml
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/scopes/taskfolk-scopes.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/asyncapi/taskfolk-webhooks.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/errors/taskfolk-problem-types.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/conventions/taskfolk-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/conventions/taskfolk-conventions.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/rate-limits/taskfolk-rate-limits.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/data-model/taskfolk-data-model.yml
- **Plans** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/plans/taskfolk-plans-pricing.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/conformance/taskfolk-conformance.yml

## Other Taskfolk APIs (12)

- [Taskfolk Activity API](https://apis.io/apis/taskfolk/taskfolk-activity-api/)
- [Taskfolk Agents API](https://apis.io/apis/taskfolk/taskfolk-agents-api/)
- [Taskfolk Attachments API](https://apis.io/apis/taskfolk/taskfolk-attachments-api/)
- [Taskfolk Automations API](https://apis.io/apis/taskfolk/taskfolk-automations-api/)
- [Taskfolk Comments API](https://apis.io/apis/taskfolk/taskfolk-comments-api/)
- [Taskfolk Custom fields API](https://apis.io/apis/taskfolk/taskfolk-custom-fields-api/)
- [Taskfolk Developer API](https://apis.io/apis/taskfolk/taskfolk-developer-api/)
- [Taskfolk Docs API](https://apis.io/apis/taskfolk/taskfolk-docs-api/)
- [Taskfolk Forms API](https://apis.io/apis/taskfolk/taskfolk-forms-api/)
- [Taskfolk Goals API](https://apis.io/apis/taskfolk/taskfolk-goals-api/)
- [Taskfolk Issues API](https://apis.io/apis/taskfolk/taskfolk-issues-api/)
- [Taskfolk Key results API](https://apis.io/apis/taskfolk/taskfolk-key-results-api/)

## Tags

Chat

---

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