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? There is nothing for you to do here: signing in is browser-only — it leaves this app for Accoil's own sign-in and returns, which an agent cannot complete. The sign-in page is still readable, and says the same. Ask whoever runs this account for a token, or for an invite if you have no user here at all.

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

Flux (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/flux/openapi (the Flux tool).