Skip to main content

apiome paths

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

apiome paths​

List and inspect OpenAPI path templates for a project version.

apiome paths [OPTIONS] COMMAND [ARGS]...

Subcommands: list, show.

apiome paths list​

List path templates and operations (GET /versions/{version_id}/paths).

apiome paths list [OPTIONS]

Options

OptionTypeDefaultRequiredDescription
--projecttextyesProject UUID or slug.
--versiontextyesVersion UUID, slug, or label.
--tagtext (repeatable)Filter by OpenAPI operation tag (repeatable).
--methodtext (repeatable)Filter by HTTP method (repeatable).
--qtextCase-insensitive text search over path, method, operationId, summary, and tags.
--limitinteger range50Maximum rows per API page (server enforces its own max).
--allflagFetch all API pages when resolving paths and operations.

apiome paths show​

Show one path template and its operations (GET /versions/{version_id}/paths/{path_id}).

apiome paths show [OPTIONS] PATH_REF

Arguments

ArgumentTypeRequiredDescription
PATH_REFtextyesPath UUID or OpenAPI path template.

Options

OptionTypeDefaultRequiredDescription
--projecttextyesProject UUID or slug.
--versiontextyesVersion UUID, slug, or label.
--tagtext (repeatable)Filter operations by OpenAPI tag (repeatable).
--methodtext (repeatable)Filter operations by HTTP method (repeatable).