Library
Agents

Return an agent-readable digest for one saved catalog search/watchlist.

Fetches a bounded live result page for a saved search and returns reusable URLs for artifact pages, metadata, cards, distribution manifests, file lists, and mirror requests. This is intended for AI agents, notification digests, and repeatable user workflows.

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.

Example setup. Use an identifier returned by the matching list, search or create operation. Sample identifiers are not a promise that a record exists. Set HUGGING_BAY_TOKEN to a credential with the role or scope stated by this operation. Reader tokens do not grant publisher or operator rights.

get/api/saved-searches/{searchId}/digest

Request

  • Base URL: https://huggingbay.xyz
  • URL: https://huggingbay.xyz/api/saved-searches/{searchId}/digest
  • Auth: HTTP bearer

Path parameters

searchIdstring required

Query parameters

limitinteger

Maximum rows to include in the digest.

Response

Saved search digest

schemaVersion'hugging-bay.saved-search-digest.v1' required
generatedAtstring required
searchSavedSearch required(unresolved $ref)
browserUrlstring required
apiUrlstring required
digestUrlstring required
rowsSavedSearchDigestRow[] required(unresolved $ref)
newOrUpdatedSavedSearchDigestRow[] required(unresolved $ref)
hostedSavedSearchDigestRow[] required(unresolved $ref)
requestableSavedSearchDigestRow[] required(unresolved $ref)
agentActionsobject
policyobject

Changes

No recorded changes to this operation across all 2 revisions of this API.