# Application Packages

## List

> Retrieve application package(s).

```json
{"openapi":"3.0.1","info":{"title":"Parallels RAS - REST API v1.0","version":"1.0"},"paths":{"/api/AppPackage":{"get":{"tags":["0-Infrastructure//Application Packages"],"summary":"List","description":"Retrieve application package(s).","operationId":"0d432112-0f51-4591-adb4-ec63e5159bb3","parameters":[{"name":"siteId","in":"query","description":"ID of the SIte from which to retrieve the AppPackage setting.(optional).","schema":{"type":"integer","format":"int32"}},{"name":"Name","in":"query","description":"Application package name (optional).","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json; api-version=1.0":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AppPackage"}}}}},"401":{"description":"Unauthorized","content":{"application/json; api-version=1.0":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"Not Found","content":{"application/json; api-version=1.0":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}}},"components":{"schemas":{"AppPackage":{"type":"object","properties":{"id":{"type":"integer","description":"<para type=\"description\">ID of the object.</para>","format":"int32"},"adminCreate":{"type":"string","description":"<para type=\"description\">User who created the object.</para>","nullable":true},"adminLastMod":{"type":"string","description":"<para type=\"description\">User who last modified the object.</para>","nullable":true},"timeCreate":{"type":"string","description":"<para type=\"description\">Time when the object was created.</para>","format":"date-time"},"timeLastMod":{"type":"string","description":"<para type=\"description\">Time when the object was last modified.</para>","format":"date-time"},"packageName":{"type":"string","description":"<para type=\"description\">Package name</para>","nullable":true},"displayName":{"type":"string","description":"<para type=\"description\">Application package display name</para>","nullable":true},"version":{"type":"string","description":"<para type=\"description\">Application package version</para>","nullable":true},"publisher":{"type":"string","description":"<para type=\"description\">Application package publisher name</para>","nullable":true},"msixImagePath":{"type":"string","description":"<para type=\"description\">MSIX image path</para>","nullable":true},"packagedApps":{"type":"array","items":{"$ref":"#/components/schemas/PackagedApp"},"description":"<para type=\"description\">List of applications in the application package</para>","nullable":true},"dependencies":{"type":"string","description":"<para type=\"description\">Application pacakge dependencies</para>","nullable":true},"certificate":{"$ref":"#/components/schemas/AppPackageCertificate"},"siteId":{"type":"integer","description":"<para type=\"description\">ID of the Site</para>","format":"int32"},"enabled":{"type":"boolean","description":"<para type=\"description\">Whether the application package is enabled or not</para>"},"tagIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"<para type=\"description\">Application tag IDs</para>","nullable":true}},"additionalProperties":false,"description":"<para type=\"synopsis\">Application Package</para>\r\n<para type=\"description\"></para>"},"PackagedApp":{"type":"object","properties":{"name":{"type":"string","description":"<para type=\"description\">Application name in the application package</para>","nullable":true}},"additionalProperties":false,"description":"<para type=\"synopsis\">App Packages Application Info</para>\r\n<para type=\"description\"></para>"},"AppPackageCertificate":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/CertificateStatus"},"publicKey":{"type":"string","description":"<para type=\"description\">The public key.</para>","nullable":true},"expirationDate":{"type":"string","description":"<para type=\"description\">The expiration date of the certificate.</para>","format":"date-time","nullable":true},"keySize":{"$ref":"#/components/schemas/CertificateKeySize"},"commonName":{"type":"string","description":"<para type=\"description\">The common name of the certificate.</para>","nullable":true}},"additionalProperties":false,"description":"<para type=\"synopsis\">Application Package Certificate</para>\r\n<para type=\"description\"></para>"},"CertificateStatus":{"enum":[["0 = Valid","1 = Expiring","2 = Expired","3 = InProgress","4 = Revoked","5 = Issuing","6 = IssuingFailed","7 = Renewing","8 = RenewingFailed","9 = Revoking","10 = RevokingFailed"]],"type":"string","description":"<para type=\"description\">Certificate Status</para>\r\n<para type=\"synopsis\">Certificate Status</para>","format":"int32"},"CertificateKeySize":{"enum":[["0 = KeySize1024","1 = KeySize2048","2 = KeySize4096","3 = KeySize3072","4 = KeySize521","255 = KeySizeUnknown"]],"type":"string","description":"<para type=\"description\">Certificate Key Size</para>\r\n<para type=\"synopsis\">Certificate Key Size</para>","format":"int32"},"ProblemDetails":{"type":"object","properties":{"type":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"status":{"type":"integer","format":"int32","nullable":true},"detail":{"type":"string","nullable":true},"instance":{"type":"string","nullable":true}},"additionalProperties":{}}}}}
```

