> ## Documentation Index
> Fetch the complete documentation index at: https://docs.honeyhive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Org Templates

> Read and replace an organization's templates manifest, which defines the metrics and charts that new projects start with. Each workspace gets its own copy when it is created, so a new version reaches an existing workspace's projects only where that workspace's manifest merges with the organization's.

## 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 `--filename` accepts).
* `--show-argument-schema <flag-name>`: print the JSON Schema for one argument's value. Pass the kebab flag name **without** the leading `--` (e.g. `org-id`, not `--org-id`).

Both write pure JSON to stdout and never call the API. They cannot be combined with any other command-specific flag.

## `get`

Get an organization's templates manifest

Return the latest version of an organization's templates manifest: the YAML that defines
the metrics and charts that new projects start with, as the templates page of the
organization settings in the HoneyHive app shows it. The organization is identified by the
`org_id` path parameter alone. The `x-hh-org-id` header does not participate.

A workspace gets a copy of this manifest when it is created, and its projects use that
copy. They use this manifest as well only when the workspace's manifest sets
`config.merge_strategy` to `merge`.

### Usage

```sh theme={null}
honeyhive org-templates get [options]
```

**Accepted keys:** [Control plane fine-grained API key](https://docs.honeyhive.ai/v2/workspace/api-keys.md#key-types)

### Options

| Flag | Type | Required | Description |
| - | - | - | - |
| `--org-id` | string | yes | The unique identifier of the organization |

Also supports `--show-file-schema`, `--show-argument-schema <flag-name>`, and `--filename`. See [Schema introspection](#schema-introspection) for details.

## `update`

Replace an organization's templates manifest

Save a new version of an organization's templates manifest, which becomes the latest
version. Existing projects are not changed. The organization is identified by the `org_id`
path parameter alone. The `x-hh-org-id` header does not participate.

A workspace gets a copy of this manifest when it is created, and its projects use that
copy. They use this manifest as well only when the workspace's manifest sets
`config.merge_strategy` to `merge`. A new version therefore reaches projects in
workspaces created afterward, and in existing workspaces whose manifest merges. To change
what new projects in an existing workspace start with, update that workspace's manifest.

When an API key makes the request and the organization's latest version already has this
content, nothing is saved and that version is returned, so applying the same manifest
repeatedly is safe.

### Usage

```sh theme={null}
honeyhive org-templates update [options]
```

**Accepted keys:** [Control plane fine-grained API key](https://docs.honeyhive.ai/v2/workspace/api-keys.md#key-types)

### Options

| Flag | Type | Required | Description |
| - | - | - | - |
| `--org-id` | string | yes | The unique identifier of the organization |
| `--yaml-content` | string | yes | The templates manifest, as YAML. It must parse and pass templates manifest validation for an organization. |

Also supports `--show-file-schema`, `--show-argument-schema <flag-name>`, and `--filename`. See [Schema introspection](#schema-introspection) for details.


## Related topics

- [Templates](https://docs.honeyhive.ai/v2/workspace/templates.md)
- [Org Templates Methods](https://docs.honeyhive.ai/v2/control-plane-sdk-reference/typescript/ref/org-templates/index.md)
- [UpdateOrgTemplatesManifestResponse](https://docs.honeyhive.ai/v2/control-plane-sdk-reference/typescript/ref/org-templates/UpdateOrgTemplatesManifestResponse.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.