Skip to content
Docs / API reference / Team endpoints
Your account
API reference

Team endpoints

Calls for reviewers and the owner. They accept a bearer token of an account with the reviewer or owner role, or the console's service token. Everyone else gets 403, signed-out callers 401.

The queue

CallRoleWhat it does
GET /api/contributionsteamevery proposal with state, submitter and the gate checks
PATCH /api/contributions/<id> with {"status": "reviewing"}teamopens a confirmed proposal
PATCH /api/contributions/<id> with {"status": "admitted"} or "rejected" and reasonteamdecides; reason at least three characters, mailed to the submitter
PATCH /api/contributions/<id> with {"status": "published"} and reasonownerpublishes an admitted or reviewing proposal in one step; refused with 409 and the list of failed checks while the gate is closed
PATCH /api/contributions/<id> with {"status": "admitted"} from publishedownertakes a module back from the catalogue

Publishing is the owner's step alone since 2026-09-10; a reviewer's attempt answers 403.

Applications

CallWhat it does
GET /api/applications, ?all=1 for decided onesopen applications with the applicant
PATCH /api/applications/<id> with {"outcome": "approved"} or "declined" and reasondecides; approval writes the contributor role

Members, invitations, requests, services

CallWhat it does
GET /api/actorsevery account with roles, standing, profile, counts of contributions, open applications, devices, invitations, services and files, and dormant_notice
GET /api/invitesevery invitation with inviter and outcome
GET /api/requests, ?all=1open requests; PATCH /api/requests/<id> with {"handled": true} marks one
GET /api/servicesevery account's services with account and target, plus the machine snapshot
GET /api/me/modulesfor the team, every published module

Roles

Roles are not granted through the API. The owner grants and revokes them on the machine:

node api/admin.mjs grant [email protected] reviewer
node api/admin.mjs revoke [email protected] reviewer

Each is a line in the record trail.

Last updated 2026-09-11