API overview

Base URL: https://api.beanhub.io

Auth: Authorization: Bearer with a token from Access tokens. Git is not on the API host. Git is https://app.beanhub.io/repos/....

curl https://api.beanhub.io/v1/repos/USERNAME/REPO/entries \
  -H "Authorization: Bearer YOUR_TOKEN"

The access-token header still works with the same token. It is deprecated. New clients should send Bearer.

Note

Hosted MCP also uses Authorization: Bearer, but with an OAuth token from the connect flow, not a CLI access token. A CLI token does not unlock MCP. An MCP OAuth token does not unlock this HTTP API.

Interactive Swagger UI: https://api.beanhub.io/docs. Human-readable Redoc: https://api.beanhub.io/redoc.

This docs site does not duplicate that OpenAPI catalog. Use Redoc for paths, bodies, and status codes.

What people use it for

• Read entries for a custom report
• Submit a custom form
• Trigger Connect sync / dump (paid)
• List inbox emails and dump them

The 2023 announcement is still a readable intro: API access. Endpoints have grown since then. Trust Redoc over the blog if they disagree. The blog still shows the old access-token header.

AI apps that speak MCP use a different login path: OAuth to https://api.beanhub.io/mcp. See Connect an AI app with MCP.