POST

/v1/packages#domain&repository

http://codeartifact.{region}.amazonaws.com/v1/packages#domain&repository

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.

Access Token Required: API Key

Query Params

domainstringrequired

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.

repositorystringrequired

The name of the repository that contains the requested packages.

formatstring

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

Allowed:

namespacestring

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. Each package format uses namespace as follows: <ul> <li> The namespace of a Maven package is its <code>groupId</code>. </li> <li> The namespace of an npm package is its <code>scope</code>. </li> <li> Python and NuGet packages do not contain a corresponding component, packages of those formats do not have a namespace. </li> <li> The namespace of a generic package is its <code>namespace</code>. </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.

publishstring

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>.

Allowed:

upstreamstring

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>.

Allowed:

maxResultsstring

Pagination limit

nextTokenstring

Pagination token

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://codeartifact.{region}.amazonaws.com/v1/packages#domain&repository' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

1curl --request POST \ 2 --url 'http://codeartifact.{region}.amazonaws.com/v1/packages#domain&repository' \ 3 --header 'accept: application/json' \ 4 --header 'content-type: application/json'