# uip resource libraries

> Manage Orchestrator **libraries** — reusable `.nupkg` packages containing shared activities and logic. Libraries are **tenant-scoped**; no `--folder-*` flags apply. All subcommands accept `--feed-id <feed-id>` to target a specific feed.

Manage Orchestrator **libraries** — reusable `.nupkg` packages containing shared activities and logic. Libraries are **tenant-scoped**; no `--folder-*` flags apply. All subcommands accept `--feed-id <feed-id>` to target a specific feed.

For the cross-resource conventions (auth, key types, output envelope), see the [`uip resource` overview](./uip-resource.md).

## Synopsis

```
uip resource libraries list      [--feed-id <feed-id>] [-s <search>] [--all-fields] [-l <n>] [--offset <n>]
uip resource libraries get       <key> [--feed-id <feed-id>] [--all-fields]
uip resource libraries delete    <key> [--feed-id <feed-id>]
uip resource libraries download  <key> -d <local-file> [--feed-id <feed-id>]
uip resource libraries versions  <package-id> [--feed-id <feed-id>]
uip resource libraries upload    --file <local-file> [--feed-id <feed-id>]
```

## list

List libraries in the tenant feed. Filter: `-s, --search <term>`. Returns `Key`, `Title`, `Version`, `Authors`, `Published` unless `--all-fields` is set.

```bash
uip resource libraries list --search invoice
```

## get

Get library details by `<key>`. Key format is `PackageId:Version` (e.g. `MyLib:1.0.0`). `--all-fields` returns the full DTO.

## delete

Delete a library version by `<key>`.

## download

Download a library `.nupkg` to disk. Requires `-d, --destination <file>`.

```bash
uip resource libraries download MyLib:1.0.0 --destination ./MyLib.1.0.0.nupkg
```

## versions

List every version of a package by its **Package ID** (the `Title` field from `list`, not the `Key`).

```bash
uip resource libraries versions MyLib
```

## upload

Upload a `.nupkg` to the tenant feed. Requires `--file <path>`.

```bash
uip resource libraries upload --file ./MyLib.1.0.0.nupkg
```

## See also

- [`uip resource` overview](./uip-resource.md) — shared conventions for every `uip resource` verb.
- [`uip or feeds`](./uip-orchestrator-feeds.md) — list available feeds and their IDs.
- [How-to: manage Orchestrator assets and queues](./howto-manage-resources.md) — multi-resource workflows.