## Create

> Create a new application package.

```json
{"openapi":"3.0.1","info":{"title":"Parallels RAS - REST API v1.0","version":"1.0"},"paths":{"/api/AppPackage":{"post":{"tags":["0-Infrastructure//Application Packages"],"summary":"Create","description":"Create a new application package.","operationId":"845aba2f-4516-4db5-8a7f-b4171addc058","requestBody":{"description":"Application package settings.","content":{"application/json; api-version=1.0":{"schema":{"$ref":"#/components/schemas/NewAppPackage"}}}},"responses":{"201":{"description":"Created","content":{"application/json; api-version=1.0":{"schema":{"$ref":"#/components/schemas/AppPackage"}}}},"401":{"description":"Unauthorized","content":{"application/json; api-version=1.0":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"Conflict","content":{"application/json; api-version=1.0":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}}},"components":{"schemas":{"NewAppPackage":{"required":["msixImagePath","packageName"],"type":"object","properties":{"displayName":{"maxLength":255,"minLength":1,"type":"string","description":"<para type=\"description\">Display name of the new application package.</para>","nullable":true},"packageName":{"maxLength":255,"minLength":1,"type":"string","description":"<para type=\"description\">Package name of the new application package.</para>","nullable":true},"msixImagePath":{"type":"string","description":"<para type=\"description\">MSIX image path of the new application package.</para>","nullable":true}},"additionalProperties":false,"description":"<para type=\"synopsis\">To create a new Application Package</para>\r\n<para type=\"description\"></para>"},"AppPackage":{"type":"object","properties":{"id":{"type":"integer","description":"<para type=\"description\">ID of the object.</para>","format":"int32"},"adminCreate":{"type":"string","description":"<para type=\"description\">User who created the object.</para>","nullable":true},"adminLastMod":{"type":"string","description":"<para type=\"description\">User who last modified the object.</para>","nullable":true},"timeCreate":{"type":"string","description":"<para type=\"description\">Time when the object was created.</para>","format":"date-time"},"timeLastMod":{"type":"string","description":"<para type=\"description\">Time when the object was last modified.</para>","format":"date-time"},"packageName":{"type":"string","description":"<para type=\"description\">Package name</para>","nullable":true},"displayName":{"type":"string","description":"<para type=\"description\">Application package display name</para>","nullable":true},"version":{"type":"string","description":"<para type=\"description\">Application package version</para>","nullable":true},"publisher":{"type":"string","description":"<para type=\"description\">Application package publisher name</para>","nullable":true},"msixImagePath":{"type":"string","description":"<para type=\"description\">MSIX image path</para>","nullable":true},"packagedApps":{"type":"array","items":{"$ref":"#/components/schemas/PackagedApp"},"description":"<para type=\"description\">List of applications in the application package</para>","nullable":true},"dependencies":{"type":"string","description":"<para type=\"description\">Application pacakge dependencies</para>","nullable":true},"certificate":{"$ref":"#/components/schemas/AppPackageCertificate"},"siteId":{"type":"integer","description":"<para type=\"description\">ID of the Site</para>","format":"int32"},"enabled":{"type":"boolean","description":"<para type=\"description\">Whether the application package is enabled or not</para>"},"tagIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"<para type=\"description\">Application tag IDs</para>","nullable":true}},"additionalProperties":false,"description":"<para type=\"synopsis\">Application Package</para>\r\n<para type=\"description\"></para>"},"PackagedApp":{"type":"object","properties":{"name":{"type":"string","description":"<para type=\"description\">Application name in the application package</para>","nullable":true}},"additionalProperties":false,"description":"<para type=\"synopsis\">App Packages Application Info</para>\r\n<para type=\"description\"></para>"},"AppPackageCertificate":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/CertificateStatus"},"publicKey":{"type":"string","description":"<para type=\"description\">The public key.</para>","nullable":true},"expirationDate":{"type":"string","description":"<para type=\"description\">The expiration date of the certificate.</para>","format":"date-time","nullable":true},"keySize":{"$ref":"#/components/schemas/CertificateKeySize"},"commonName":{"type":"string","description":"<para type=\"description\">The common name of the certificate.</para>","nullable":true}},"additionalProperties":false,"description":"<para type=\"synopsis\">Application Package Certificate</para>\r\n<para type=\"description\"></para>"},"CertificateStatus":{"enum":[["0 = Valid","1 = Expiring","2 = Expired","3 = InProgress","4 = Revoked","5 = Issuing","6 = IssuingFailed","7 = Renewing","8 = RenewingFailed","9 = Revoking","10 = RevokingFailed"]],"type":"string","description":"<para type=\"description\">Certificate Status</para>\r\n<para type=\"synopsis\">Certificate Status</para>","format":"int32"},"CertificateKeySize":{"enum":[["0 = KeySize1024","1 = KeySize2048","2 = KeySize4096","3 = KeySize3072","4 = KeySize521","255 = KeySizeUnknown"]],"type":"string","description":"<para type=\"description\">Certificate Key Size</para>\r\n<para type=\"synopsis\">Certificate Key Size</para>","format":"int32"},"ProblemDetails":{"type":"object","properties":{"type":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"status":{"type":"integer","format":"int32","nullable":true},"detail":{"type":"string","nullable":true},"instance":{"type":"string","nullable":true}},"additionalProperties":{}}}}}
```

