Browse API

HTTP API

Use Repopack's programmatic API and understand its boundaries.

Documented nowVerified HTTP contract
Account
GET Account and SSH keys/api/v0/accountInspect the token's account and manage its registered public SSH keys. GET List SSH keys/api/v0/account/keysInspect the token's account and manage its registered public SSH keys. POST Add SSH key/api/v0/account/keysInspect the token's account and manage its registered public SSH keys. DELETE Remove SSH key/api/v0/account/keys/<id>Inspect the token's account and manage its registered public SSH keys. DELETE Revoke current token/api/v0/account/tokenInspect the token's account and manage its registered public SSH keys.
Projects
GET Read a project/api/v0/projects/<key>Resolve a permanent project key and viewer permissions. GET List or create projects/api/v0/projectsRead membership or create and optionally import a public repository. POST Create a project/api/v0/projectsRead membership or create and optionally import a public repository. DELETE Delete a project/api/v0/projects/<key>Request human-confirmed project deletion after checking blockers.
Groups
GET Project filing groups/api/v0/groupsList, create, rename or delete account-owned filing groups. POST Create a group/api/v0/groupsList, create, rename or delete account-owned filing groups. GET Read a group/api/v0/groups/<group>List, create, rename or delete account-owned filing groups. PATCH Rename a group/api/v0/groups/<group>List, create, rename or delete account-owned filing groups. DELETE Delete a group/api/v0/groups/<group>List, create, rename or delete account-owned filing groups. PUT Group project filing/api/v0/groups/<group>/projects/<key>Add a member project or guardedly remove it from a group. DELETE Ungroup a project/api/v0/groups/<group>/projects/<key>Add a member project or guardedly remove it from a group.
Tasks
GET Search tasks/api/v0/projects/<key>/tasks/search?q=<query>Search visible tasks in one project with bounded pagination. GET List visible tasks/api/v0/projects/<key>/tasksRead the complete current visibility-scoped task list without pagination. GET Read a task/api/v0/projects/<key>/tasks/<number>Read one visible task, its current head and readiness evidence. PATCH Update a task/api/v0/projects/<key>/tasks/<number>Claim, rename, note or close visible work with explicit state checks. POST Create a task/api/v0/projects/<key>/tasksCreate open work on a verified project branch or stack parent. POST Submit a task/api/v0/projects/<key>/tasks/<number>/submitSubmit active work for review after the branch is pushed. POST Review a task/api/v0/projects/<key>/tasks/<number>/reviewApprove an exact reviewed head or request changes with a message. POST Request changes directly/api/v0/projects/<key>/tasks/<number>/request-changesApprove an exact reviewed head or request changes with a message. POST Retain a late review note/api/v0/projects/<key>/tasks/<number>/late-reviewApprove an exact reviewed head or request changes with a message. GET Task messages/api/v0/projects/<key>/tasks/<number>/messagesRead and post visible task discussion without recording a verdict. POST Post a task note/api/v0/projects/<key>/tasks/<number>/messagesRead and post visible task discussion without recording a verdict. GET Task context/api/v0/projects/<key>/tasks/<number>/contextRead the bounded projection and deliberately compact through an observed cursor. POST Compact task context/api/v0/projects/<key>/tasks/<number>/contextRead the bounded projection and deliberately compact through an observed cursor. POST Task assignment/api/v0/projects/<key>/tasks/<number>/assignAssign or unassign visible work without confusing ownership with review. POST Unassign a task/api/v0/projects/<key>/tasks/<number>/unassignAssign or unassign visible work without confusing ownership with review. POST Revise a task/api/v0/projects/<key>/tasks/<number>/reviseReturn submitted or returned work to active owner control. POST Request task review/api/v0/projects/<key>/tasks/<number>/reviewersAssign review work without approving or requesting changes. POST Task relationships/api/v0/projects/<key>/tasks/<number>/links/<other>Add related/blocking links or guardedly remove a pinned relationship. DELETE Unlink tasks/api/v0/projects/<key>/tasks/<number>/links/<other>Add related/blocking links or guardedly remove a pinned relationship. GET Task stack/api/v0/projects/<key>/tasks/<number>/stackInspect ancestry and confirm a pinned reparent/retarget plan. PATCH Move task in stack/api/v0/projects/<key>/tasks/<number>/stackInspect ancestry and confirm a pinned reparent/retarget plan. POST Restack a task/api/v0/projects/<key>/tasks/<number>/restackReconcile a child branch with its parent's current head. POST Merge a ready task/api/v0/projects/<key>/tasks/<number>/mergeRequest a human-confirmed, head-pinned squash merge into its base. GET Task preview/api/v0/projects/<key>/tasks/<number>/previewObserve or manage an isolated App preview pinned to a task SHA. POST Start or refresh a preview/api/v0/projects/<key>/tasks/<number>/previewObserve or manage an isolated App preview pinned to a task SHA. DELETE Stop a preview/api/v0/projects/<key>/tasks/<number>/previewObserve or manage an isolated App preview pinned to a task SHA. GET Follow tasks/api/v0/projects/<key>/tasks/followStream a filtered snapshot and task changes with protocol version 2.
Jobs
GET List Job Runs/api/v0/projects/<key>/jobs/<job>/runsRead project-scoped Runs by their Job number. GET Jobs/api/v0/projects/<key>/jobsList or create Jobs with validated source and execution settings. POST Create a Job/api/v0/projects/<key>/jobsList or create Jobs with validated source and execution settings. GET Job configuration/api/v0/projects/<key>/jobs/<job>Read, update, or guardedly delete one numbered Job. PATCH Update a Job/api/v0/projects/<key>/jobs/<job>Read, update, or guardedly delete one numbered Job. DELETE Delete a Job/api/v0/projects/<key>/jobs/<job>Read, update, or guardedly delete one numbered Job. POST Start a Job Run/api/v0/projects/<key>/jobs/<job>/runsPin a source and validated build arguments for a new Run. GET Job Run artifacts/api/v0/projects/<key>/jobs/<job>/runs/<run>/artifactsList verified project-only artifact evidence or download one exact file. GET Download Run artifact/api/v0/projects/<key>/jobs/<job>/runs/<run>/artifacts/<file>List verified project-only artifact evidence or download one exact file. GET Job Run events/api/v0/projects/<key>/jobs/<job>/runs/<run>/eventsFollow authenticated status, logs and steps until terminal state. DELETE Cancel a Job Run/api/v0/projects/<key>/jobs/<job>/runs/<run>Request cancellation of one numbered Run. POST Freeze a Job Run/api/v0/projects/<key>/jobs/<job>/runs/<run>/freezeGuardedly freeze or unfreeze a Run outside ordinary retention. DELETE Unfreeze a Job Run/api/v0/projects/<key>/jobs/<job>/runs/<run>/freezeGuardedly freeze or unfreeze a Run outside ordinary retention. POST Purge old Job Runs/api/v0/projects/<key>/jobs/<job>/purgeHuman-confirm an exact plan for removable unheld Runs.
Releases
GET Verify a downloaded Release/api/v0/downloads/verify/<sha256>?size=<bytes>Match a file digest and size to visible immutable publication evidence. POST Preflight a Release/api/v0/projects/<key>/releases/prepareCheck immutable Release evidence without publication. POST Publish a Release/api/v0/projects/<key>/releases/publishRequest human-confirmed publication of an exact Run. GET Release channel discovery/api/v0/projects/<key>/releases/products/<product>/channels?version=2Read version-2 channel discovery with the canonical project key. GET Configured Release channels/api/v0/projects/<key>/releases/products/<product>/channel-inventoryRead all live channels for authenticated project management, including empty channels. GET Release products/api/v0/projects/<key>/releases/productsList or create a permanent project-scoped distribution identity. POST Create a product/api/v0/projects/<key>/releases/productsList or create a permanent project-scoped distribution identity. GET Release product and default/api/v0/projects/<key>/releases/products/<product>Inspect product history or human-confirm an installable default channel. PATCH Change default channel/api/v0/projects/<key>/releases/products/<product>/default-channelInspect product history or human-confirm an installable default channel. GET Release versions/api/v0/projects/<key>/releases/products/<product>/versionsList permitted immutable versions; public listings omit private Run evidence. GET Exact Release and bytes/api/v0/projects/<key>/releases/products/<product>/versions/<version>Retrieve an authorized immutable version, artifact or attachment by exact identity. GET Download an artifact/api/v0/projects/<key>/releases/products/<product>/versions/<version>/artifacts/<file>Retrieve an authorized immutable version, artifact or attachment by exact identity. GET Download an attachment/api/v0/projects/<key>/releases/products/<product>/versions/<version>/attachments/<file>Retrieve an authorized immutable version, artifact or attachment by exact identity. POST Deprecate or revoke a Release/api/v0/projects/<key>/releases/products/<product>/versions/<version>/deprecateHuman-confirm an audited one-way lifecycle change with a reason. POST Revoke a version/api/v0/projects/<key>/releases/products/<product>/versions/<version>/revokeHuman-confirm an audited one-way lifecycle change with a reason. POST Manage Release channels/api/v0/projects/<key>/releases/products/<product>/channelsCreate, change or retire channels through pinned human confirmation. GET Read one channel/api/v0/projects/<key>/releases/products/<product>/channels/<channel>Create, change or retire channels through pinned human confirmation. PATCH Update a channel/api/v0/projects/<key>/releases/products/<product>/channels/<channel>Create, change or retire channels through pinned human confirmation. DELETE Delete a rolling channel/api/v0/projects/<key>/releases/products/<product>/channels/<channel>Create, change or retire channels through pinned human confirmation. GET Channel members/api/v0/projects/<key>/releases/products/<product>/channels/<channel>/membersPage immutable Release membership separately from the channel tip. POST Channel tip and membership/api/v0/projects/<key>/releases/products/<product>/channels/<channel>/promoteGuardedly promote, clear or withdraw exact versions. POST Clear channel tip/api/v0/projects/<key>/releases/products/<product>/channels/<channel>/clearGuardedly promote, clear or withdraw exact versions. POST Withdraw a non-tip member/api/v0/projects/<key>/releases/products/<product>/channels/<channel>/removeGuardedly promote, clear or withdraw exact versions. PATCH Change channel description/api/v0/projects/<key>/releases/products/<product>/channels/<channel>/descriptionGuardedly promote, clear or withdraw exact versions. GET Release channel RSS/api/v0/projects/<key>/releases/products/<product>/channels/<channel-key>/rssSubscribe to promoted releases or eligible rolling builds. GET Rolling channel Runs/api/v0/projects/<key>/releases/products/<product>/channels/<channel-key>Read bounded, mutable Run manifests and exact eligible evidence. GET Exact rolling Run/api/v0/projects/<key>/releases/products/<product>/channels/<channel-key>/runs/<run>Read bounded, mutable Run manifests and exact eligible evidence. GET Rolling Run artifact/api/v0/projects/<key>/releases/products/<product>/channels/<channel-key>/runs/<run>/artifacts/<file>Read bounded, mutable Run manifests and exact eligible evidence. GET Legacy name-based rolling manifest/api/v0/projects/<key>/releases/products/<product>/channels/<channel>/rollingRead bounded, mutable Run manifests and exact eligible evidence. GET Legacy pinned rolling manifest/api/v0/projects/<key>/releases/products/<product>/channels/<channel>/rolling/<channel-id>Read bounded, mutable Run manifests and exact eligible evidence. GET Legacy exact rolling Run/api/v0/projects/<key>/releases/products/<product>/channels/<channel>/rolling/<channel-id>/runs/<run>Read bounded, mutable Run manifests and exact eligible evidence. GET Legacy rolling Run artifact/api/v0/projects/<key>/releases/products/<product>/channels/<channel>/rolling/<channel-id>/runs/<run>/artifacts/<file>Read bounded, mutable Run manifests and exact eligible evidence.
Apps
POST Deploy an App/api/v0/projects/<key>/apps/<app>/deploymentsCreate a pinned deployment from the configured source or a verified rollback SHA. GET Apps/api/v0/projects/<key>/appsList App targets or request human-confirmed creation. POST Create an App/api/v0/projects/<key>/appsList App targets or request human-confirmed creation. GET App configuration/api/v0/projects/<key>/apps/<app>Inspect, update, deploy or guardedly delete a named App. PATCH Update an App/api/v0/projects/<key>/apps/<app>Inspect, update, deploy or guardedly delete a named App. POST Deploy configured source/api/v0/projects/<key>/apps/<app>Inspect, update, deploy or guardedly delete a named App. DELETE Delete an App/api/v0/projects/<key>/apps/<app>Inspect, update, deploy or guardedly delete a named App. POST Change an App host/api/v0/projects/<key>/apps/<app>/hostHuman-confirm a pinned host move and its cooldown. GET App environment/api/v0/projects/<key>/apps/<app>/envManage write-only App keys without reading secret values. POST Set an App env value/api/v0/projects/<key>/apps/<app>/envManage write-only App keys without reading secret values. DELETE Unset an App env value/api/v0/projects/<key>/apps/<app>/envManage write-only App keys without reading secret values. GET App units/api/v0/projects/<key>/apps/<app>/unitsList, create, configure and remove Containerfile units. POST Add an App unit/api/v0/projects/<key>/apps/<app>/unitsList, create, configure and remove Containerfile units. PATCH Update an App unit/api/v0/projects/<key>/apps/<app>/units/<unit>List, create, configure and remove Containerfile units. DELETE Remove an App unit/api/v0/projects/<key>/apps/<app>/units/<unit>List, create, configure and remove Containerfile units. GET Unit env and volumes/api/v0/projects/<key>/apps/<app>/units/<unit>/envBind write-only env keys and manage persistent volume mounts. POST Bind an env key/api/v0/projects/<key>/apps/<app>/units/<unit>/envBind write-only env keys and manage persistent volume mounts. DELETE Unbind an env key/api/v0/projects/<key>/apps/<app>/units/<unit>/envBind write-only env keys and manage persistent volume mounts. GET List unit volumes/api/v0/projects/<key>/apps/<app>/units/<unit>/volumesBind write-only env keys and manage persistent volume mounts. POST Add or move a mount/api/v0/projects/<key>/apps/<app>/units/<unit>/volumesBind write-only env keys and manage persistent volume mounts. DELETE Remove a mount/api/v0/projects/<key>/apps/<app>/units/<unit>/volumesBind write-only env keys and manage persistent volume mounts. POST App runtime/api/v0/projects/<key>/apps/<app>/exposeExpose a unit or start and stop an existing deployment. POST Start runtime/api/v0/projects/<key>/apps/<app>/startExpose a unit or start and stop an existing deployment. POST Stop runtime/api/v0/projects/<key>/apps/<app>/stopExpose a unit or start and stop an existing deployment. GET Deployment events/api/v0/projects/<key>/apps/<app>/deploy/<deployment>/eventsFollow build/status events of an exact App deployment. GET App runtime logs/api/v0/projects/<key>/apps/<app>/logsRead bounded deployment stdout/stderr without redeploying. GET App Blueprints/api/v0/projects/<key>/blueprintsValidate, list, create, read and update version-1 specifications. POST Validate a Blueprint/api/v0/projects/<key>/blueprints/validateValidate, list, create, read and update version-1 specifications. POST Create a Blueprint/api/v0/projects/<key>/blueprintsValidate, list, create, read and update version-1 specifications. GET Read a Blueprint/api/v0/projects/<key>/blueprints/<name>Validate, list, create, read and update version-1 specifications. PATCH Update a Blueprint/api/v0/projects/<key>/blueprints/<name>Validate, list, create, read and update version-1 specifications.

