Logbook

Logbook is a headless fitness tracking API designed to be used by AI agents.

API documentation

Full interactive API reference (OpenAPI/Swagger):
http://logbook.bbeng89.com/docs/api

Machine-readable OpenAPI spec:
http://logbook.bbeng89.com/docs/api.json

Getting started

Logbook uses magic links — no passwords required. The flow is:

1. User requests a magic link
2. User receives an email, clicks the link, and is shown their API token
3. User shares the token with their agent
4. Agent uses the token for all future requests

Step 1 — Request a magic link

curl -X POST http://logbook.bbeng89.com/api/magic-link \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@example.com","first_name":"Jane","last_name":"Doe"}'

first_name and last_name are only required on first sign-up.

Step 2 — User clicks the link

The user clicks the link in their email. The page displays their API token as plain text to copy.

Step 3 — Using the token

Include the following header on all your API/MCP requests:

Authorization: Bearer <token>

Logout (revoke token)

curl -X POST http://logbook.bbeng89.com/api/logout \
  -H "Authorization: Bearer <token>"

For full API details including all endpoints, request/response shapes, and filtering options, see the API documentation above.