Bind Package Version

Description: Binds a specific package version with the specified application. A specific package version can be bound to only one application.

Since: AppTrust 1.16.4

Usage: POST https://{{artifactory-host}}/apptrust/api/v1/applications/{{application_key}}/packages

Consumes: application/json

Request Body:

Property	Required/Optional	Type	Description
`package_type`	required	string	The package type (for example, `maven`, `docker`, `generic`, etc.)
`package_name`	required	string	The package name.
`package_version`	required	string	The package version.

Property

Required/Optional

Type

Description

package_type

required

string

The package type (for example, maven, docker, generic, etc.)

package_name

required

string

The package name.

package_version

required

string

The package version.

Response Body:

Property	Type	Description
`application_key`	string	The key of the application to which the package has been bound (associated).
`package_type`	string	The package type (for example, `maven`, `docker`, `npm`, `generic`, etc.).
`package_name`	string	The package name.
`package_version`	string	The package version.
`bound_at`	string	The timestamp of when the binding operation was performed (ISO 8601 format).
`bound_by`	string	The user who performed the binding operation.

Sample Request:

POST 'https://{host}.jfrog.io/apptrust/api/v1/applications/my-web-app/package-versions'
Content-Type: application/json
Authorization: ••••••

{
  "package_type": "maven",
  "package_name": "com.example:common-utils",
  "package_version": "1.2.3"
}

Sample Response:

{
  "application_key": "my-web-app",
  "package_type": "maven",
  "package_name": "com.example:common-utils",
  "package_version": "1.2.3",
  "bound_at": "2025-06-04T20:30:00Z",
  "bound_by": "user@example.com"
}

Status Codes:

Code	Description
201	Success
400	Bad Request
401	Bad Credentials
403	Permission Denied
404	Not Found
409	Conflict