Skip to main content

apiome repository

Global options such as --base-url, --tenant and --json go before the command — see CLI reference. Exit codes are listed in Exit codes.

apiome repository​

Repository auto-refresh: trigger a refresh and inspect per-file state.

apiome repository [OPTIONS] COMMAND [ARGS]...

Subcommands: refresh.

apiome repository refresh​

Trigger a spec-faithful repository refresh (refresh REPO) or list per-file refresh state (refresh status REPO).

apiome repository refresh [OPTIONS] COMMAND [ARGS]...

Subcommands: status.

apiome repository refresh status​

List per-file refresh state for a repository (RAR-1.5 / RAR-2.3).

apiome repository refresh status [OPTIONS] REPO

Arguments

ArgumentTypeRequiredDescription
REPOSITORYtextyesRepository UUID or name (for example acme/api, matched against the repository's full name and then its display name).

Options

OptionTypeDefaultRequiredDescription
--pathtextRestrict the listing to one repository-relative file path.
--branchtextRestrict the listing to one branch (implies --all-branches).
--all-branchesflagList lineages on every tracked branch, not just the default branch.
--limitinteger50Maximum file lineages to read (1..500).
--formattextOutput format: table (default) or json.