---
title: "Lookup"
method: POST
path: "/api/v1/catalog/build-inputs/lookup"
tags: ["build-inputs"]
---

# Lookup

`POST /api/v1/catalog/build-inputs/lookup`

Resolve build inputs for one or more reference groups.

Direct references resolve to latest; the transitive closure is taken
verbatim; a cross-reference conflict yields a per-group conflict result.

For each group, walks the transitive package_inputs closure (accessor),
then applies auth redaction and assembles the flat LockedInputs map.

Each group runs in its own transaction so a single group's timeout,
overflow, or conflict produces a per-group error without affecting others.

## Request body

- BuildInputsLookupRequest — Request body for the /build-inputs/lookup endpoint. A lookup names a `stability` (required) and one or more `groups` of references to resolve, optionally anchored at a `reference_point`. It is system-independent — the response is source revs + DAG edges, which carry no system — so the request body has no system field.
  - `stability` string, required
  - `reference_point` ReferencePoint — Temporal anchor for a build-inputs lookup. At most one of as_of_date / as_of_build may be set. When both are absent the server interprets this as "now". Uses a plain optional- fields model with a model_validator — NOT a discriminated union — because the two anchors carry different value types.
    - `as_of_date` string, date-time, nullable
    - `as_of_build` BuildRef — Reference to a specific build by catalog, attr_path, and revision.
      - `catalog` string, required
      - `attr_path` string, required
      - `rev` string, required
  - `groups` LookupGroup[], required
    - `key` string, required
    - `references` string[], required

## Response `200`

Successful Response

- BuildInputsLookupResponse — Response body for the /build-inputs/lookup endpoint.
  - `version` integer
  - `groups` object, required

## Other responses

- `422` — Request validation error

---

[API](https://skmtc.net/flox/apis/floxhub-catalog-server.md) · [All operations](https://skmtc.net/flox/apis/floxhub-catalog-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flox/floxhub-catalog-server/versions/05d6283fc201/schema)