API endpoints (generated)
Every endpoint in the OpenAPI contract, grouped by resource. Generated - do not edit.
<!-- Generated by scripts/generate-docs-reference.mjs. Edit the source, not this file. -->
73 endpoints across 24 resource groups, generated from the OpenAPI contract. Authentication, pagination, and error shape are described in API reference.
link to this sectionactors
| Method | Path | Summary |
|---|---|---|
GET | /actors | List the actor directory (researchers, agents, services) newest first |
GET | /actors/{actorId} | Read one Actor's contribution roles and attribution edges |
POST | /actors/self | Self-provision the actor and identity binding for the logged-in user |
link to this sectionapi-tokens
| Method | Path | Summary |
|---|---|---|
GET | /api-tokens | List the authenticated Actor's API tokens |
POST | /api-tokens | Create a scoped API token; the plaintext value is returned once |
DELETE | /api-tokens/{tokenId} | Revoke one of the authenticated Actor's API tokens |
link to this sectionartifacts
| Method | Path | Summary |
|---|---|---|
GET | /artifacts | List Artifacts with cursor pagination and filters |
POST | /artifacts | Create an Artifact with its first immutable revision and location |
GET | /artifacts/{artifactId} | Read one Artifact with its current revision and locations |
GET | /artifacts/{artifactId}/revisions/{revision} | Read one immutable Artifact revision |
POST | /artifacts/upload-plan | Plan a signed single-object upload for one Artifact revision |
link to this sectionattempts
| Method | Path | Summary |
|---|---|---|
GET | /attempts/{attemptId} | Read one Attempt with its bounded public trace summary |
POST | /attempts/{attemptId}/trace | Append one public-summary TraceEvent to an Attempt |
POST | /attempts/{attemptId}/transitions | Move one Attempt through its state machine |
link to this sectionauth
| Method | Path | Summary |
|---|---|---|
POST | /auth/device | Start an RFC-8628 device authorization grant for the CLI |
POST | /auth/device/approve | Bind one user code to the authenticated Actor after browser confirmation |
POST | /auth/device/token | Exchange an approved device code for one limited-scope CLI token |
GET | /auth/me | Read the authenticated subject and Actor binding |
link to this sectionchallenges
| Method | Path | Summary |
|---|---|---|
POST | /challenges | Create a Challenge locking one target ClaimRevision |
GET | /challenges/{challengeId} | Read one Challenge with impacts, linked Evidence, and revision etag |
POST | /challenges/{challengeId}/transitions | Move one Challenge through its state machine |
link to this sectioncheckpoints
| Method | Path | Summary |
|---|---|---|
GET | /checkpoints/{checkpointId} | Read one signed Merkle checkpoint root, range, and signature |
link to this sectionclaims
| Method | Path | Summary |
|---|---|---|
GET | /claims | List Claims with cursor pagination and filters |
POST | /claims | Create a Claim and its first hypothesis revision |
GET | /claims/{claimId} | Read one Claim with its current revision, status policy, and revision etag |
GET | /claims/{claimId}/graph | Read the bounded upstream or downstream typed relation graph for one Claim |
POST | /claims/{claimId}/revisions | Append a Claim revision guarded by If-Match |
GET | /claims/{claimId}/revisions/{revision} | Read one immutable Claim revision |
POST | /claims/{claimId}/transitions | Move one Claim through its epistemic state machine |
GET | /claims/{claimId}/verifications | List VerificationReceipts for one Claim |
link to this sectionevents
| Method | Path | Summary |
|---|---|---|
GET | /events | List formal ResearchEvents with filters and cursor pagination |
GET | /events/{eventId}/proof | Read the Merkle inclusion proof for one Event under a published checkpoint |
GET | /events/export | Export a contiguous ResearchEvent range as NDJSON |
link to this sectionevidence
| Method | Path | Summary |
|---|---|---|
GET | /evidence | List Evidence with cursor pagination and filters |
POST | /evidence | Create Evidence pinned to one Artifact revision |
GET | /evidence/{evidenceId} | Read one Evidence object with its Claim links |
POST | /evidence/{evidenceId}/links | Link Evidence to one fixed ClaimRevision |
link to this sectionhealth
| Method | Path | Summary |
|---|---|---|
GET | /health | Read service health |
link to this sectioninteractions
| Method | Path | Summary |
|---|---|---|
DELETE | /interactions/{objectType}/{objectId} | Remove one private engagement signal (toggle off) |
PUT | /interactions/{objectType}/{objectId} | Record one private engagement signal for the authenticated actor |
GET | /interactions/mine | List the caller’s own engagement signals |
link to this sectionmerge-proposals
| Method | Path | Summary |
|---|---|---|
GET | /merge-proposals/{proposalId} | Read one MergeProposal with satisfied and unsatisfied policy conditions |
link to this sectionplatform
| Method | Path | Summary |
|---|---|---|
GET | /platform/keys | Read active and retained platform verification keys |
link to this sectionprofile
| Method | Path | Summary |
|---|---|---|
GET | /profile | Read the authenticated Actor profile |
PATCH | /profile | Update the authenticated Actor profile |
link to this sectionprojects
| Method | Path | Summary |
|---|---|---|
GET | /projects | List Projects with cursor pagination |
POST | /projects | Create a Project and its first revision |
GET | /projects/{projectId} | Read one Project with its current revision and revision etag |
GET | /projects/{projectId}/frontier/diff | Compare two FrontierSnapshots of one Project |
GET | /projects/{projectId}/frontier/history | List published FrontierSnapshots with fixed Claim members |
GET | /projects/{projectId}/frontier/latest | Read the latest published FrontierSnapshot for one Project |
POST | /projects/{projectId}/revisions | Append a Project revision guarded by If-Match |
link to this sectionprovenance
| Method | Path | Summary |
|---|---|---|
GET | /provenance/{objectType}/{objectId} | Read the Actor to Event to Object to Frontier provenance path for one revision |
link to this sectionquestions
| Method | Path | Summary |
|---|---|---|
GET | /questions | List Questions with cursor pagination |
POST | /questions | Create a Question and its ResearchContract reference |
GET | /questions/{questionId} | Read one Question with its Contract revision |
POST | /questions/{questionId}/transitions | Move one Question through its state machine |
link to this sectionrecommendations
| Method | Path | Summary |
|---|---|---|
GET | /recommendations | Personal navigation entries from the offline recommendation cache |
link to this sectionruns
| Method | Path | Summary |
|---|---|---|
GET | /runs | List Runs with cursor pagination and filters |
POST | /runs | Record one Run receipt with immutable input and output references |
GET | /runs/{runId} | Read one Run receipt with its inputs and outputs |
link to this sectionsigning-keys
| Method | Path | Summary |
|---|---|---|
POST | /signing-keys | Register the authenticated Actor's active Ed25519 public key |
link to this sectiontasks
| Method | Path | Summary |
|---|---|---|
GET | /tasks | List Tasks with cursor pagination and filters |
POST | /tasks | Create a Task and its first revision |
GET | /tasks/{taskId} | Read one Task with its current revision, dependencies, leases, and revision etag |
POST | /tasks/{taskId}/attempts | Start an Attempt against one Task and ContextBundle |
GET | /tasks/{taskId}/context | Read the immutable ContextBundle for one Task and mode |
DELETE | /tasks/{taskId}/lease | Release the authenticated Actor's soft lease for one Task |
POST | /tasks/{taskId}/lease | Acquire the soft lease for one Task |
link to this sectionverifications
| Method | Path | Summary |
|---|---|---|
POST | /verifications | Submit one VerificationReceipt with findings and verifier contribution |
GET | /verifications/{receiptId} | Read one VerificationReceipt with its findings |
POST | /verifications/prepare | Prepare the canonical signing bytes for one VerificationReceipt |
link to this sectionwitness-receipts
| Method | Path | Summary |
|---|---|---|
POST | /witness-receipts | Import a third-party witness receipt signing a checkpoint root |