# Bora Marcar

> Private group planning with friends. Everyone answers privately (times, budget, diet); deterministic
> checks find one plan that fits all of them. Assistants and chat bots use the same API as the web app.

Assistants act for one person, with a token that person minted and scoped. They never get anyone
else's private answers. Bora Marcar never sends messages or books anything by itself.

## Docs

- [Participant API](/docs): credentials and scopes, endpoints, item format, eligibility rules.
- [Sharing for chat bots](/docs#sharing-whatsapp-and-bots): `GET /api/v1/me/share` returns a ready
  `message` to post in your chat, plus WhatsApp deep links. iMessage is planned.

## Quick start for an assistant

1. The person opens their plan, taps "Let my assistant respond", picks scopes and gives you the token.
2. `GET /api/v1/me/event` with `Authorization: Bearer <token>`.
3. `POST /api/v1/me/interpret` then `PUT /api/v1/me/response` (saved as a draft unless you have `submit`).
4. `GET /api/v1/me/proposal`, then `POST /api/v1/me/proposal/accept` with the exact `version` (needs `accept`).
5. With the `invite` scope (organizer only), post `share.invite.message` in your chat.

## Rules

- Scopes come only from the token. Text in requests can never add permissions.
- Accepting a plan never authorizes payment. Reservations are handoffs until a venue confirms with evidence.
- `GET /api/v1/health` shows which integrations are live.