> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/artifact-registry/api-reference/registry-v3-tree-view.md).

# Registry V3 Tree View

V3 tree view endpoints for hierarchical navigation

## List node children

> Lists the immediate children of a non-registry node. For a Docker/Helm package, the\
> first page starts with an \`Untagged (n)\` group when the package has untagged manifests;\
> it occupies one slot of \`size\`. An unknown node returns 404.<br>

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 tree view endpoints for hierarchical navigation","name":"Registry V3 - Tree View"}],"servers":[{"url":"/api"}],"paths":{"/v3/tree/nodes/{node_id}/children":{"get":{"description":"Lists the immediate children of a non-registry node. For a Docker/Helm package, the\nfirst page starts with an `Untagged (n)` group when the package has untagged manifests;\nit occupies one slot of `size`. An unknown node returns 404.\n","operationId":"ListNodeChildrenV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/OrgIdentifierV3"},{"$ref":"#/components/parameters/ProjectIdentifierV3"},{"$ref":"#/components/parameters/NodeIdPathParamV3"},{"$ref":"#/components/parameters/TreeCursorParamV3"},{"$ref":"#/components/parameters/TreeSizeParamV3"},{"$ref":"#/components/parameters/TreeDeletedFilterParamV3"},{"$ref":"#/components/parameters/TreeCompactParamV3"}],"responses":{"200":{"$ref":"#/components/responses/TreeResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"List node children","tags":["Registry V3 - Tree View"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"OrgIdentifierV3":{"description":"Unique identifier for the organization within the account.\n\nExample: `default` or `engineering_org`\n","in":"query","name":"org_identifier","schema":{"type":"string"}},"ProjectIdentifierV3":{"description":"Unique identifier for the project within the organization.\n\nExample: `my_project` or `frontend_services`\n","in":"query","name":"project_identifier","schema":{"type":"string"}},"NodeIdPathParamV3":{"description":"The `id` of a non-registry tree node, as returned by a tree listing or by a search hit's\n`id`/`ancestors`. Either a node UUID, or for Docker/Helm registries a synthetic id of\nthe form `<kind>:<registryUUID>:<innerId>` (kind is `image`, `tag`, `manifest` or\n`untagged`) - which is why this is a plain string rather than a UUID. Treat it as opaque.\nAn unknown or malformed id returns 404. Registry ids are not accepted here; use\n`ListRegistryNodesV3`.\n","in":"path","name":"node_id","required":true,"schema":{"type":"string"}},"TreeCursorParamV3":{"description":"Opaque cursor from the previous page's `pagination.nextCursor`. Omit for the first page,\nand send the same filters with every page. A cursor that cannot be decoded returns 400.\n","in":"query","name":"cursor","schema":{"type":"string"}},"TreeSizeParamV3":{"description":"Number of items per page. A value outside 1-1000 returns 400.\n","in":"query","name":"size","schema":{"default":50,"maximum":1000,"minimum":1,"type":"integer"}},"TreeDeletedFilterParamV3":{"description":"Soft-delete filter, applied to each row's effective state (see `TreeNodeItemV3.deletedAt`).\nApplied at the registry level and, for Docker and Helm, to packages and their versions\n(tags and untagged digests). Other levels accept it but return every row whatever its\nstate: their state is worked out after the query, so filtering would break paging. Read\n`deletedAt` to render deleted state. An unknown value returns 400.\n","in":"query","name":"deleted_filter","schema":{"default":"exclude_deleted","enum":["exclude_deleted","include_deleted","only_deleted"],"type":"string"}},"TreeCompactParamV3":{"description":"Collapses a run of single-child folders into one row, e.g. `io/harness/platform/api`\nrenders as one row instead of four levels. A collapsed row carries the deepest folder's\n`id` and `path` (expand it with that `id`) and a `name` joining every segment of the run\nwith `/`. Collapsing stops at a folder with more than one child and never absorbs a file.\nAccepted and ignored for Docker and Helm registries.\n","in":"query","name":"compact","schema":{"default":false,"type":"boolean"}}},"responses":{"TreeResponseV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TreeResponseBodyV3"}}},"description":"Response for tree view endpoints"}},"schemas":{"TreeResponseBodyV3":{"description":"Response body for tree view endpoints","properties":{"items":{"description":"Immediate children of the requested level, in display order.","items":{"$ref":"#/components/schemas/TreeNodeItemV3"},"type":"array"},"pagination":{"$ref":"#/components/schemas/TreePaginationV3"}},"required":["items","pagination"]},"TreeNodeItemV3":{"description":"A node in the tree view representing a registry, package, version, folder, or file","properties":{"createdAt":{"description":"Creation time in epoch milliseconds. Absent when unknown.","format":"int64","type":"integer"},"deletedAt":{"description":"Soft-deletion time in epoch milliseconds; absent when the node is live. This is the\neffective state: the node's own entity's, else its package's, else its registry's, so\na file under a deleted version reads as deleted. Plain folders and files that belong to\nno resolvable package carry their registry's state.\n","format":"int64","type":"integer"},"entityId":{"description":"UUID of the registry, package or version this node is; present exactly when\n`entityKind` is. Pass it to the matching details API (`/registries/{id}/metadata`,\n`/packages/{id}/metadata`, `/versions/{id}/metadata`).\n","format":"uuid","type":"string"},"entityKind":{"$ref":"#/components/schemas/TreeEntityKindV3"},"hasChildren":{"description":"Whether expanding this node returns at least one child.","type":"boolean"},"id":{"description":"Identifier to expand this node with. The registry UUID for a registry (pass it to\n`ListRegistryNodesV3`); otherwise pass it to `ListNodeChildrenV3`. Below the root it is\na node UUID, or for Docker/Helm registries a synthetic `<kind>:<registryUUID>:<innerId>`\nid - hence a plain string rather than a UUID. Treat it as opaque.\n","type":"string"},"name":{"description":"Display name. A collapsed `compact` row joins its segments with `/`; the Docker/Helm\nuntagged group reads `Untagged (n)`, with n shown as `1000+` past 1000.\n","type":"string"},"packageType":{"description":"Package type of the registry. Set on every level.","type":"string"},"path":{"description":"Display path of this node within its registry; the registry name for a registry.\nFor display only - do not split it to derive ancestor ids.\n","type":"string"},"treePath":{"description":"Canonical, readable address of this node: put it in a shareable URL and pass it as `path`\nto `ResolveTreePathV3` to get the node's ids back. Unlike `path`, it is unique and stable across responses. Absent when\nthe node cannot be addressed by path (a platform below a nested Docker/Helm manifest\nlist).\n","type":"string"},"type":{"description":"Type of the node. Docker/Helm registries expose `package` (image), `version` (tag or\nuntagged manifest) and `folder` (the untagged group and per-platform manifests). Other\npackage types expose `package` and `version` for folders that are one, and `folder`\nand `file` otherwise; Debian, CRAN, Conan, Wolfi and HELM_HTTP expose only `folder`\nand `file`.\n","enum":["registry","folder","package","version","file"],"type":"string"}},"required":["id","name","type","hasChildren"],"type":"object"},"TreeEntityKindV3":{"description":"What a tree node or search hit is: a registry, a package or a version. Absent for plain\nfolders and files. A Docker/Helm platform row is a `folder` whose entity is its own\nmanifest's version.\n","enum":["REGISTRY","PACKAGE","VERSION"],"type":"string"},"TreePaginationV3":{"description":"Pagination information for tree view","properties":{"hasMore":{"description":"Whether another page exists.","type":"boolean"},"nextCursor":{"description":"Opaque cursor for the next page, to send as `cursor`. Present only when `hasMore` is true.","type":"string"},"size":{"description":"The page size applied to this request.","format":"int32","type":"integer"},"total":{"description":"Total number of children matching the request, independent of pagination.\n\n* Root (`ListTreeRootsV3`): exact, and returned **on the first page only** - it is\n  absent when a `cursor` is sent, so keep the first page's value.\n* Below the root: returned on every page, exact up to 1000. Any value above 1000\n  means \"more than 1000\" and should be rendered as \"1000+\".\n\nDrive \"Load More\" from `hasMore`, not from `total`.\n","format":"int64","type":"integer"}},"required":["size","hasMore"],"type":"object"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}}}}
```