Repopack's programmatic clients, including rp, use /api routes. Browser UI uses separate session-authenticated routes. An authenticated browser session does not grant access to the API; clients must use the authorization required by the relevant endpoint.

Where to begin

The versioned API lives under https://repopack.com/api/v0/. Start with human-approved API credentials, then read a project and search or read visible tasks. For writes, understand guarded actions and why a submitted head and review verdict are different operations. Endpoint permissions differ by resource and operation. A request presenting invalid or expired credentials must not be treated as an anonymous request just because some Release data is public.

To explore an existing project workflow from a terminal, start with the rp reference. For the model of task submission and review, see task turns. The endpoint directory below lists verified contracts, not every route on the server. Use the CLI and its help for operations not yet documented here; do not infer that an unlisted route is supported for public integration.

Request body limits

Buffered JSON, URL-encoded form and text bodies are limited to 1 MiB by default. Multipart and binary readers default to 16 MiB total. Oversized bodies return 413 Payload Too Large, including when no Content-Length is sent. A task-context force flag does not bypass the body limit. Release prepare and publish accept up to 48 MiB of encoded JSON so existing base64 metadata attachments still fit; their decoded limits remain 8 MiB per file and 32 MiB total. These are buffered reader limits, not a streaming upload facility; proxy/transport limits can also apply.

Release distribution

Programmatic Release distribution uses canonical paths under /api/v0/projects/<key>/releases/products/<product>/…. The permanent project key keeps generated URLs valid across display-name renames. Public channels can allow anonymous access to their eligible Releases; private resources require the appropriate API authorization. Browser routes under /project/<key>/releases/… use session authentication and are not URLs for programmatic clients.

Versioned schema documentation is tracked separately. The method directory above is curated, not a generated schema registry or a promise that every server route is a public integration contract.

CLI compatibility

RP-Version is optional. Requests without it (for example, from curl) proceed normally. If present, it must be a SemVer version; malformed values return 400 invalid_rp_version. The minimum supported version is 0.3.0. An older CLI receives 426 cli_version_unsupported with required_version before its operation executes. Reads used by rp update remain available.