Sign in

v50

latestOpenAPI 3.0.2raw.githubusercontent.com2026-08-013374139.1 KB
catalogs

Submit a build of a particular package

Create or update a build of a package

Path Parameters:

  • catalog_name: The name of the catalog
  • package_name: The name of the package Body Content:
  • PackageBuild: The build info to submit

Returns:

  • PackageBuildResponse
post/api/v1/catalog/catalogs/{catalog_name}/packages/{package_name}/builds

Path parameters

catalog_namestring required
Example:mycatalog
package_namestring required
Example:curl

Request body

urlstring required
revstring required
rev_countinteger required
rev_datestring date-time required
locked_base_catalog_urlstring nullable
base_catalog_rev_datestring date-time nullable
base_catalog_rev_countinteger nullable
cache_uristring nullable
refstring nullable
dot_flox_dirstring
build_type'manifest' | 'nef'

Records the build methodology used to produce a package.

NEF packages carry full source metadata and can be reproduced from source; manifest packages were built via the traditional flox manifest workflow.

narinfosNarInfos
narinfos_source_urlstring nullable
narinfos_source_versioninteger nullable
locked_inputsobject nullable

Example request

{
  "base_catalog_rev_count": 11000,
  "base_catalog_rev_date": "2021-08-15T00:00:00Z",
  "derivation": {
    "broken": false,
    "description": "A command line tool for transferring files with URL syntax",
    "drv_path": "/nix/store/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa-curl-8.5.0.drv",
    "license": "curl",
    "name": "curl-8.5.0",
    "outputs": [
      {
        "name": "out",
        "store_path": "/nix/store/bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb-curl-8.5.0"
      },
      {
        "name": "man",
        "store_path": "/nix/store/cccccccccccccccccccccccccccccccc-curl-8.5.0-man"
      }
    ],
    "outputs_to_install": [
      "out",
      "man"
    ],
    "pname": "curl",
    "system": "x86_64-linux",
    "unfree": false,
    "version": "8.5.0"
  },
  "locked_base_catalog_url": "https://github.com/flox/nixpkgs?rev=99dc8785f6a0adac95f5e2ab05cc2e1bf666d172",
  "rev": "99dc8785f6a0adac95f5e2ab05cc2e1bf666d172",
  "rev_count": 12345,
  "rev_date": "2021-09-01T00:00:00Z",
  "url": "https://github.com/org/example"
}

Response

The build already exists

PackageBuildResponse required