v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1438166195.6 KB

Returns a list of <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageSummary.html">PackageSummary</a> objects for packages in a repository that match the request parameters.

post/v1/packages#domain&repository

Query parameters

domainstring required

The name of the domain that contains the repository that contains the requested packages.

domain-ownerstring

The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.

repositorystring required

The name of the repository that contains the requested packages.

format'npm' | 'pypi' | 'maven' | 'nuget' | 'generic'

The format used to filter requested packages. Only packages from the provided format will be returned.

namespacestring
<p>The namespace prefix used to filter requested packages. Only packages with a namespace that starts with the provided string value are returned. Note that although this option is called <code>--namespace</code> and not <code>--namespace-prefix</code>, it has prefix-matching behavior.</p> <p>Each package format uses namespace as follows:</p> <ul> <li> <p> The namespace of a Maven package is its <code>groupId</code>. </p> </li> <li> <p> The namespace of an npm package is its <code>scope</code>. </p> </li> <li> <p> Python and NuGet packages do not contain a corresponding component, packages of those formats do not have a namespace. </p> </li> <li> <p> The namespace of a generic package is its <code>namespace</code>. </p> </li> </ul>
package-prefixstring

A prefix used to filter requested packages. Only packages with names that start with <code>packagePrefix</code> are returned.

max-resultsinteger

The maximum number of results to return per page.

next-tokenstring

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

publish'ALLOW' | 'BLOCK'

The value of the <code>Publish</code> package origin control restriction used to filter requested packages. Only packages with the provided restriction are returned. For more information, see <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageOriginRestrictions.html">PackageOriginRestrictions</a>.

upstream'ALLOW' | 'BLOCK'

The value of the <code>Upstream</code> package origin control restriction used to filter requested packages. Only packages with the provided restriction are returned. For more information, see <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageOriginRestrictions.html">PackageOriginRestrictions</a>.

maxResultsstring

Pagination limit

nextTokenstring

Pagination token

Response

Success

nextTokenstring

If there are additional results, this is the token for the next set of results.