Account and platform
Who am I
GET /v1/account is the agent's whoami. One call answers identity, what
the account owns, and every limit.
It reports:
id,name,emailandcreated_at;counts, for sites, archived sites and domains;limits, the whole catalog — read Limits;draft_limits, the lower caps of a draft;billing, the plan and its state;payouts, where money from a visitor can land;domain_onboarding, the modes this deployment supports;skill, the version of the skill the platform serves;base_domain, the domain sites are published on.transfers_to_answer, the sites other accounts offer to this one. Read Transfers.
PATCH /v1/account changes the name.
The email is a credential and not a label. Every sign-in link and every
agent grant goes to it, so a token cannot change it: a new address is
403 email_change_in_app. The owner changes it on the account page of the
app. The app sends a link to the new address, and the address changes
when the owner opens it. Then the old address gets a mail that says so.
Tokens
| Call | What it does |
|---|---|
GET /v1/tokens |
lists every token, with when each was last used |
PATCH /v1/tokens/{id} |
renames one |
DELETE /v1/tokens/{id} |
revokes one at once |
A chat connector's access token is an ordinary token and appears here.
Billing
| Call | What it does |
|---|---|
GET /v1/billing |
the plan, its state and what it includes |
POST /v1/billing/checkout |
a hosted page to start or change a plan |
POST /v1/billing/portal |
a hosted page to manage the subscription |
Both answers carry a provider's address, which is one of the two places a
/v1 answer does. A payer's browser has to land on it.
Caps never come from the payment provider. They come from Clave's catalog,
and GET /v1/account reports them.
Stock photos
| Call | What it does |
|---|---|
POST /v1/photos/search |
searches the stock library |
Use the id it gives with POST /v1/sites/{id}/photos to put the photo in
a site. Read Site source.
A deployment with no photo key advertises no photo tools.
Design sketches
| Call | What it does |
|---|---|
POST /v1/sketches |
hosts design directions for an owner to look at |
DELETE /v1/sketches/{id} |
takes them down |
The skill
| Call | What it does |
|---|---|
GET /v1/skill |
the skill tree Clave serves |
GET /v1/skill/{path} |
one file of it |
Read The skill.
Feedback
POST /v1/feedback sends a note to Clave: a defect, a missing capability,
a message that blamed the wrong party. Both agent surfaces write to it.
It is capped by day, and the cap is in the whoami.