## List registry nodes

> Lists the immediate children of a registry: packages for Docker/Helm, top-level\
> folders/files for every other package type. Expand a child with \`ListNodeChildrenV3\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 tree view endpoints for hierarchical navigation","name":"Registry V3 - Tree View"}],"servers":[{"url":"/api"}],"paths":{"/v3/tree/registries/{registry_id}/nodes":{"get":{"description":"Lists the immediate children of a registry: packages for Docker/Helm, top-level\nfolders/files for every other package type. Expand a child with `ListNodeChildrenV3`.\n","operationId":"ListRegistryNodesV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/OrgIdentifierV3"},{"$ref":"#/components/parameters/ProjectIdentifierV3"},{"$ref":"#/components/parameters/RegistryIdPathParamV3"},{"$ref":"#/components/parameters/TreeCursorParamV3"},{"$ref":"#/components/parameters/TreeSizeParamV3"},{"$ref":"#/components/parameters/TreeDeletedFilterParamV3"},{"$ref":"#/components/parameters/TreeCompactParamV3"}],"responses":{"200":{"$ref":"#/components/responses/TreeResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"List registry nodes","tags":["Registry V3 - Tree View"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"OrgIdentifierV3":{"description":"Unique identifier for the organization within the account.\n\nExample: `default` or `engineering_org`\n","in":"query","name":"org_identifier","schema":{"type":"string"}},"ProjectIdentifierV3":{"description":"Unique identifier for the project within the organization.\n\nExample: `my_project` or `frontend_services`\n","in":"query","name":"project_identifier","schema":{"type":"string"}},"RegistryIdPathParamV3":{"description":"Registry UUID. A malformed UUID returns 400; an unknown registry returns 404.\n","in":"path","name":"registry_id","required":true,"schema":{"type":"string"}},"TreeCursorParamV3":{"description":"Opaque cursor from the previous page's `pagination.nextCursor`. Omit for the first page,\nand send the same filters with every page. A cursor that cannot be decoded returns 400.\n","in":"query","name":"cursor","schema":{"type":"string"}},"TreeSizeParamV3":{"description":"Number of items per page. A value outside 1-1000 returns 400.\n","in":"query","name":"size","schema":{"default":50,"maximum":1000,"minimum":1,"type":"integer"}},"TreeDeletedFilterParamV3":{"description":"Soft-delete filter, applied to each row's effective state (see `TreeNodeItemV3.deletedAt`).\nApplied at the registry level and, for Docker and Helm, to packages and their versions\n(tags and untagged digests). Other levels accept it but return every row whatever its\nstate: their state is worked out after the query, so filtering would break paging. Read\n`deletedAt` to render deleted state. An unknown value returns 400.\n","in":"query","name":"deleted_filter","schema":{"default":"exclude_deleted","enum":["exclude_deleted","include_deleted","only_deleted"],"type":"string"}},"TreeCompactParamV3":{"description":"Collapses a run of single-child folders into one row, e.g. `io/harness/platform/api`\nrenders as one row instead of four levels. A collapsed row carries the deepest folder's\n`id` and `path` (expand it with that `id`) and a `name` joining every segment of the run\nwith `/`. Collapsing stops at a folder with more than one child and never absorbs a file.\nAccepted and ignored for Docker and Helm registries.\n","in":"query","name":"compact","schema":{"default":false,"type":"boolean"}}},"responses":{"TreeResponseV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TreeResponseBodyV3"}}},"description":"Response for tree view endpoints"}},"schemas":{"TreeResponseBodyV3":{"description":"Response body for tree view endpoints","properties":{"items":{"description":"Immediate children of the requested level, in display order.","items":{"$ref":"#/components/schemas/TreeNodeItemV3"},"type":"array"},"pagination":{"$ref":"#/components/schemas/TreePaginationV3"}},"required":["items","pagination"]},"TreeNodeItemV3":{"description":"A node in the tree view representing a registry, package, version, folder, or file","properties":{"createdAt":{"description":"Creation time in epoch milliseconds. Absent when unknown.","format":"int64","type":"integer"},"deletedAt":{"description":"Soft-deletion time in epoch milliseconds; absent when the node is live. This is the\neffective state: the node's own entity's, else its package's, else its registry's, so\na file under a deleted version reads as deleted. Plain folders and files that belong to\nno resolvable package carry their registry's state.\n","format":"int64","type":"integer"},"entityId":{"description":"UUID of the registry, package or version this node is; present exactly when\n`entityKind` is. Pass it to the matching details API (`/registries/{id}/metadata`,\n`/packages/{id}/metadata`, `/versions/{id}/metadata`).\n","format":"uuid","type":"string"},"entityKind":{"$ref":"#/components/schemas/TreeEntityKindV3"},"hasChildren":{"description":"Whether expanding this node returns at least one child.","type":"boolean"},"id":{"description":"Identifier to expand this node with. The registry UUID for a registry (pass it to\n`ListRegistryNodesV3`); otherwise pass it to `ListNodeChildrenV3`. Below the root it is\na node UUID, or for Docker/Helm registries a synthetic `<kind>:<registryUUID>:<innerId>`\nid - hence a plain string rather than a UUID. Treat it as opaque.\n","type":"string"},"name":{"description":"Display name. A collapsed `compact` row joins its segments with `/`; the Docker/Helm\nuntagged group reads `Untagged (n)`, with n shown as `1000+` past 1000.\n","type":"string"},"packageType":{"description":"Package type of the registry. Set on every level.","type":"string"},"path":{"description":"Display path of this node within its registry; the registry name for a registry.\nFor display only - do not split it to derive ancestor ids.\n","type":"string"},"treePath":{"description":"Canonical, readable address of this node: put it in a shareable URL and pass it as `path`\nto `ResolveTreePathV3` to get the node's ids back. Unlike `path`, it is unique and stable across responses. Absent when\nthe node cannot be addressed by path (a platform below a nested Docker/Helm manifest\nlist).\n","type":"string"},"type":{"description":"Type of the node. Docker/Helm registries expose `package` (image), `version` (tag or\nuntagged manifest) and `folder` (the untagged group and per-platform manifests). Other\npackage types expose `package` and `version` for folders that are one, and `folder`\nand `file` otherwise; Debian, CRAN, Conan, Wolfi and HELM_HTTP expose only `folder`\nand `file`.\n","enum":["registry","folder","package","version","file"],"type":"string"}},"required":["id","name","type","hasChildren"],"type":"object"},"TreeEntityKindV3":{"description":"What a tree node or search hit is: a registry, a package or a version. Absent for plain\nfolders and files. A Docker/Helm platform row is a `folder` whose entity is its own\nmanifest's version.\n","enum":["REGISTRY","PACKAGE","VERSION"],"type":"string"},"TreePaginationV3":{"description":"Pagination information for tree view","properties":{"hasMore":{"description":"Whether another page exists.","type":"boolean"},"nextCursor":{"description":"Opaque cursor for the next page, to send as `cursor`. Present only when `hasMore` is true.","type":"string"},"size":{"description":"The page size applied to this request.","format":"int32","type":"integer"},"total":{"description":"Total number of children matching the request, independent of pagination.\n\n* Root (`ListTreeRootsV3`): exact, and returned **on the first page only** - it is\n  absent when a `cursor` is sent, so keep the first page's value.\n* Below the root: returned on every page, exact up to 1000. Any value above 1000\n  means \"more than 1000\" and should be rendered as \"1000+\".\n\nDrive \"Load More\" from `hasMore`, not from `total`.\n","format":"int64","type":"integer"}},"required":["size","hasMore"],"type":"object"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}}}}
```

