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

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"
      }
    ]
  }
]