Agent entry View raw .md

Agent entry — Accoil Tools

The agent-native front door. Whatever a human can do in this app, an agent can do too — the same URLs, the same authorization, in Markdown. This page is how you start.

1. Authenticate

Send a bearer token on every request:

Authorization: Bearer accoil_pat_…

Tokens are read-scoped by default — a read token can view everything you can, and change nothing. A write token is required to mutate (create, update, delete). A read token attempting a write gets 403.
Getting a token: a human creates one in the app under Settings → Agent (/<account_slug>/settings/agent), which hands them a prompt with the token already in it, or under Settings → API tokens (/<account_slug>/settings/api_tokens). Tokens cannot be self-minted — that is deliberate.
No token at all? The auth pages are agent-readable too: sign in, reset a password — each carries its form affordance and body spec. A session cookie works everywhere a token does. Signup is currently invite-only — ask an account admin for an invite.

2. Ask for the representation you want

Every page speaks three, chosen by the Accept header (or a URL suffix):

Accept: text/markdown — or append .md — this navigable agent view (for reasoning)
Accept: application/json — or append .json — structured data (for a deterministic client)
no header — the human HTML page

Toggle depth with ?detail=full (default is a skimmable summary). Every page ends with affordances — description → METHOD path — and links to the concepts and write-specs you need to act. Follow the links; you do not need to know the URL scheme in advance.

3. Where to go

No valid token detected. Add Authorization: Bearer <token> and re-request this page to see the accounts you can reach.

Concepts

Product · Destination · Sync run · Licence · Event · Account · Member & roles · API token · Credential · Notification stream

Labs (AI research reports): Process · Deliverable · Share link · Spending cap

Skill

Prefer to learn this platform once instead of reading instructions every session? /skill.md is a portable Agent Skill (SKILL.md) covering what's here, how to read and write, and the house rules. Public, like this page. If you support skills, save it as SKILL.md in whichever directory you scan for them and it loads itself when relevant; otherwise just fetch it when you need it.

Write specs

Every write affordance links its own OpenAPI slice; the whole documents live at /specs/platform/openapi (auth, accounts, members, tokens, /system), /specs/amp_events/openapi (the Marketplace Events tool) and /specs/labs/openapi (the Labs tool).