# Operation availability and compatibility


Check the operation, target environment and credential before copying an example. The table preserves the limits documented with this content baseline; a listed command or OpenAPI operation does not establish a newer server rollout.

| Operation | Production boundary in this baseline | Credential and client requirement |
| --- | --- | --- |
| Delivered-record replay | Authorized subscription and eligible, already-acquired records are required for priced data. | Organization Key with **Data**; HTTP client or a CLI listing `campaign records pull`. |
| Campaign reads, authoring and launch | Check the target's granted capabilities and each operation's conditions. Launch requires human confirmation. | Appropriate Campaign grants; a browser CLI session cannot propose or execute launch. |
| Acceptance-check dry run | API Key route not yet deployed; use the signed-in editor/owner route. | Supported CLI command and Campaign/organization membership. Checks can call external models or agents. |
| Input-dataset listing | API Key route not yet deployed; use the signed-in route. | Command listed by the installed CLI; scope is the organization's eligible datasets. |
| Submission reads | `submission:read` Key route not yet enabled; use the signed-in route. | Reading a submission is distinct from the **Data** delivery grant. |
| Academy authoring and file reads | Key routes not yet enabled; use the documented signed-in terminal route. | Each action still requires its own role and scope. |
| Durable audit sample endpoints | In development; not deployed to production. Organization-enabled trial/sample operations need their documented enablement. | An API schema alone does not grant access. |
| Local MCP | Requires a CLI build listing `mcp serve`; the client starts a local process. | The same target, credential and grants as the underlying CLI command. No hosted MCP address is supplied. |

For staging, use the staging host and credentials issued for that environment. The production restrictions above do not establish that a staging operation is enabled for your organization. Check its actual capability response and error before proceeding; if the rollout is unclear, contact [support](/help/support) with the operation, environment, CLI version and sanitized error.

## Check your installed client and target

```sh
hbd --version
hbd --help --json
hbd config profiles list --json
```

These are local checks. After selecting the intended profile and credential, run `hbd auth whoami --json` and `hbd capabilities --json` to inspect the target identity and grants. Do not infer endpoint availability solely from local help or a capability name.

The public installation channel is `humanbased@beta`; this revision targets `0.1.0-beta.3` and awaits verification of that published artifact. An authorized source build uses the separate workspace package `@humanbased/cli`. Their version numbers are not interchangeable. A trustworthy per-operation minimum CLI version has not been recorded for the operations above: inspect the installed inventory and confirm target support before automating them.

## Documentation changes and product releases

The site's documentation version identifies a content baseline, not a platform release, API deployment or CLI compatibility guarantee. API paths identify a contract family; they do not prove every operation is deployed. Keep your CLI version, API origin and sanitized execution evidence with integration tests.

This revision reorganizes onboarding, separates CLI task guides, puts availability before affected examples, and adds an offline sample. It does not announce a product rollout. Existing `/api/cli/` section links remain entry points to the moved guides. Historical documentation remains available through the version selector; verify its applicability before using old instructions.

The CLI reference and examples target `humanbased@0.1.0-beta.3`. Verification against a published npm artifact is pending; source checks alone establish neither public package availability nor successful authenticated server operations.
