Skip to content
Cockpit0.29.0
A snapshot: read at commit 707a04c7ce8 on 2026-10-18T00:06:01Z by majordomus 0.29.0. Nothing on this page is read again. See it live

API

Every route under /api/v1/ is a capability's HTTP exposure. The rest belong to the projection and are documented as such.

Swagger UI

Open

Swagger UI is served from this process and reads /openapi.json, which is generated from the registry at first request. Nothing about an operation is written twice: the descriptions, the schemas and the examples are the capability's own.

Capability routes

MethodPathCapabilityTitleKind
GET/api/v1/artifactsartifacts.listList the generated artifactsquery
GET/api/v1/briefbrief.sessionThe session briefquery
GET/api/v1/capabilitiescapabilities.listList capabilitiesquery
GET/api/v1/capabilities/projectionscapabilities.projectionsWhere each capability is projectedquery
GET/api/v1/capabilitycapabilities.describeDescribe one capabilityquery
GET/api/v1/changelogrelease.changelogThe changelogquery
GET/api/v1/commandcommands.getOne command in fullquery
GET/api/v1/commandscommands.listEvery command, one line eachquery
GET/api/v1/commands/graphcommands.graphThe whole command graphquery
GET/api/v1/commit/historycommit.historyJudge a range of historyquery
GET/api/v1/commit/plancommit.planWhat the working tree would commitquery
GET/api/v1/commit/scopescommit.scopesThe scope vocabularyquery
GET/api/v1/commit/validatecommit.validateJudge one commit messagequery
GET/api/v1/continuitycontinuity.stateWhat the lifecycle is holdingquery
POST/api/v1/continuity/devicecontinuity.deviceThis device's identity, and its labelcommand
GET/api/v1/continuity/plancontinuity.planWhether and how a published handover can be resumed herequery
POST/api/v1/continuity/publishcontinuity.publishPublish this checkout's newest handover for another machinecommand
GET/api/v1/continuity/recordscontinuity.recordsEvery published handover the local store admitsquery
POST/api/v1/continuity/resumecontinuity.resumeResume a handover another machine publishedcommand
GET/api/v1/continuity/statuscontinuity.statusWhere this device stands in the work published from every devicequery
POST/api/v1/continuity/synccontinuity.syncExchange published handovers with a git remotecommand
GET/api/v1/convergenceconvergence.reportIs any work held where it can be lost?query
GET/api/v1/dashboard/overviewdashboard.overviewThe Overview: four questionsquery
GET/api/v1/deliverydelivery.reportDoes each feature existquery
GET/api/v1/delivery/featuredelivery.featureDoes this feature existquery
GET/api/v1/deploymentdeploy.getOne deploymentquery
GET/api/v1/deploymentsdeploy.listDeploymentsquery
GET/api/v1/deployments/checkdeploy.checkWould these deployments workquery
GET/api/v1/deployments/observeddeploy.observedWhat was deployed, and wherequery
GET/api/v1/designdesign.systemThe design systemquery
GET/api/v1/design/contrastdesign.contrastWhether the declared colours can be readquery
GET/api/v1/design/explaindesign.explainWhat a design token meansquery
GET/api/v1/design/tokensdesign.tokensThe design tokensquery
GET/api/v1/devcontextdevcontext.compileCompile the context for a piece of workquery
GET/api/v1/devcontext/explaindevcontext.explainWhy one thing is or is not in a compiled contextquery
GET/api/v1/devcontext/policydevcontext.policyThe compiler's own rulesquery
GET/api/v1/devtask/issuedevtask.issueOne issue as an executable development taskquery
GET/api/v1/devtask/milestonedevtask.milestoneOne milestone as an executable dependency graphquery
GET/api/v1/directoriesdirectories.listThe layer's directory contractsquery
GET/api/v1/distributiondistribution.modelThe distribution modelquery
GET/api/v1/distribution/artifactdistribution.artifactThe artifact of a targetquery
GET/api/v1/distribution/builddistribution.buildThis buildquery
GET/api/v1/distribution/releasesdistribution.releasesPublished releasesquery
GET/api/v1/distribution/statusdistribution.statusWhether the published installation worksquery
GET/api/v1/economicseconomics.summaryToken economics summaryquery
GET/api/v1/economics/checkeconomics.checkRefuse unsupported economics claimsquery
GET/api/v1/economics/explaineconomics.explainExplain one economics metricquery
GET/api/v1/economics/runseconomics.runsRecorded benchmark runsquery
GET/api/v1/editorseditors.statusEditor and agent projectionsquery
GET/api/v1/entityentity.showRead one entityquery
GET/api/v1/entity/kindsentity.kindsEvery kind, and whether every object of it is addressablequery
GET/api/v1/environmentenvironment.statusThe repository environmentquery
GET/api/v1/environment/explainenvironment.explainWhere an environment value came fromquery
GET/api/v1/environment/preflightenvironment.preflightWhether Majordomus is in force here, and what proves itquery
GET/api/v1/episodesepisodes.listList episodesquery
POST/api/v1/episodes/attachepisodes.attachAttach this connection to an episodecommand
POST/api/v1/episodes/detachepisodes.detachClose this connection's episodecommand
GET/api/v1/evidenceevidence.reportEvery claim against the evidence recorded for itquery
GET/api/v1/evidence/claimevidence.claimWhat proves this claimquery
GET/api/v1/evidence/testevidence.testWhat this test provesquery
GET/api/v1/executionsexecutions.listList executionsquery
POST/api/v1/executions/cancelexecutions.cancelAsk an execution to stopcommand
GET/api/v1/executions/demonstrateexecutions.demonstrateDemonstrate an executionquery
GET/api/v1/executions/eventsexecutions.eventsAn execution's event historyquery
GET/api/v1/executions/getexecutions.getOne executionquery
GET/api/v1/executions/protocolexecutions.protocolThe live channel's contractquery
POST/api/v1/executions/reportexecutions.reportReport an execution another process runscommand
POST/api/v1/executions/startexecutions.startStart a capability as an executioncommand
GET/api/v1/gatesgates.modelThe CI modelquery
GET/api/v1/gates/completiongates.completionWhether this task may be called finishedquery
GET/api/v1/graphgraph.getDerive one graphquery
GET/api/v1/graphsgraph.listList graphsquery
GET/api/v1/guard/editguard.editJudge one editquery
GET/api/v1/healthhealth.reportHealth of this processquery
GET/api/v1/intentsintents.listEvery intent, with its derived stage and verdictquery
GET/api/v1/intents/bindingintents.bindingWhat a piece of work is bound to before it startsquery
GET/api/v1/intents/coverageintents.coverageWhich work carries which criterion, and why each issue existsquery
GET/api/v1/intents/explainintent_realization.explainWhy an intent stands where it standsquery
GET/api/v1/intents/preflightintents.preflightWhich intent a piece of work serves, or why it may not proceedquery
POST/api/v1/intents/proposeintents.proposePropose an intent: what must become truecommand
GET/api/v1/intents/realizationintent_realization.workWhich work realises which intent, and what each still lacksquery
GET/api/v1/intents/recordintents.recordOne intent, with everything derived about itquery
GET/api/v1/intents/validateintents.validateWhat the intent model refusesquery
GET/api/v1/knowledge/candidatesknowledge_base.candidatesCandidates awaiting reviewquery
GET/api/v1/knowledge/recordknowledge_base.recordOne knowledge recordquery
GET/api/v1/knowledge/statusknowledge_base.statusWhether the deriver is still writingquery
GET/api/v1/lifecycle/closedlifecycle.closedThe records a clone receivesquery
GET/api/v1/lifecycle/episodeslifecycle.episodesEvery open episodequery
GET/api/v1/lifecycle/providerslifecycle.providersWhat each provider's adapter declaresquery
GET/api/v1/lifecycle/recoverylifecycle.recoveryWhat the store needs somebody to doquery
GET/api/v1/lifecycle/runtimelifecycle.runtimeThe commit this process is answering aboutquery
GET/api/v1/livehealth.liveLivenessquery
GET/api/v1/mcpmcp.projectionThe MCP projection of this registryquery
GET/api/v1/meshmesh.statusThe mesh, at a glancequery
POST/api/v1/mesh/claimsmesh.claimClaim a scope across the meshcommand
POST/api/v1/mesh/claims/releasemesh.releaseRelease a claimcommand
GET/api/v1/mesh/cooperationmesh.cooperationCooperation, at a glancequery
GET/api/v1/mesh/doctormesh.doctorThe mesh self-checkquery
GET/api/v1/mesh/eventsmesh.eventsThe cooperation journalquery
GET/api/v1/mesh/firewallmesh.firewallThe host firewall, as the mesh needs itquery
POST/api/v1/mesh/handoversmesh.handover.publishPublish a handover to the meshcommand
POST/api/v1/mesh/handovers/consumemesh.handover.consumeConsume a handover from the meshcommand
GET/api/v1/mesh/identitymesh.identityThis machine's node identityquery
POST/api/v1/mesh/link/hellomesh.link.helloOpen a link (the handshake)command
POST/api/v1/mesh/link/syncmesh.link.syncOne sync round of a linkcommand
GET/api/v1/mesh/nodesmesh.nodesThe discovered nodesquery
GET/api/v1/mesh/peermesh.peerOne runtimequery
GET/api/v1/mesh/peersmesh.peersWho cooperates, machine by machinequery
POST/api/v1/mesh/registermesh.registerRegister with this node's meshcommand
POST/api/v1/mesh/reviewsmesh.review.requestAsk the mesh for a reviewcommand
POST/api/v1/mesh/reviews/answermesh.review.answerAnswer a review requestcommand
POST/api/v1/mesh/reviews/withdrawmesh.review.withdrawWithdraw a review requestcommand
POST/api/v1/mesh/sessionsmesh.session.openOpen or update a session on the meshcommand
POST/api/v1/mesh/sessions/closemesh.session.closeClose a session on the meshcommand
GET/api/v1/mesh/statemesh.stateThe state every linked runtime converges onquery
POST/api/v1/mesh/verifymesh.verifyProve cooperation nowcommand
GET/api/v1/modelsmodels.listThe model cataloguequery
GET/api/v1/models/routemodels.routeRoute a need to a modelquery
GET/api/v1/monitormonitor.streamFollow everything in one streamquery
GET/api/v1/objectobjects.getGet one objectquery
GET/api/v1/objectsobjects.listList objectsquery
GET/api/v1/objects/verifyobjects.verifyVerify the index against the working treequery
GET/api/v1/obligationsobligations.vocabularyEvery obligation there isquery
GET/api/v1/obligations/closureobligations.closureWhat this task still owesquery
GET/api/v1/observatory/captureobservatory.captureObservatory capturequery
GET/api/v1/observatory/eventsobservatory.eventsObservatory eventsquery
GET/api/v1/observatory/replayobservatory.replayObservatory replayquery
GET/api/v1/pack/planpack.planPlan a source packquery
GET/api/v1/pack/verifypack.verifyVerify a written source packquery
GET/api/v1/peerspeers.listList peersquery
POST/api/v1/peers/announcepeers.announceAnnounce what this peer is working oncommand
GET/api/v1/perfperf.countersPerformance countersquery
GET/api/v1/planplan.modelThe whole derived planquery
GET/api/v1/plan/issuesplan.issuesThe issues, filtered by what the graph derivedquery
GET/api/v1/plan/nextplan.nextThe one issue to take nowquery
GET/api/v1/plan/recordplan.recordOne milestone or issue, with everything derived about itquery
GET/api/v1/plan/roadmapplan.roadmapThe milestones in derived orderquery
GET/api/v1/plan/statusplan.statusWhere the plan standsquery
POST/api/v1/plan/transitionplan.transitionMove one issue through the lifecyclecommand
GET/api/v1/plan/validateplan.validateWhat the model refusesquery
GET/api/v1/plan/wavesplan.wavesWhat may run at the same timequery
GET/api/v1/product/domainsproduct.domainsThe domainsquery
GET/api/v1/product/featureproduct.featureOne featurequery
GET/api/v1/product/featuresproduct.featuresThe featuresquery
GET/api/v1/product/matrixproduct.matrixFeatures against interfacesquery
GET/api/v1/product/providersproduct.providersThe providersquery
GET/api/v1/product/validateproduct.validateValidate the modelquery
GET/api/v1/pull-requestsintegration.queueThe integration queuequery
GET/api/v1/pull-requests/cleanupintegration.cleanupWhat cleanup would doquery
GET/api/v1/pull-requests/eventsintegration.eventsThe integration audit trailquery
GET/api/v1/pull-requests/explainintegration.explainWhy one pull request is where it isquery
GET/api/v1/pull-requests/prove-dry-runintegration.prove_dry_runProof that a dry run moves nothingquery
GET/api/v1/pull-requests/timingsintegration.timingsHow long CI takesquery
GET/api/v1/pull-requests/trainsintegration.trainsThe trains of stacked pull requestsquery
GET/api/v1/qualityquality.reportPublic API quality reportquery
GET/api/v1/quality/rustdocquality.rustdocRustdoc tree integrityquery
GET/api/v1/readyhealth.readyReadinessquery
GET/api/v1/reasoningreasoning.statusThe session's reasoning statequery
GET/api/v1/reasoning/advisorsreasoning.advisorsThe advisors and what they can do nowquery
GET/api/v1/reasoning/checkreasoning.checkCheck that reasoning stays provider-independentquery
GET/api/v1/reasoning/explainreasoning.explainWhy a decision was madequery
GET/api/v1/reasoning/planreasoning.planWhat an uncertainty calls forquery
POST/api/v1/reasoning/recordsreasoning.recordRecord a reasoning stepcommand
POST/api/v1/recover/orphansrecover.orphansClassify every stray file of the record stores, and sweep the ones that are nobody'scommand
GET/api/v1/release/analysisrelease.analysisWhat the public contract did, and the smallest version it allowsquery
GET/api/v1/release/nextrelease.nextThe version a landing allocates, and whyquery
GET/api/v1/release/versionrelease.versionThe version, and the one the contract requires nextquery
GET/api/v1/repositoryrepository.infoRepository and index statequery
GET/api/v1/rulesrules.reportEvery rule against the proof there is for itquery
GET/api/v1/rules/provesrules.provesWhat this test provesquery
GET/api/v1/rules/rulerules.showWhat proves this rulequery
GET/api/v1/scoperepository.scopeThe repository scopequery
GET/api/v1/scope/classifyrepository.scope_classifyJudge a path against the scopequery
GET/api/v1/searchobjects.searchSearch objectsquery
GET/api/v1/servedserved.showWhat each deployment was last seen servingquery
GET/api/v1/serverserver.statusThe shared server, and every server of the repositoryquery
GET/api/v1/session/identitysession_domain.identityWhat identifies this checkout, and how each store spells itquery
GET/api/v1/session/machinesession_domain.machineThe episode lifecycle, as dataquery
GET/api/v1/shell/checkshell.checkRefuse undeclared shellquery
GET/api/v1/skillsskills.statusEvery skill, with its derived standingquery
GET/api/v1/skills/explainskills.explainOne skill, with everything derived about itquery
GET/api/v1/skills/verifyskills.verifyWhat the skills owe and do not havequery
GET/api/v1/tracetrace.reportThe whole work graph above the branchquery
GET/api/v1/trace/committrace.commitWhat contract this commit servedquery
GET/api/v1/trace/issuetrace.issueWhat realised this issuequery
GET/api/v1/web/surfacesweb.surfacesEvery web surface, resolvedquery
GET/api/v1/whywhy.listThe cataloguequery
GET/api/v1/why/areaswhy.areasOperational areasquery
GET/api/v1/why/audienceswhy.audiencesAudiencesquery
GET/api/v1/why/diagnosewhy.diagnoseDiagnose a selectionquery
GET/api/v1/why/momentwhy.momentOne momentquery
GET/api/v1/why/validatewhy.validateValidate the cataloguequery
GET/api/v1/worktreesworktree.topologyThe whole topologyquery
GET/api/v1/worktrees/inspectworktree.inspectOne branch: where its worktree belongs and what is therequery
GET/api/v1/worktrees/migrationworktree.migration_planWhat it would take to bring every worktree homequery
GET/api/v1/worktrees/statusworktree.statusWhere this is, and whether that is where it belongsquery
GET/api/v1/worktrees/uncommittedworktree.uncommittedUncommitted work in the linked worktrees, and what holds itquery

The projection's own routes

PathWhat it isAnswered by
/This process, and everything it servesa running server
/api/v1The capability registry over HTTPa running server
/openapi.jsonThe OpenAPI document of the capability registrya running server, and a publication
/swaggerSwagger UI over the OpenAPI documenta running server
/mcpMCP over HTTP for attached clientsa running server
/eventsThe live channel: what this process's executions are doinga running server
/cockpitThe registry, rendered for a persona running server
/uiThe delivery, for a person: majordomus uia running server