Huddlekit API
API by Huddlekit · rest
The Huddlekit REST API reads a workspace's projects, web apps, documents and comments, creates comments, changes a comment's status and manages webhook subscriptions. It cannot edit a comment's text or delete comments. Authentication: a workspace API key sent as Authorization: Bearer hk_live_…. Keys have a read scope (GET calls), a write scope (POST, PATCH and DELETE calls), or both. Plan: every call except DELETE /hooks/{id} requires an active or trialing Team subscription (a past-due payment fails the check); otherwise it returns 403 with requiredPlans. Rate limits: counted per API key, per endpoint group and separately for reads and writes: up to 200 reads and 30 writes a minute. Exceeding a limit returns 429 with a Retry-After header in seconds. Refused calls count too. Errors: JSON bodies of the form {"error": "…", "detail": "…"} (detail is optional). Retry only 429 (after Retry-After), 500 and 503: any other 4xx, sent again unchanged, gets…
Endpoint: https://app.huddlekit.com/api/v1
Verification: observed. Source: crawl.
Capabilities (9)
- List comments on a project web app or document
- Create a comment
- Change a comment's status
- Get sample webhook payloads from recent comments
- List this key's webhook subscriptions
- Subscribe a URL to webhook events
- Unsubscribe a webhook
- Get the current API key's workspace and scopes
- List everything comments can be attached to