Skip to content

API Reference

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.

EnvironmentBase URL
Productionhttps://api.mindhyv.com/v1
Localhttp://localhost:3000/v1

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


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.


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"
}

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).

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.


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

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

Admin

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

Webhooks

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


Verify the API is running:

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