API Reference

Overview

The Honeycomb API is a REST API built on Express.js with Supabase (database and auth) and Stripe (payments). It powers the Honeycomb platform across web and mobile clients.

Environment	Base URL
Production	https://api.mindhyv.com/v1
Local	http://localhost:3000/v1

Interactive Swagger documentation is available at the /docs endpoint on any running instance.

---

Authentication

All authenticated endpoints require one of the following headers:

Bearer Token (session-based, obtained via sign-in):

Authorization: Bearer <access_token>

API Key (service-to-service or long-lived integrations):

x-api-key: <your_api_key>

See the Authentication section for endpoints to obtain tokens and manage sessions.

---

Common Patterns

Cursor-Based Pagination

Most list endpoints use cursor-based pagination. Pass cursor (a created_at timestamp) and limit as query parameters. The response includes a next_cursor field when more results are available.

GET /v1/social/feed?limit=20&cursor=2026-03-28T12:00:00Z

{
  "data": [ ... ],
  "next_cursor": "2026-03-28T11:45:22Z"
}

Error Responses

All errors follow a standard format:

{
  "error": "Human-readable error message"
}

Common HTTP status codes: 400 (bad request), 401 (unauthorized), 403 (forbidden), 404 (not found), 500 (server error).

Resource Ownership

Write operations (create, update, delete) verify that the authenticated user owns the target resource before proceeding. Attempting to modify another user’s resource returns 403.

---

Sections

Authentication

Sign up, sign in, sessions, and token management. 9 endpoints — View reference

Users

Profiles, settings, and onboarding flows. 18 endpoints — View reference

Social

Feed, posts, stories, follows, reactions, comments, bookmarks, and polls. 23 endpoints — View reference

Messaging

Chats, messages, and notifications. 12 endpoints — View reference

Honeycomb

Rooms, DMs, calls, tips, badges, presence, and broadcasts. 38 endpoints — View reference

Marketplace

Products, stores, explore, and search. 8 endpoints — View reference

Jobs

Job listings and applications. 6 endpoints — View reference

Payments

Wallet, Stripe integration, and business billing. 12 endpoints — View reference

Site Builder

Projects, pages, AI features, and export. 18 endpoints — View reference

Apps & Extensions

27 app packages, 533 actions, and the extension system. 5 endpoints + app actions — View reference

Ads

Ad campaigns and impressions. 6 endpoints — View reference

Admin

User management, moderation, and content filters. 26 endpoints — View reference

Webhooks

Stripe webhooks, payment events, and reports. 4 endpoints — View reference

---

Health Check

Verify the API is running:

GET /health

{
  "status": "ok",
  "timestamp": "2026-03-30T12:00:00.000Z"
}