Artifacts
Agent Docs

Common-path compatibility alias for bounded artifact search.

Alias of /api/v1/search (recorded; identical handler). Prefer the recorded path: this one already answers with Deprecation and Sunset headers. Internal alias for /api/artifacts. It applies summary=1 and limit=20 when omitted, preserves the public artifact-search filters, and never redirects or exposes private rows.

Inputs. Path, query and header fields are listed below. No request body is required.

Outputs. See each status below for its media type, schema and headers. A missing record or unavailable capability is not a successful empty result.

Errors. API JSON failures use the documented response schema. Read code, message and next; retry only when the response allows it. Auth, invalid input and missing records need a caller change.

Rate limits. Public read budgets apply by client IP and route group. This operation can have a smaller route-specific budget. Read Retry-After on 429 or retryable 503 responses.

get/api/search

Request

  • Base URL: https://huggingbay.xyz
  • URL: https://huggingbay.xyz/api/search
  • Auth: none declared

Query parameters

qstring
typestring
licensestring
taskstring

Pipeline task or Browse alias: code requires text-generation plus a coding name/tag; chat requires conversational or text-generation plus an instruct/chat name/tag; pictures means text-to-image.

size'small' | 'medium' | 'large'

Recorded default weight download: small <= 2 GB, medium > 2 and <= 8 GB, large > 8 GB (decimal GB). Unknown or incomplete sizes are excluded and counted in unknownSizeExcluded.

formatstring
sourcestring
hostingstring
worksWithstring
reviewStatus'first-review' | 'needs-evidence' | 'reviewed' | 'benchmark'
commercialstring
semantic'1'
explain'1'
sortstring
limitinteger
cursorstring

Start with cursor=0 and follow nextCursor. offset and page are unsupported.

compat'containment'

Deprecated legacy response block opt-in for one release only.

Response

Bounded public artifact page

rowsArtifactSummary[] required(unresolved $ref)
unknownSizeExcludedinteger

Matching records excluded by the size filter because the default download has no complete recorded byte size. Counted before pagination with the other query filters applied.

totalnumber required
limitnumber required
cursorstring required
nextCursorstring nullable required
facetsFacetCounts (unresolved $ref)
facetsApproximateboolean

True when facet counts cover a bounded search candidate set or returned page rather than the complete matching catalog.

facetsScope'bounded-search-candidates' | 'returned-search-page' | 'degraded-fallback-results' | 'no-match'
facetsPartialboolean

True when facets cover only the returned page because complete matching-catalog facet counts were unavailable within the bounded search deadline.

facetsUnavailableboolean

True when no facet counts could be derived because the bounded result page was empty and no complete cached facet result was available.

facetsGeneratedAtstring date-time

Timestamp for the returned complete or page-scoped facet result.

estimatedTotalboolean

True when total is bounded or estimated and must not be treated as the complete matching catalog count. Within one query the total is stable across every cursor page.

degradedboolean

True only when the response came from a degraded, stale, or fallback catalog read after a backend error. A well-formed query with no matches is degraded:false, partial:false, total:0 with reason:"no_match".

partialboolean

True when returned rows may omit matching catalog entries because of a backend error; zero rows or totals are then not authoritative. Never set on a clean no-match page.

reason'no_match' | 'cursor_past_end'

Why a healthy response carries zero rows: no_match (nothing matched; total is 0) or cursor_past_end (the cursor is beyond the stable total; nextCursor is null).

retryableboolean

True when retrying may recover a more complete catalog response.

retryAfterSecondsinteger

Suggested minimum delay before retrying a degraded catalog response.

warningstring
fastPathstring
generatedAtstring required

Changes

No recorded changes to this operation across all 1 revision of this API.