Account, organisation and workspace routes
Read and change the profile, see the credit ledger, read the organisation, and keep the shared workspace state.
These routes read and change the signed-in person's account and organisation. All need a sign-in token.
Account
| Method and path | What it does |
|---|---|
GET /market/account/stats |
Credit balance, reveals, credits spent and bought, reveals per day for 30 days |
GET /market/account/ledger |
Every credit event. page, page_size up to 200 |
PATCH /market/account |
Change company_name, contact_name, job_title, phone, timezone or preferences |
POST /market/account/password |
Needs current_password and a new_password of 8 to 200 characters |
DELETE /market/account |
Closes the account |
GET /market/account/home |
What the Home page shows |
preferences keeps only known keys: theme (light, dark, system), density (comfortable, compact), default_view (biz, dir), default_page_size (25, 50, 100 or 200), and the notification switches. Anything else is dropped.
Workspace
GET /market/account/workspace and PUT /market/account/workspace hold one JSON blob per account, {"state": {...}}. The app writes it and the extension reads it, so the two stay in step. It is capped at 1,000,000 characters (413 beyond that). Its inside belongs to the app, so do not depend on its shape.
Organisation
| Method and path | What it does |
|---|---|
GET /market/orgs/current |
The organisation on your token, and your own role |
GET /market/orgs/mine |
Every organisation you belong to |
POST /market/orgs/switch |
Gives a fresh token for another organisation you belong to |
GET /market/orgs/members |
Members. Emails only for an owner or admin |
POST /market/orgs/invites, GET /market/orgs/invites |
Invite someone, list invites. Owner or admin |
POST /market/orgs/invites/accept, POST /market/orgs/invites/{id}/revoke |
Accept, or revoke |
PATCH /market/orgs/members/{id}, .../permissions, POST .../reassign |
Change a role, a member's permissions, or reassign their work |
GET /market/orgs/audit |
The organisation's audit trail |
Roles are covered in Roles: what an owner, admin and member can do.
Billing
GET /market/billing/plans lists the plans (id, name, price in pounds, exports, interval). POST /market/billing/checkout with {"plan_id": "growth"} returns a checkout_url, which a person opens to pay by card. Nothing is charged by the call itself. Prices are in Plans, prices and limits.