Install a package
Installs a package from a registry reference or a local path. The response is 202 with an install job, because a package carrying Go code triggers a rebuild and binary swap; poll the job (or watch events) for progress. Resource-only packages complete near-instantly. Conflicts — two packages claiming one slot — surface asynchronously, on the failed job’s error envelope, as NRY-0006 naming both claimants (enable/disable are the one synchronous exception: they report a slot conflict as a direct 409 instead, since they have no job to poll). A failed build never leaves the user without a working agent: the previous binary stays in place (NRY-0007).
Body
Request to install a package.
A registry reference or a local directory path.
1024Must be true when source carries compiled Go code: installing it means trusting it fully — it runs in the host's own process, with no sandbox. Omitted or false on a code-carrying source is rejected (422) before any install is attempted.
Response
Install job started. Poll it for progress.
An asynchronous package operation. Code-carrying packages resolve, build and swap the binary; a failure at any stage leaves the previous binary intact and serving — the user is never left without a working agent.
resolving, building, swapping, done, failed 2561024Present when status is failed; the previous binary is intact.

