Schema introspection
Every command below with arguments supports two read-only flags for tooling and AI agents:--show-file-schema: print the JSON Schema for the full request object (the format--filenameaccepts).--show-argument-schema <flag-name>: print the JSON Schema for one argument’s value. Pass the kebab flag name without the leading--(e.g.workspace-id, not--workspace-id).
get
Get a workspace’s templates manifest
Return the latest version of a workspace’s templates manifest: the YAML that defines the
metrics and charts that new projects in the workspace start with. The workspace is
identified by the workspace_id path parameter alone. The x-hh-workspace-id header does
not participate.
A workspace starts with a copy of its organization’s manifest. Its projects use the
workspace’s manifest, together with the organization’s only when the workspace’s manifest
sets config.merge_strategy to merge.
Usage
Options
Also supports
--show-file-schema, --show-argument-schema <flag-name>, and --filename. See Schema introspection for details.
update
Replace a workspace’s templates manifest
Save a new version of a workspace’s templates manifest, which becomes the latest version.
It decides the metrics and charts that projects created afterward in the workspace start
with. Existing projects are not changed. The workspace is identified by the workspace_id
path parameter alone. The x-hh-workspace-id header does not participate.
A workspace manifest cannot define workspace_templates.
When an API key makes the request and the workspace’s latest version already has this
content, nothing is saved and that version is returned, so applying the same manifest
repeatedly is safe.
Usage
Options
Also supports
--show-file-schema, --show-argument-schema <flag-name>, and --filename. See Schema introspection for details.