---
isPublished: true
knowledgeIndex: false
hidden: true
noindex: true
template: "page.peb"
title: "Package Manager Flow Reference"
description: "Inputs, outputs, transaction effects and troubleshooting for Package Manager in Salesforce Flow."
contentType: "reference"
audience: "admin,developer"
---

# Package Manager

Retrieve, create or install an DialogueOne AI package.
The namespaced Apex action name is `rooms__PackageManager`.

**Reference status: Administrative.** Review the supported behavior and limitations below.

## Transaction summary

| Effect | Behavior |
| --- | --- |
| API callout | Yes. Package retrieval and creation make synchronous API callouts. |
| Record writes | Creation updates package references on agent-related records. Installation inserts or updates package records. Error handling can create DialogueOne Event records. |
| Background work | No queued work is started. |
| Platform event | The action does not directly publish a platform event. |
| Email | The action does not send email. |

Use an administrative Flow with an approved package and operation. Select one operation. Get Package takes precedence when its Package ID is supplied; otherwise Create Package is checked before Install Package.

Password-protected packages must be installed through Agent Gallery. An Install Password input does not bypass that requirement.

Skill ID, Prompt ID, Package Code, Sandbox Install Allowed and Production Install Allowed remain exposed inputs. They do not independently control package contents or installation eligibility in this action. Review the selected package and its actual installation result.

## Inputs

Required describes the Flow input setting. Additional conditions are stated in the guidance.

| API name | Flow label | Required | Default or guidance |
| --- | --- | --- | --- |
| `modelID` | Agent ID | No | Agent ID for creation, or the parent agent for a skill-only installation. |
| `skillID` | Skill ID | No | Retained input. Does not select an independent skill export in this action. |
| `promptID` | Prompt ID | No | Retained input. Does not select an independent prompt export in this action. |
| `name` | Name | No | Package display name for creation. |
| `description` | Description | No | Package description for creation. |
| `operation` | Install Operation (INSERT or UPSERT) | No | Defaults to `INSERT`. Use `UPSERT` only for the approved update behavior. |
| `metaPackageLink` | Meta Package Link | No | Optional package metadata link for creation. |
| `packagePostInstallURL` | Package Post Install URL | No | Optional public post-install URL. |
| `installPassword` | Install Password | No | Optional password when creating a protected package. Protected installation uses Agent Gallery. |
| `packageCode` | Package Code | No | Retained compatibility input; do not use it instead of Package ID. |
| `sandboxInstall` | Sandbox Install Allowed | No | Declared default: `true`. Does not independently enforce sandbox eligibility here. |
| `productionInstall` | Production Install Allowed | No | Declared default: `true`. Does not independently enforce production eligibility here. |
| `includeSystemMemories` | Include System Memories | No | Defaults to `true`. Review whether system memories belong in the exported package. |
| `packageID` | Package ID | No | Verified Package ID for retrieval or installation. |
| `getPackage` | Get Package | No | Defaults to `false`. Retrieves Package ID without installing it. |
| `installPackage` | Install Package (default = false: retrieve only) | No | Defaults to `false`. Requests installation of Package ID. |
| `createPackage` | Create Package (default = false) | No | Defaults to `false`. Requests creation of the reviewed agent package. |

## Outputs

| API name | Flow label | Meaning |
| --- | --- | --- |
| `success` | Success | Whether the action reported success. Check this value before continuing. |
| `message` | Error Message | Result details or an error. Read this value with Success. |
| `packageID` | Package ID | The retrieved or created package identifier. |
| `targetID` | Target ID | The main installed record ID when available. |
| `packagePostInstallURL` | Package Post Install URL | Post-install URL when returned. |
| `metaPackage` | Meta Package | Returned package details. Do not treat retrieved metadata as authorization to install it. |

## Configure the Flow

1. Select retrieval, creation or installation, and obtain approval for the intended administrative change.
2. Supply the verified Package ID for retrieval or installation.
3. For creation, select the Agent ID and reviewed package name, description and memory settings.
4. For installation, select INSERT or UPSERT deliberately.
5. Check Success, Error Message and Target ID. Verify affected records before a retry.

Confirm the Flow user's action access and the required access to the referenced records.
Review the configured Salesforce API connection user's access when the action makes a callout.
Connect the action's Fault path.

## Troubleshooting

**You have uncommitted work pending.** Check earlier record writes, queued work and other actions in the same transaction.
Review the [transaction settings and debugger limits](/content/build/flows/index.md#resolve-uncommitted-work-pending).

**No operation is selected.** Enable the intended operation and supply its required identifiers.

**The package requires a password.** Use Agent Gallery. Do not place an installation password in an ordinary public Flow screen or log.

**The result is unsuccessful or uncertain.** Inspect existing package references and installed records before repeating creation or installation. An INSERT retry can create duplicates.

Confirm that the action and its fields exist in the installed package.
See the [Flow action index](/content/build/flows/index.md) for related actions and transaction guidance.