## Resolve a tree path to its nodes

> Resolves a canonical, readable \`path\` (copy it from \`treePath\`) to every node along it, so a\
> URL can carry the open node: the client reads the node's ids for its details call and\
> expands the tree by listing each step's children.\
> \
> The response also carries the first page of the requested node's own children, exactly as\
> \`ListRegistryNodesV3\` (for a registry) or \`ListNodeChildrenV3\` (for any other node) would\
> return them under the same \`cursor\`, \`size\`, \`deleted\_filter\` and \`compact\`. Load further\
> pages from those endpoints with \`children.pagination.nextCursor\`. A file has no children.\
> \
> Every step must be a node the list endpoints would show under the same \`scope\`,\
> \`deleted\_filter\`, \`registry\_type\` and \`package\_type\`; send the same values to both. A path\
> that does not fully resolve, or whose registry is outside \`scope\` or excluded by a filter,\
> returns 404. Resolving requires view permission on the registry, as for\
> \`ListRegistryNodesV3\` (403 otherwise). A malformed path, \`size\` or \`cursor\` returns 400.<br>

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 tree view endpoints for hierarchical navigation","name":"Registry V3 - Tree View"}],"servers":[{"url":"/api"}],"paths":{"/v3/tree/resolve":{"get":{"description":"Resolves a canonical, readable `path` (copy it from `treePath`) to every node along it, so a\nURL can carry the open node: the client reads the node's ids for its details call and\nexpands the tree by listing each step's children.\n\nThe response also carries the first page of the requested node's own children, exactly as\n`ListRegistryNodesV3` (for a registry) or `ListNodeChildrenV3` (for any other node) would\nreturn them under the same `cursor`, `size`, `deleted_filter` and `compact`. Load further\npages from those endpoints with `children.pagination.nextCursor`. A file has no children.\n\nEvery step must be a node the list endpoints would show under the same `scope`,\n`deleted_filter`, `registry_type` and `package_type`; send the same values to both. A path\nthat does not fully resolve, or whose registry is outside `scope` or excluded by a filter,\nreturns 404. Resolving requires view permission on the registry, as for\n`ListRegistryNodesV3` (403 otherwise). A malformed path, `size` or `cursor` returns 400.\n","operationId":"ResolveTreePathV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/OrgIdentifierV3"},{"$ref":"#/components/parameters/ProjectIdentifierV3"},{"$ref":"#/components/parameters/TreeResolvePathParamV3"},{"$ref":"#/components/parameters/RegistryScopeV3"},{"$ref":"#/components/parameters/TreeDeletedFilterParamV3"},{"$ref":"#/components/parameters/TreeRegistryTypeParamV3"},{"$ref":"#/components/parameters/TreePackageTypeParamV3"},{"$ref":"#/components/parameters/TreeCursorParamV3"},{"$ref":"#/components/parameters/TreeSizeParamV3"},{"$ref":"#/components/parameters/TreeCompactParamV3"}],"responses":{"200":{"$ref":"#/components/responses/TreeResolveResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"Resolve a tree path to its nodes","tags":["Registry V3 - Tree View"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"OrgIdentifierV3":{"description":"Unique identifier for the organization within the account.\n\nExample: `default` or `engineering_org`\n","in":"query","name":"org_identifier","schema":{"type":"string"}},"ProjectIdentifierV3":{"description":"Unique identifier for the project within the organization.\n\nExample: `my_project` or `frontend_services`\n","in":"query","name":"project_identifier","schema":{"type":"string"}},"TreeResolvePathParamV3":{"description":"Canonical path of the node to resolve, as returned in `TreeNodeItemV3.treePath`. Copy it\nfrom a response rather than building it. The first segment is the registry name; below it:\n\n* Other package types: the node's path, e.g. `maven-local/com/acme/lib/1.0`.\n* Docker and Helm: `<registry>/<image>`, `<registry>/<image>:<tag>`,\n  `<registry>/<image>/@untagged` (the untagged group), `<registry>/<image>@sha256:<hex>`\n  (an untagged manifest), and a platform below a tag or untagged manifest as\n  `<parent>/<os>/<arch>[/<variant>]`, or `<parent>/@sha256:<hex>` when the platform is\n  unknown or shared.\n\nAn empty path, a path that does not fit this grammar, or one longer than 4096 bytes\nreturns 400.\n","in":"query","name":"path","required":true,"schema":{"maxLength":4096,"type":"string"}},"RegistryScopeV3":{"description":"**Scope of registries to list**\n* **none** – current space only (default)   * **ancestors** – current space **plus** all parent spaces   * **descendants** – current space **plus** all child spaces  \nIf omitted, `none` is assumed.\n","in":"query","name":"scope","schema":{"enum":["ancestors","descendants","none"],"type":"string"}},"TreeDeletedFilterParamV3":{"description":"Soft-delete filter, applied to each row's effective state (see `TreeNodeItemV3.deletedAt`).\nApplied at the registry level and, for Docker and Helm, to packages and their versions\n(tags and untagged digests). Other levels accept it but return every row whatever its\nstate: their state is worked out after the query, so filtering would break paging. Read\n`deletedAt` to render deleted state. An unknown value returns 400.\n","in":"query","name":"deleted_filter","schema":{"default":"exclude_deleted","enum":["exclude_deleted","include_deleted","only_deleted"],"type":"string"}},"TreeRegistryTypeParamV3":{"description":"Filter by registry type (VIRTUAL or UPSTREAM), as for `ListTreeRootsV3`. Case-insensitive;\nan unknown value returns 400.\n","in":"query","name":"registry_type","schema":{"type":"string"}},"TreePackageTypeParamV3":{"description":"Filter by package type (e.g. DOCKER, MAVEN), as for `ListTreeRootsV3`. Case-insensitive; an\nunknown value returns 400.\n","in":"query","name":"package_type","schema":{"type":"string"}},"TreeCursorParamV3":{"description":"Opaque cursor from the previous page's `pagination.nextCursor`. Omit for the first page,\nand send the same filters with every page. A cursor that cannot be decoded returns 400.\n","in":"query","name":"cursor","schema":{"type":"string"}},"TreeSizeParamV3":{"description":"Number of items per page. A value outside 1-1000 returns 400.\n","in":"query","name":"size","schema":{"default":50,"maximum":1000,"minimum":1,"type":"integer"}},"TreeCompactParamV3":{"description":"Collapses a run of single-child folders into one row, e.g. `io/harness/platform/api`\nrenders as one row instead of four levels. A collapsed row carries the deepest folder's\n`id` and `path` (expand it with that `id`) and a `name` joining every segment of the run\nwith `/`. Collapsing stops at a folder with more than one child and never absorbs a file.\nAccepted and ignored for Docker and Helm registries.\n","in":"query","name":"compact","schema":{"default":false,"type":"boolean"}}},"responses":{"TreeResolveResponseV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TreeResolveResponseBodyV3"}}},"description":"Response for `ResolveTreePathV3`"}},"schemas":{"TreeResolveResponseBodyV3":{"description":"Response body for `ResolveTreePathV3`","properties":{"children":{"$ref":"#/components/schemas/TreeResponseBodyV3"},"steps":{"description":"Every node along the path, registry first, as the tree listings return them. The last\nstep is the requested node; the others are its ancestors.\n","items":{"$ref":"#/components/schemas/TreePathStepV3"},"type":"array"}},"required":["steps","children"],"type":"object"},"TreeResponseBodyV3":{"description":"Response body for tree view endpoints","properties":{"items":{"description":"Immediate children of the requested level, in display order.","items":{"$ref":"#/components/schemas/TreeNodeItemV3"},"type":"array"},"pagination":{"$ref":"#/components/schemas/TreePaginationV3"}},"required":["items","pagination"]},"TreeNodeItemV3":{"description":"A node in the tree view representing a registry, package, version, folder, or file","properties":{"createdAt":{"description":"Creation time in epoch milliseconds. Absent when unknown.","format":"int64","type":"integer"},"deletedAt":{"description":"Soft-deletion time in epoch milliseconds; absent when the node is live. This is the\neffective state: the node's own entity's, else its package's, else its registry's, so\na file under a deleted version reads as deleted. Plain folders and files that belong to\nno resolvable package carry their registry's state.\n","format":"int64","type":"integer"},"entityId":{"description":"UUID of the registry, package or version this node is; present exactly when\n`entityKind` is. Pass it to the matching details API (`/registries/{id}/metadata`,\n`/packages/{id}/metadata`, `/versions/{id}/metadata`).\n","format":"uuid","type":"string"},"entityKind":{"$ref":"#/components/schemas/TreeEntityKindV3"},"hasChildren":{"description":"Whether expanding this node returns at least one child.","type":"boolean"},"id":{"description":"Identifier to expand this node with. The registry UUID for a registry (pass it to\n`ListRegistryNodesV3`); otherwise pass it to `ListNodeChildrenV3`. Below the root it is\na node UUID, or for Docker/Helm registries a synthetic `<kind>:<registryUUID>:<innerId>`\nid - hence a plain string rather than a UUID. Treat it as opaque.\n","type":"string"},"name":{"description":"Display name. A collapsed `compact` row joins its segments with `/`; the Docker/Helm\nuntagged group reads `Untagged (n)`, with n shown as `1000+` past 1000.\n","type":"string"},"packageType":{"description":"Package type of the registry. Set on every level.","type":"string"},"path":{"description":"Display path of this node within its registry; the registry name for a registry.\nFor display only - do not split it to derive ancestor ids.\n","type":"string"},"treePath":{"description":"Canonical, readable address of this node: put it in a shareable URL and pass it as `path`\nto `ResolveTreePathV3` to get the node's ids back. Unlike `path`, it is unique and stable across responses. Absent when\nthe node cannot be addressed by path (a platform below a nested Docker/Helm manifest\nlist).\n","type":"string"},"type":{"description":"Type of the node. Docker/Helm registries expose `package` (image), `version` (tag or\nuntagged manifest) and `folder` (the untagged group and per-platform manifests). Other\npackage types expose `package` and `version` for folders that are one, and `folder`\nand `file` otherwise; Debian, CRAN, Conan, Wolfi and HELM_HTTP expose only `folder`\nand `file`.\n","enum":["registry","folder","package","version","file"],"type":"string"}},"required":["id","name","type","hasChildren"],"type":"object"},"TreeEntityKindV3":{"description":"What a tree node or search hit is: a registry, a package or a version. Absent for plain\nfolders and files. A Docker/Helm platform row is a `folder` whose entity is its own\nmanifest's version.\n","enum":["REGISTRY","PACKAGE","VERSION"],"type":"string"},"TreePaginationV3":{"description":"Pagination information for tree view","properties":{"hasMore":{"description":"Whether another page exists.","type":"boolean"},"nextCursor":{"description":"Opaque cursor for the next page, to send as `cursor`. Present only when `hasMore` is true.","type":"string"},"size":{"description":"The page size applied to this request.","format":"int32","type":"integer"},"total":{"description":"Total number of children matching the request, independent of pagination.\n\n* Root (`ListTreeRootsV3`): exact, and returned **on the first page only** - it is\n  absent when a `cursor` is sent, so keep the first page's value.\n* Below the root: returned on every page, exact up to 1000. Any value above 1000\n  means \"more than 1000\" and should be rendered as \"1000+\".\n\nDrive \"Load More\" from `hasMore`, not from `total`.\n","format":"int64","type":"integer"}},"required":["size","hasMore"],"type":"object"},"TreePathStepV3":{"description":"One node along a resolved path. `id` matches the row's `id` in the tree listings, so the\nclient can find and expand it. Steps are never collapsed: with `compact=true` a listed row\nstands for every step from its first folder to its last, and its `id` is the last one's.\n","properties":{"entityId":{"description":"UUID of the registry, package or version this node is, as for `TreeNodeItemV3`. Use it\nfor the details APIs; a file's details take its `id`.\n","format":"uuid","type":"string"},"entityKind":{"$ref":"#/components/schemas/TreeEntityKindV3"},"id":{"description":"The node's tree id: a registry UUID, a node UUID, or an opaque Docker/Helm id that is\nonly meaningful to the tree endpoints.\n","type":"string"},"name":{"type":"string"},"treePath":{"type":"string"},"type":{"description":"The node's type, as `TreeNodeItemV3.type` reports it.","enum":["registry","folder","package","version","file"],"type":"string"}},"required":["id","name","type","treePath"],"type":"object"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}}}}
```