## Get

> Retrieve an application package by ID.

```json
{"openapi":"3.0.1","info":{"title":"Parallels RAS - REST API v1.0","version":"1.0"},"paths":{"/api/AppPackage/{id}":{"get":{"tags":["0-Infrastructure//Application Packages"],"summary":"Get","description":"Retrieve an application package by ID.","operationId":"32e28ff5-282b-4184-879d-c4ee2d9fa35d","parameters":[{"name":"id","in":"path","description":"Application package ID.","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Success","content":{"application/json; api-version=1.0":{"schema":{"$ref":"#/components/schemas/AppPackage"}}}},"401":{"description":"Unauthorized","content":{"application/json; api-version=1.0":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"Not Found","content":{"application/json; api-version=1.0":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}}},"components":{"schemas":{"AppPackage":{"type":"object","properties":{"id":{"type":"integer","description":"<para type=\"description\">ID of the object.</para>","format":"int32"},"adminCreate":{"type":"string","description":"<para type=\"description\">User who created the object.</para>","nullable":true},"adminLastMod":{"type":"string","description":"<para type=\"description\">User who last modified the object.</para>","nullable":true},"timeCreate":{"type":"string","description":"<para type=\"description\">Time when the object was created.</para>","format":"date-time"},"timeLastMod":{"type":"string","description":"<para type=\"description\">Time when the object was last modified.</para>","format":"date-time"},"packageName":{"type":"string","description":"<para type=\"description\">Package name</para>","nullable":true},"displayName":{"type":"string","description":"<para type=\"description\">Application package display name</para>","nullable":true},"version":{"type":"string","description":"<para type=\"description\">Application package version</para>","nullable":true},"publisher":{"type":"string","description":"<para type=\"description\">Application package publisher name</para>","nullable":true},"msixImagePath":{"type":"string","description":"<para type=\"description\">MSIX image path</para>","nullable":true},"packagedApps":{"type":"array","items":{"$ref":"#/components/schemas/PackagedApp"},"description":"<para type=\"description\">List of applications in the application package</para>","nullable":true},"dependencies":{"type":"string","description":"<para type=\"description\">Application pacakge dependencies</para>","nullable":true},"certificate":{"$ref":"#/components/schemas/AppPackageCertificate"},"siteId":{"type":"integer","description":"<para type=\"description\">ID of the Site</para>","format":"int32"},"enabled":{"type":"boolean","description":"<para type=\"description\">Whether the application package is enabled or not</para>"},"tagIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"<para type=\"description\">Application tag IDs</para>","nullable":true}},"additionalProperties":false,"description":"<para type=\"synopsis\">Application Package</para>\r\n<para type=\"description\"></para>"},"PackagedApp":{"type":"object","properties":{"name":{"type":"string","description":"<para type=\"description\">Application name in the application package</para>","nullable":true}},"additionalProperties":false,"description":"<para type=\"synopsis\">App Packages Application Info</para>\r\n<para type=\"description\"></para>"},"AppPackageCertificate":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/CertificateStatus"},"publicKey":{"type":"string","description":"<para type=\"description\">The public key.</para>","nullable":true},"expirationDate":{"type":"string","description":"<para type=\"description\">The expiration date of the certificate.</para>","format":"date-time","nullable":true},"keySize":{"$ref":"#/components/schemas/CertificateKeySize"},"commonName":{"type":"string","description":"<para type=\"description\">The common name of the certificate.</para>","nullable":true}},"additionalProperties":false,"description":"<para type=\"synopsis\">Application Package Certificate</para>\r\n<para type=\"description\"></para>"},"CertificateStatus":{"enum":[["0 = Valid","1 = Expiring","2 = Expired","3 = InProgress","4 = Revoked","5 = Issuing","6 = IssuingFailed","7 = Renewing","8 = RenewingFailed","9 = Revoking","10 = RevokingFailed"]],"type":"string","description":"<para type=\"description\">Certificate Status</para>\r\n<para type=\"synopsis\">Certificate Status</para>","format":"int32"},"CertificateKeySize":{"enum":[["0 = KeySize1024","1 = KeySize2048","2 = KeySize4096","3 = KeySize3072","4 = KeySize521","255 = KeySizeUnknown"]],"type":"string","description":"<para type=\"description\">Certificate Key Size</para>\r\n<para type=\"synopsis\">Certificate Key Size</para>","format":"int32"},"ProblemDetails":{"type":"object","properties":{"type":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"status":{"type":"integer","format":"int32","nullable":true},"detail":{"type":"string","nullable":true},"instance":{"type":"string","nullable":true}},"additionalProperties":{}}}}}
```

{% openapi src="/files/oEgjY6sMA31ZVBC35aoj" path="/api/AppPackage/{id}" method="put" %}
[swagger 1.json](https://content.gitbook.com/content/jyGAUPrA6XIdGAfHCnJE/blobs/7mKwtvutT7xlWtmCVnxB/swagger%201.json)
{% endopenapi %}

{% openapi src="/files/oEgjY6sMA31ZVBC35aoj" path="/api/AppPackage/{id}" method="delete" %}
[swagger 1.json](https://content.gitbook.com/content/jyGAUPrA6XIdGAfHCnJE/blobs/7mKwtvutT7xlWtmCVnxB/swagger%201.json)
{% endopenapi %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.parallels.com/landing/ras-rest-api-guide/api-reference/infrastructure/application-packages.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.