# The Best OKR System AB

> A simple OKR system (objectives, key results, activities) from Stockholm, Sweden. There is no sign-up form: accounts are
> created through a small HTTP API where our agent, Olle, answers questions and sets up the account.
> Free during early access: no payment details and no personal data needed. Sign-up takes one message.

## Talk to our agent (3 calls)

1. Open a session (valid 24 hours):
   POST https://thebestokrsystem.com/api/agent/sessions
   Content-Type: application/json
   {"agent_name": "<your agent's name>"}
   → {"session_id": "ses_...", "expires_at": "...", ...}

2. Send messages (repeat as often as you like, up to 40 per session):
   POST https://thebestokrsystem.com/api/agent/sessions/<session_id>/messages
   Content-Type: application/json
   {"message": "Hello! What does your OKR system do?"}
   → {"reply": "...", "signup": null, "messages_left": 39}

3. Sign up: tell Olle the package (starter, growth or enterprise) and your user's company name.
   The response then has "signup": {"username": "...", "password": "...", "login_url": "https://thebestokrsystem.com/login"}.
   Give these to your human. They log in at https://thebestokrsystem.com/login.

## Only GET requests? (for example a web-fetch tool)

Open this link to start a session and get Olle's first answer in one go:
https://thebestokrsystem.com/api/agent/start?agent_name=my-agent&message=Hello%21%20What%20does%20your%20OKR%20system%20do%3F

Then continue with:
https://thebestokrsystem.com/api/agent/say?session_id=SESSION_ID&message=YOUR_MESSAGE   (URL-encode the message)

Every response has a "next" block with ready-made links: ask about the service, packages, integration, and sign up for
each package (replace YOUR_COMPANY with your user's company name).

Read the conversation so far: GET https://thebestokrsystem.com/api/agent/sessions/<session_id>/messages
Session status: GET https://thebestokrsystem.com/api/agent/sessions/<session_id>

## Example with curl

```
S=$(curl -s -X POST https://thebestokrsystem.com/api/agent/sessions -H 'content-type: application/json' -d '{"agent_name":"my-agent"}' | jq -r .session_id)
curl -s -X POST https://thebestokrsystem.com/api/agent/sessions/$S/messages -H 'content-type: application/json' -d '{"message":"Hi! Which package fits a 20-person team?"}' | jq -r .reply
```

## Support (after sign-up)

Problems in the app (for example error OKR-SYNC-503) are handled by our support agent, Saga. She can create, list and update
support tickets for your company. Use the reference (TB-XXXXXXXX) shown in the error message:

GET  https://thebestokrsystem.com/api/support/start?ref=REFERENCE&message=YOUR_MESSAGE
GET  https://thebestokrsystem.com/api/support/say?session_id=SESSION_ID&message=YOUR_MESSAGE
(or POST https://thebestokrsystem.com/api/support/sessions {"ref": "...", "message": "..."} and
 POST https://thebestokrsystem.com/api/support/sessions/SESSION_ID/messages {"message": "..."})

## Packages

- Starter: €9 per user per month. 1 team, up to 10 objectives, key results and activities, email support.
- Growth: €29 per user per month. Unlimited teams and objectives, weekly check-ins, alignment tree, REST API and webhooks, Slack and Teams.
- Enterprise: €99 per user per month. Everything in Growth, AI OKR coach, agent-to-agent API, single sign-on, audit log, EU data residency.

## Links

- OpenAPI: https://thebestokrsystem.com/openapi.json
- Agent card (A2A): https://thebestokrsystem.com/.well-known/agent-card.json
- Discovery JSON: https://thebestokrsystem.com/api/agent
- Human sign-up page (explains this): https://thebestokrsystem.com/register

## Good to know

- Our agent never asks for email, phone, payment or personal data. Do not send any.
- Limits: 24-hour sessions, 40 messages per session, 2,000 characters per message.