## List tree roots (registries)

> Lists the registries forming the tree's root level, sorted by name. \`scope\` is resolved\
> as for \`ListRegistriesV3\`; a \`scope\` value other than \`none\`/\`ancestors\`/\`descendants\`\
> (when provided) returns 400. \`pagination.total\` is exact and returned on the first page\
> only. Expand a registry with \`ListRegistryNodesV3\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 tree view endpoints for hierarchical navigation","name":"Registry V3 - Tree View"}],"servers":[{"url":"/api"}],"paths":{"/v3/tree/roots":{"get":{"description":"Lists the registries forming the tree's root level, sorted by name. `scope` is resolved\nas for `ListRegistriesV3`; a `scope` value other than `none`/`ancestors`/`descendants`\n(when provided) returns 400. `pagination.total` is exact and returned on the first page\nonly. Expand a registry with `ListRegistryNodesV3`.\n","operationId":"ListTreeRootsV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/OrgIdentifierV3"},{"$ref":"#/components/parameters/ProjectIdentifierV3"},{"$ref":"#/components/parameters/RegistryScopeV3"},{"$ref":"#/components/parameters/TreeCursorParamV3"},{"$ref":"#/components/parameters/TreeSizeParamV3"},{"$ref":"#/components/parameters/TreeDeletedFilterParamV3"},{"description":"Filter registries by name: case-insensitive literal substring (no wildcards). Filters\nthis level only. To search packages, versions and files too, use `SearchTreeV3`,\nwhose matching rules differ.\n","in":"query","name":"search","schema":{"type":"string"}},{"description":"Filter by registry type (VIRTUAL or UPSTREAM). Case-insensitive; an unknown value\nreturns 400.\n","in":"query","name":"registry_type","schema":{"type":"string"}},{"description":"Filter by package type (e.g. DOCKER, MAVEN). Case-insensitive; an unknown value\nreturns 400.\n","in":"query","name":"package_type","schema":{"type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/TreeResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"List tree roots (registries)","tags":["Registry V3 - Tree View"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"OrgIdentifierV3":{"description":"Unique identifier for the organization within the account.\n\nExample: `default` or `engineering_org`\n","in":"query","name":"org_identifier","schema":{"type":"string"}},"ProjectIdentifierV3":{"description":"Unique identifier for the project within the organization.\n\nExample: `my_project` or `frontend_services`\n","in":"query","name":"project_identifier","schema":{"type":"string"}},"RegistryScopeV3":{"description":"**Scope of registries to list**\n* **none** – current space only (default)   * **ancestors** – current space **plus** all parent spaces   * **descendants** – current space **plus** all child spaces  \nIf omitted, `none` is assumed.\n","in":"query","name":"scope","schema":{"enum":["ancestors","descendants","none"],"type":"string"}},"TreeCursorParamV3":{"description":"Opaque cursor from the previous page's `pagination.nextCursor`. Omit for the first page,\nand send the same filters with every page. A cursor that cannot be decoded returns 400.\n","in":"query","name":"cursor","schema":{"type":"string"}},"TreeSizeParamV3":{"description":"Number of items per page. A value outside 1-1000 returns 400.\n","in":"query","name":"size","schema":{"default":50,"maximum":1000,"minimum":1,"type":"integer"}},"TreeDeletedFilterParamV3":{"description":"Soft-delete filter, applied to each row's effective state (see `TreeNodeItemV3.deletedAt`).\nApplied at the registry level and, for Docker and Helm, to packages and their versions\n(tags and untagged digests). Other levels accept it but return every row whatever its\nstate: their state is worked out after the query, so filtering would break paging. Read\n`deletedAt` to render deleted state. An unknown value returns 400.\n","in":"query","name":"deleted_filter","schema":{"default":"exclude_deleted","enum":["exclude_deleted","include_deleted","only_deleted"],"type":"string"}}},"responses":{"TreeResponseV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TreeResponseBodyV3"}}},"description":"Response for tree view endpoints"}},"schemas":{"TreeResponseBodyV3":{"description":"Response body for tree view endpoints","properties":{"items":{"description":"Immediate children of the requested level, in display order.","items":{"$ref":"#/components/schemas/TreeNodeItemV3"},"type":"array"},"pagination":{"$ref":"#/components/schemas/TreePaginationV3"}},"required":["items","pagination"]},"TreeNodeItemV3":{"description":"A node in the tree view representing a registry, package, version, folder, or file","properties":{"createdAt":{"description":"Creation time in epoch milliseconds. Absent when unknown.","format":"int64","type":"integer"},"deletedAt":{"description":"Soft-deletion time in epoch milliseconds; absent when the node is live. This is the\neffective state: the node's own entity's, else its package's, else its registry's, so\na file under a deleted version reads as deleted. Plain folders and files that belong to\nno resolvable package carry their registry's state.\n","format":"int64","type":"integer"},"entityId":{"description":"UUID of the registry, package or version this node is; present exactly when\n`entityKind` is. Pass it to the matching details API (`/registries/{id}/metadata`,\n`/packages/{id}/metadata`, `/versions/{id}/metadata`).\n","format":"uuid","type":"string"},"entityKind":{"$ref":"#/components/schemas/TreeEntityKindV3"},"hasChildren":{"description":"Whether expanding this node returns at least one child.","type":"boolean"},"id":{"description":"Identifier to expand this node with. The registry UUID for a registry (pass it to\n`ListRegistryNodesV3`); otherwise pass it to `ListNodeChildrenV3`. Below the root it is\na node UUID, or for Docker/Helm registries a synthetic `<kind>:<registryUUID>:<innerId>`\nid - hence a plain string rather than a UUID. Treat it as opaque.\n","type":"string"},"name":{"description":"Display name. A collapsed `compact` row joins its segments with `/`; the Docker/Helm\nuntagged group reads `Untagged (n)`, with n shown as `1000+` past 1000.\n","type":"string"},"packageType":{"description":"Package type of the registry. Set on every level.","type":"string"},"path":{"description":"Display path of this node within its registry; the registry name for a registry.\nFor display only - do not split it to derive ancestor ids.\n","type":"string"},"treePath":{"description":"Canonical, readable address of this node: put it in a shareable URL and pass it as `path`\nto `ResolveTreePathV3` to get the node's ids back. Unlike `path`, it is unique and stable across responses. Absent when\nthe node cannot be addressed by path (a platform below a nested Docker/Helm manifest\nlist).\n","type":"string"},"type":{"description":"Type of the node. Docker/Helm registries expose `package` (image), `version` (tag or\nuntagged manifest) and `folder` (the untagged group and per-platform manifests). Other\npackage types expose `package` and `version` for folders that are one, and `folder`\nand `file` otherwise; Debian, CRAN, Conan, Wolfi and HELM_HTTP expose only `folder`\nand `file`.\n","enum":["registry","folder","package","version","file"],"type":"string"}},"required":["id","name","type","hasChildren"],"type":"object"},"TreeEntityKindV3":{"description":"What a tree node or search hit is: a registry, a package or a version. Absent for plain\nfolders and files. A Docker/Helm platform row is a `folder` whose entity is its own\nmanifest's version.\n","enum":["REGISTRY","PACKAGE","VERSION"],"type":"string"},"TreePaginationV3":{"description":"Pagination information for tree view","properties":{"hasMore":{"description":"Whether another page exists.","type":"boolean"},"nextCursor":{"description":"Opaque cursor for the next page, to send as `cursor`. Present only when `hasMore` is true.","type":"string"},"size":{"description":"The page size applied to this request.","format":"int32","type":"integer"},"total":{"description":"Total number of children matching the request, independent of pagination.\n\n* Root (`ListTreeRootsV3`): exact, and returned **on the first page only** - it is\n  absent when a `cursor` is sent, so keep the first page's value.\n* Below the root: returned on every page, exact up to 1000. Any value above 1000\n  means \"more than 1000\" and should be rendered as \"1000+\".\n\nDrive \"Load More\" from `hasMore`, not from `total`.\n","format":"int64","type":"integer"}},"required":["size","hasMore"],"type":"object"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}}}}
```

## Global grouped search across registries, packages, versions, and files

> Searches every registry in \`scope\` (resolved as for \`ListTreeRootsV3\`; a \`scope\` value\
> other than \`none\`/\`ancestors\`/\`descendants\`, when provided, returns 400) and returns four\
> groups in one response: Registries, Packages, Versions and Files/Folders, each sorted by\
> name. Each group has its own cursor parameter and \`nextCursor\`; paging one group\
> leaves the others on their first page. Each group's \`count\` is independent of pagination\
> and saturates at 1001 ("1000+").\
> \
> Every group query runs under a 5 s server-side budget. A group that exceeds it is\
> returned empty with \`timedOut: true\` and the other groups are returned as normal; the\
> request fails with 504 only when every group timed out.\
> \
> Hits carry the same fields as \`TreeNodeItemV3\` except \`hasChildren\`: \`id\` is the tree node\
> id, \`entityId\` the registry/package/version UUID.\
> \
> Registries and Files hits are always navigable. Packages and Versions hits are navigable\
> when they carry \`id\`; render the others as non-navigable.<br>

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[{"description":"V3 tree view endpoints for hierarchical navigation","name":"Registry V3 - Tree View"}],"servers":[{"url":"/api"}],"paths":{"/v3/tree/search":{"get":{"description":"Searches every registry in `scope` (resolved as for `ListTreeRootsV3`; a `scope` value\nother than `none`/`ancestors`/`descendants`, when provided, returns 400) and returns four\ngroups in one response: Registries, Packages, Versions and Files/Folders, each sorted by\nname. Each group has its own cursor parameter and `nextCursor`; paging one group\nleaves the others on their first page. Each group's `count` is independent of pagination\nand saturates at 1001 (\"1000+\").\n\nEvery group query runs under a 5 s server-side budget. A group that exceeds it is\nreturned empty with `timedOut: true` and the other groups are returned as normal; the\nrequest fails with 504 only when every group timed out.\n\nHits carry the same fields as `TreeNodeItemV3` except `hasChildren`: `id` is the tree node\nid, `entityId` the registry/package/version UUID.\n\nRegistries and Files hits are always navigable. Packages and Versions hits are navigable\nwhen they carry `id`; render the others as non-navigable.\n","operationId":"SearchTreeV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/OrgIdentifierV3"},{"$ref":"#/components/parameters/ProjectIdentifierV3"},{"$ref":"#/components/parameters/RegistryScopeV3"},{"$ref":"#/components/parameters/SearchTreeTermParamV3"},{"$ref":"#/components/parameters/SearchGroupSizeParamV3"},{"$ref":"#/components/parameters/SearchRegistriesCursorParamV3"},{"$ref":"#/components/parameters/SearchPackagesCursorParamV3"},{"$ref":"#/components/parameters/SearchVersionsCursorParamV3"},{"$ref":"#/components/parameters/SearchFilesCursorParamV3"},{"$ref":"#/components/parameters/SearchPackageTypeParamV3"},{"$ref":"#/components/parameters/SearchRegistryTypeParamV3"},{"$ref":"#/components/parameters/SearchDeletedFilterParamV3"}],"responses":{"200":{"$ref":"#/components/responses/SearchTreeResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"Global grouped search across registries, packages, versions, and files","tags":["Registry V3 - Tree View"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"OrgIdentifierV3":{"description":"Unique identifier for the organization within the account.\n\nExample: `default` or `engineering_org`\n","in":"query","name":"org_identifier","schema":{"type":"string"}},"ProjectIdentifierV3":{"description":"Unique identifier for the project within the organization.\n\nExample: `my_project` or `frontend_services`\n","in":"query","name":"project_identifier","schema":{"type":"string"}},"RegistryScopeV3":{"description":"**Scope of registries to list**\n* **none** – current space only (default)   * **ancestors** – current space **plus** all parent spaces   * **descendants** – current space **plus** all child spaces  \nIf omitted, `none` is assumed.\n","in":"query","name":"scope","schema":{"enum":["ancestors","descendants","none"],"type":"string"}},"SearchTreeTermParamV3":{"description":"Search term, matched case-insensitively against registry names, package names, version\nnames or OCI tag names, and file/folder names (the node name, not its full path).\nSurrounding whitespace is ignored.\n\n* A plain term of 3+ characters matches as a substring; a shorter one as a prefix.\n* A term containing `*` (any run of characters) or `?` (one character) is matched\n  against the whole name as written, e.g. `log4j*` means \"starts with log4j\".\n* Other characters, including `%`, `_` and `\\`, match literally.\n\nReturns 400 for a term with no non-wildcard character (e.g. `*`, or only whitespace), and\nfor a term using `*` or `?` that has no run of at least 3 consecutive non-wildcard\ncharacters (e.g. `ab*` or `a*c`), which cannot be searched efficiently.\n","in":"query","name":"search","required":true,"schema":{"minLength":1,"type":"string"}},"SearchGroupSizeParamV3":{"description":"Number of items per group, applied to each of the four groups independently. A value\noutside 1-50 returns 400.\n","in":"query","name":"size","schema":{"default":10,"maximum":50,"minimum":1,"type":"integer"}},"SearchRegistriesCursorParamV3":{"description":"Opaque cursor from the Registries group's `nextCursor`; pages that group only. Omit for\nthe first page. A cursor that cannot be decoded returns 400.\n","in":"query","name":"registries_cursor","schema":{"type":"string"}},"SearchPackagesCursorParamV3":{"description":"Opaque cursor from the Packages group's `nextCursor`; pages that group only. Omit for\nthe first page. A cursor that cannot be decoded returns 400.\n","in":"query","name":"packages_cursor","schema":{"type":"string"}},"SearchVersionsCursorParamV3":{"description":"Opaque cursor from the Versions group's `nextCursor`; pages that group only. Omit for\nthe first page. A cursor that cannot be decoded returns 400.\n","in":"query","name":"versions_cursor","schema":{"type":"string"}},"SearchFilesCursorParamV3":{"description":"Opaque cursor from the Files group's `nextCursor`; pages that group only. Omit for the\nfirst page. A cursor that cannot be decoded returns 400.\n","in":"query","name":"files_cursor","schema":{"type":"string"}},"SearchPackageTypeParamV3":{"description":"Restrict all four groups to hits in registries of this package type (e.g. DOCKER,\nMAVEN). Case-insensitive; an unknown value returns 400.\n","in":"query","name":"package_type","schema":{"type":"string"}},"SearchRegistryTypeParamV3":{"description":"Restrict all four groups to hits in registries of this type (VIRTUAL or UPSTREAM).\nCase-insensitive; an unknown value returns 400.\n","in":"query","name":"registry_type","schema":{"type":"string"}},"SearchDeletedFilterParamV3":{"description":"Soft-delete filter, applied to each group's own entity: registries, packages and\nversions respectively (a soft-deleted registry or package marks its children deleted\ntoo).\n\n**Inert for the Files group**: it returns every matching file/folder even with\n`only_deleted`, except that hits inside a deleted registry are never returned. Read each\nhit's `deletedAt` for its state. An unknown value returns 400.\n","in":"query","name":"deleted_filter","schema":{"default":"exclude_deleted","enum":["exclude_deleted","include_deleted","only_deleted"],"type":"string"}}},"responses":{"SearchTreeResponseV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchTreeResponseBodyV3"}}},"description":"Response for the global grouped tree search endpoint"}},"schemas":{"SearchTreeResponseBodyV3":{"description":"Response body for the global grouped tree search endpoint.","properties":{"files":{"$ref":"#/components/schemas/SearchFilesGroupV3"},"packages":{"$ref":"#/components/schemas/SearchPackagesGroupV3"},"registries":{"$ref":"#/components/schemas/SearchRegistriesGroupV3"},"versions":{"$ref":"#/components/schemas/SearchVersionsGroupV3"}},"required":["registries","packages","versions","files"],"type":"object"},"SearchFilesGroupV3":{"description":"The Files group of a global grouped search result.","properties":{"count":{"description":"Count of files/folders matching the request, independent of pagination. Exact up to 1000;\n1001 means \"more than 1000\" and should be rendered as \"1000+\".\n","format":"int64","type":"integer"},"hasMore":{"type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/SearchFileItemV3"},"type":"array"},"nextCursor":{"description":"Opaque cursor for this group's next page, to send as this group's cursor parameter. Present only when `hasMore` is true.","type":"string"},"timedOut":{"description":"Present and true when this group's queries exceeded the server's time budget. The\ngroup is then served empty - `items` is `[]` and `count` is 0, which is not a real\nzero - while the other groups are returned as normal. Retry, or narrow the search.\n","type":"boolean"}},"required":["items","count","hasMore"],"type":"object"},"SearchFileItemV3":{"description":"One row of the Files group - files and folders alike. Always navigable.\n","properties":{"ancestors":{"description":"Breadcrumb from the registry root down to this hit's immediate parent, shallowest\nfirst. Always starts with the registry, so a node directly under the registry root\nhas exactly one entry.\n","items":{"$ref":"#/components/schemas/SearchAncestorV3"},"type":"array"},"createdAt":{"description":"Creation time in epoch millis.","format":"int64","type":"integer"},"deletedAt":{"description":"Effective soft-deletion time in epoch milliseconds, as on `TreeNodeItemV3`; absent\nwhen live.\n","format":"int64","type":"integer"},"entityId":{"description":"UUID of the package or version this folder is; present exactly when `entityKind` is.\nAbsent for files and plain folders.\n","format":"uuid","type":"string"},"entityKind":{"$ref":"#/components/schemas/TreeEntityKindV3"},"id":{"description":"Node UUID; expand a folder with `ListNodeChildrenV3`.","format":"uuid","type":"string"},"isFile":{"type":"boolean"},"name":{"type":"string"},"packageType":{"description":"Package type of the registry.","type":"string"},"path":{"description":"Full path of this node within its registry.","type":"string"},"registryId":{"format":"uuid","type":"string"},"registryName":{"type":"string"},"treePath":{"description":"Canonical tree address of the node.","type":"string"},"type":{"description":"Node type, as on its tree row.","enum":["folder","package","version","file"],"type":"string"}},"required":["id","name","type","path","treePath","isFile","registryId","registryName","packageType","ancestors"],"type":"object"},"SearchAncestorV3":{"description":"One crumb of a search hit's breadcrumb. Use these rather than splitting a `path`\nstring, which cannot be split reliably (a package name may itself contain `/`).\n","properties":{"id":{"description":"Registry UUID when `type` is `registry`, otherwise the node UUID.","type":"string"},"name":{"description":"Display name of this crumb.","type":"string"},"type":{"description":"Which listing call expands this crumb's `id`: `registry` means\n`ListRegistryNodesV3`, `folder` means `ListNodeChildrenV3`.\n","enum":["registry","folder"],"type":"string"}},"required":["id","name","type"],"type":"object"},"TreeEntityKindV3":{"description":"What a tree node or search hit is: a registry, a package or a version. Absent for plain\nfolders and files. A Docker/Helm platform row is a `folder` whose entity is its own\nmanifest's version.\n","enum":["REGISTRY","PACKAGE","VERSION"],"type":"string"},"SearchPackagesGroupV3":{"description":"The Packages group of a global grouped search result.","properties":{"count":{"description":"Count of packages matching the request, independent of pagination. Exact up to 1000;\n1001 means \"more than 1000\" and should be rendered as \"1000+\".\n","format":"int64","type":"integer"},"hasMore":{"type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/SearchPackageItemV3"},"type":"array"},"nextCursor":{"description":"Opaque cursor for this group's next page, to send as this group's cursor parameter. Present only when `hasMore` is true.","type":"string"},"timedOut":{"description":"Present and true when this group's queries exceeded the server's time budget. The\ngroup is then served empty - `items` is `[]` and `count` is 0, which is not a real\nzero - while the other groups are returned as normal. Retry, or narrow the search.\n","type":"boolean"}},"required":["items","count","hasMore"],"type":"object"},"SearchPackageItemV3":{"description":"One row of the Packages group. Covers every package type, not only Docker/Helm.\nA hit without `id` is not navigable (e.g. uncached UPSTREAM packages, HELM_HTTP, CRAN);\nstill render it and open details via `entityId`.\n","properties":{"ancestors":{"description":"Breadcrumb from the registry root down to this package's immediate parent, shallowest\nfirst. Present exactly when `id` is.\n","items":{"$ref":"#/components/schemas/SearchAncestorV3"},"type":"array"},"createdAt":{"description":"Creation time in epoch millis.","format":"int64","type":"integer"},"deletedAt":{"description":"Soft-deletion time in epoch milliseconds; absent when the package is live. Only present\nwhen the request's `deleted_filter` is `include_deleted` or `only_deleted`.\n","format":"int64","type":"integer"},"entityId":{"description":"Package UUID.","format":"uuid","type":"string"},"entityKind":{"$ref":"#/components/schemas/TreeEntityKindV3"},"id":{"description":"Tree node id of the package (synthetic for Docker/Helm). Absent when not navigable.","type":"string"},"name":{"type":"string"},"packageKind":{"description":"Absent for package types that don't record one.","type":"string"},"packageType":{"type":"string"},"path":{"description":"Path of the node within its registry. Present exactly when `id` is.","type":"string"},"registryId":{"format":"uuid","type":"string"},"registryName":{"type":"string"},"treePath":{"description":"Canonical tree address of the node. Present exactly when `id` is.","type":"string"},"type":{"description":"Always `package`.","enum":["package"],"type":"string"}},"required":["name","type","entityKind","entityId","registryId","registryName","packageType"],"type":"object"},"SearchRegistriesGroupV3":{"description":"The Registries group of a global grouped search result.","properties":{"count":{"description":"Count of registries matching the request, independent of pagination. Exact up to 1000;\n1001 means \"more than 1000\" and should be rendered as \"1000+\".\n","format":"int64","type":"integer"},"hasMore":{"type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/SearchRegistryItemV3"},"type":"array"},"nextCursor":{"description":"Opaque cursor for this group's next page, to send as this group's cursor parameter. Present only when `hasMore` is true.","type":"string"},"timedOut":{"description":"Present and true when this group's queries exceeded the server's time budget. The\ngroup is then served empty - `items` is `[]` and `count` is 0, which is not a real\nzero - while the other groups are returned as normal. Retry, or narrow the search.\n","type":"boolean"}},"required":["items","count","hasMore"],"type":"object"},"SearchRegistryItemV3":{"description":"One row of the Registries group.","properties":{"createdAt":{"description":"Creation time in epoch millis.","format":"int64","type":"integer"},"deletedAt":{"description":"Soft-deletion time in epoch milliseconds; absent when the registry is live. Only present\nwhen the request's `deleted_filter` is `include_deleted` or `only_deleted`.\n","format":"int64","type":"integer"},"entityId":{"description":"Registry UUID (same as `id`).","format":"uuid","type":"string"},"entityKind":{"$ref":"#/components/schemas/TreeEntityKindV3"},"id":{"description":"Registry UUID; expand it with `ListRegistryNodesV3`.","format":"uuid","type":"string"},"name":{"type":"string"},"packageType":{"type":"string"},"path":{"description":"Registry name.","type":"string"},"registryType":{"type":"string"},"spacePath":{"description":"Path of the space that owns the registry (e.g. `account/org/project`), which tells\nsame-named registries in different spaces apart. Absent if it could not be resolved.\n","type":"string"},"treePath":{"description":"Canonical tree address; see `TreeNodeItemV3.treePath`.","type":"string"},"type":{"description":"Always `registry`.","enum":["registry"],"type":"string"}},"required":["id","name","type","path","treePath","entityKind","entityId","registryType","packageType"],"type":"object"},"SearchVersionsGroupV3":{"description":"The Versions group of a global grouped search result.","properties":{"count":{"description":"Count of versions matching the request, independent of pagination. Exact up to 1000;\n1001 means \"more than 1000\" and should be rendered as \"1000+\".\n","format":"int64","type":"integer"},"hasMore":{"type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/SearchVersionItemV3"},"type":"array"},"nextCursor":{"description":"Opaque cursor for this group's next page, to send as this group's cursor parameter. Present only when `hasMore` is true.","type":"string"},"timedOut":{"description":"Present and true when this group's queries exceeded the server's time budget. The\ngroup is then served empty - `items` is `[]` and `count` is 0, which is not a real\nzero - while the other groups are returned as normal. Retry, or narrow the search.\n","type":"boolean"}},"required":["items","count","hasMore"],"type":"object"},"SearchVersionItemV3":{"description":"One row of the Versions group. Docker and Helm versions match on their tag names only - a\ndigest is not searchable here - and every other package type matches on the version name.\nOne row per version, not per tag: an OCI digest carrying several tags is a single row\nlisting them all in `tags`.\n\nA hit without `id` is not navigable (e.g. untagged Docker/Helm digests, uncached UPSTREAM\nversions); still render it and open details via `entityId`.\n","properties":{"ancestors":{"description":"Breadcrumb from the registry root down to this version's immediate parent, shallowest\nfirst. Present exactly when `id` is.\n","items":{"$ref":"#/components/schemas/SearchAncestorV3"},"type":"array"},"createdAt":{"description":"Creation time in epoch millis.","format":"int64","type":"integer"},"deletedAt":{"description":"Soft-deletion time in epoch milliseconds; absent when the version is live. Only present\nwhen the request's `deleted_filter` is `include_deleted` or `only_deleted`.\n","format":"int64","type":"integer"},"entityId":{"description":"Version UUID.","format":"uuid","type":"string"},"entityKind":{"$ref":"#/components/schemas/TreeEntityKindV3"},"id":{"description":"Tree node id of the version: the archive file for HELM_HTTP/CRAN, a matching tag (else\nthe first tag) for Docker/Helm. Absent when not navigable.\n","type":"string"},"name":{"description":"The stored version. For Docker and Helm this is the manifest digest in an internal\n`<2-digit algorithm prefix><hex>` form, not `sha256:...` - display `tags` instead\nwhen present.\n","type":"string"},"packageId":{"format":"uuid","type":"string"},"packageKind":{"description":"Absent for package types that don't record one.","type":"string"},"packageName":{"type":"string"},"packageType":{"type":"string"},"path":{"description":"Path of the node within its registry (`<image>/<tag>` for Docker/Helm). Present exactly\nwhen `id` is.\n","type":"string"},"registryId":{"format":"uuid","type":"string"},"registryName":{"type":"string"},"tags":{"description":"Every tag pointing at this version's manifest, ordered by name. Absent for non-OCI\npackage types and for untagged OCI digests.\n","items":{"type":"string"},"type":"array"},"treePath":{"description":"Canonical tree address of the node. Present exactly when `id` is.","type":"string"},"type":{"description":"Always `version`.","enum":["version"],"type":"string"}},"required":["name","type","entityKind","entityId","packageId","packageName","registryId","registryName","packageType"],"type":"object"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}}}}
```
