Lookups

On-demand GitHub source materialization

Resolves a GitHub org/repo coordinate to a registry source. Idempotent — if the source already exists, returns it with status: "existing"; otherwise probes GitHub, inserts a hidden on_demand source row (and a new on_demand org when no curated org claims the segment), and ingests up to 100 releases.

Negative results (not_found, empty) are cached in KV (24h and 6h respectively) so repeat probes don't re-hit GitHub. deferred outcomes (rate-limit, 5xx) are not cached and let the next cron pass retry.

Body requires provider: "github" — other providers are explicitly rejected, not silently accepted. Coordinate must match {org}/{repo} (case-insensitive; URLs are deduped via LOWER(sources.url)).

post/lookups

Response

Lookup result. Inspect status to disambiguate outcomes.

status'indexed' | 'existing' | 'empty' | 'not_found' | 'deferred' required

Changes

Changed in 1 of the 5 revisions of this API.1

    • added the new too_large enum value to the error/type response property for the response status 400

      response-property-enum-value-added