SubscriberPackageVersion

Represents a package version (first- or second-generation) across all Salesforce instances.

Introduced in API version 36.0.

describeSObjects(), query(), retrieve()

GET, Query

• Type: text

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: The AppExchange description for this package.

If the AppExchange listing for the package doesn’t contain a value for this field, the field’s value is null.

• Type: text

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: The URL that AppExchange uses to display the logo for this package.

If the AppExchange listing for the package doesn’t contain a value for this field, the field’s value is null.

• Type: text

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: The AppExchange name for this package.

If the AppExchange listing for the package doesn’t contain a value for this field, the field’s value is null.

• Type: text

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: The AppExchange publisher name for this package.

If the AppExchange listing for the package doesn’t contain a value for this field, the field’s value is null.

• Type: integer

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: Part of the version number of a package version. The complete version number format is major.minor.patch.build—for example, in 1.2.0.5 the build number is 5.

• Type: complexvaluetype

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: List of new Trusted URLs (CspTrustedSite) that the user must authorize before installing the package version. Package upgrades don’t include previously installed Trusted URLs.

• Type: complexvaluetype

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Introduced: API version 44.0

• Description: Other subscriber package versions that this subscriber package version depends on.

• Type: text

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: Description of the package.

• Type: staticenum

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: Status of the validation tests that are run during the package version install.

• Type: boolean

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Introduced: API version 41.0

• Description: Indicates whether the package version is released (false).

• Type: boolean

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: Specifies whether this package version has been marked as deprecated (true) or not (false).

• Type: boolean

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: Specifies whether this package is managed (true) or not (false).

• Type: boolean

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Introduced: API version 49.0

• Description: Indicates whether the package depends on unpackaged metadata in the installation org (true) or not (false). This field applies to unlocked packages only. The default value is false.

• Type: boolean

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: Specifies whether installation of this package version requires the user to provide an installation key (true) or not (false).

• Type: boolean

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Introduced: API version 41.0

• Description: Specifies whether the package has passed the security review required for publishing in AppExchange.

• Type: integer

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: Part of the version number of a package version. The complete version number format is major.minor.patch.build—for example, in 1.2.0.5 the major version is 1.

• Type: integer

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: Part of the version number of a package version. The complete version number format is major.minor.patch.build—for example, in 1.2.0.5 the minor version is 2.

• Type: name

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: Name of the package.

• Type: staticenum

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Introduced: API version 41.0

• Description: Container options for the second-generation package. These options determine the upgrade and editability rules.

• Type: integer

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: Part of the version number of a package version. The complete version number format is major.minor.patch.build—for example, in 1.2.0.5 the patch version is 0.

• Type: text

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: The fully qualified URL of the post-installation instructions. Instructions are shown as a link after installation and are available from the package detail view.

• Type: complexvaluetype

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: List of profiles for which the package was installed.

• Type: text

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: The name of the publisher of this package.

• Type: text

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: The fully qualified URL of the package release notes. Release notes are shown as a link during the installation process and are available from the package detail view after installation.

• Type: staticenum

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: If the package version is a beta version, the value is Beta. Otherwise, the value is Released.

• Type: complexvaluetype

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: List of new Remote Site Settings that the user must authorize before installing the package. Package upgrades don’t include previously installed Remote Site Settings.

• Type: ID

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: ID of the parent SubscriberPackage. The ID starts with the string 033.

This value is case-sensitive and must be unique.

Represents the list of new Trusted URLs that the user must authorize before installing the package version. Available in API version 41.0 and later. In API version 58.

Represents a new Trusted URLs (CspTrustedSite) that the user must authorize before installing the package version. Available in API version 41.0 and later.

Represents a list of subscriber package version IDs that a subscriber package version depends on. Available in API version 44.0 and later.

Represents a mapping between the profiles contained in the package and the profiles that are applied in the target subscriber org. Available in API version 41.0 and later.

Represents the profile that an administrator applies when installing the package in a target subscriber org. Available in API version 41.0 and later.

Represents a profile contained in the package to be installed. Available in API version 41.0 and later.

Represents a list of Remote Site Settings (RSS) that have been added to the package since the last version. Available in API version 41.0 and later.

Defines a URL to an external service. The administrator of the subscriber org must authorize access to these services. Available in API version 41.0 and later.

Represents a version of an installable package. To query this object, include an ID (begins with 04t) in your SOQL WHERE clause.

For subscriber package versions with no installation keys, queries must include an ID value, but an InstallationKey value is not required.

1SELECT Dependencies FROM SubscriberPackageVersion
2   WHERE ID = '04txxxxxxxxxxxx'

For unlocked package versions that have installation keys, queries must include both an ID value and an InstallationKey value.

1SELECT Dependencies FROM SubscriberPackageVersion
2   WHERE ID = '04txxxxxxxxxxxx' AND InstallationKey='password123'

For managed first- and second-generation package versions that have installation keys and for unlocked package versions that are installed in your org, queries must include an ID value, but an InstallationKey value is optional.

1SELECT Dependencies FROM SubscriberPackageVersion
2   WHERE ID = '04txxxxxxxxxxxx'

1SELECT Dependencies FROM SubscriberPackageVersion
2   WHERE ID = '04txxxxxxxxxxxx' AND InstallationKey='password123'