Upload Single Package

POST https://api.repoflow.io/1/workspaces/<workspace-ref>/repositories/<repository-ref>/packages/single

Upload a single package to a repository. You can include multiple files if they belong to the same package and version (for example, Maven .jar with pom.xml).

This endpoint works only with local repositories, or with virtual repositories that have a local repository configured as their upload target.

Minimum Permission: Can manage, Can Deploy • Authentication Not Required

Path Parameters

workspace-refstringRequired

Workspace ID or name.

repository-refstringRequired

Repository ID or name.

Form Data

packageFilesfile[]Required

File(s) to upload, provided as form-data.

packageNamestringOptional

Package name (required for Universal repositories). For Universal repositories, this may include multiple path segments such as team/platform/tool. It must not start or end with /, contain consecutive /, or exceed 500 characters.

packageVersionstringOptional

Package version (required for Universal or Composer repositories).

debianRepositoryComponentstringOptional

Debian repository component. Allowed: main, restricted, universe, multiverse.

debianDistributionstringOptional

Debian distribution (trusty, xenial, bionic, focal, jammy, noble, buster, bullseye, bookworm, trixie, stable).

Request

curl -sS -X POST "https://api.repoflow.io/1/workspaces/<workspace-ref>/repositories/<repository-ref>/packages/single" \
  -H "Authorization: Bearer <accessToken>" \
  -H "Accept: application/json" \
  -F "packageFiles=@/path/to/package-file"

Response

The server always responds with HTTP 200, containing an array of upload results.

[
  {
    "packageFileName": "string",
    "isSucceeded": true,
    "errorMessage": "string",
    "createdPackages": [
      {
        "packageId": "string",
        "versionId": "string",
        "link": "string"
      }
    ]
  }
]