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

# Packs

> The platform's open-license object catalogue, grouped into subjects an organization can switch on.

A **Pack** is a named group of platform [objects](/domains/objects). The platform's catalogue of open-license models is too large to browse as one list, so it is grouped into packs by subject, and an organization subscribes to the ones it wants.

Packs are the only route to platform objects. An organization's object library lists its own uploads; platform objects appear when building a stage, and only from packs that organization has enabled.

## Key fields

| Field                           | Description                                                                                                    |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `name` / `description`          | The pack itself                                                                                                |
| `visibility`                    | `public` (offered to every organization) or `private`                                                          |
| `restricted`                    | Opt-in rather than offered by default, for subjects that need a deliberate choice                              |
| `defaultEnabled`                | Whether a new organization starts subscribed                                                                   |
| `managedBy`                     | `taxonomy` (membership follows the catalogue's own classification) or `curated` (membership is chosen by hand) |
| `publishedBy`                   | The organization that published it, for packs that are not the platform's                                      |
| `icon` / `color` / `coverPhoto` | How the pack presents in the dashboard                                                                         |
| `tags`                          | Free-form labels                                                                                               |

## Subscription

Subscription is per organization and is what makes a pack's objects available:

* `POST /packs/{packId}/subscription` subscribes the caller's organization.
* `DELETE /packs/{packId}/subscription` unsubscribes it, which hides the pack's objects without affecting anything already placed.

## Endpoints

Full endpoint reference is available in the OpenAPI spec. Key operations:

* `GET /packs`: list packs, with the caller's subscription state
* `POST /packs`: create a pack
* `PATCH /packs/{packId}`: update its fields
* `GET /packs/{packId}/objects`: the objects in a pack
* `POST /packs/{packId}/objects`: add objects to a curated pack
* `POST /packs/{packId}/subscription`: subscribe the organization