Read catalog arrival events or capture a polling cursor.
mode=high-water captures the latest matching cursor; page reads subsequent arrivals. Copy all returned cursor fields together. source-unavailable is an HTTP 200 refusal, not an empty successful page.
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.
Request
- Base URL: https://huggingbay.xyz
- URL: https://huggingbay.xyz/api/retention/catalog-arrivals
- Auth: none required
Query parameters
Read events or capture the high-water mark.
Maximum rows to return.
Catalog retention filter.
Comma-separated artifact types.
Catalog retention filter.
Catalog retention filter.
Catalog retention filter.
Catalog retention filter.
Catalog retention filter.
Catalog retention filter.
Catalog retention filter.
Catalog retention filter.
Catalog retention filter.
Catalog retention filter.
Minimum card completeness.
Use 1 to select verified metadata.
Use 1 for commercial-only criteria.
Opaque cursor field copied from the previous response.
Opaque cursor field copied from the previous response.
Opaque cursor field copied from the previous response.
Opaque cursor field copied from the previous response.
Response
Read catalog arrival events or capture a polling cursor.
Changes
No recorded changes to this operation across all 3 revisions of this API.