Analytics

Record a bounded first-party product action event.

Non-blocking product funnel ingestion for saves, mirror requests, reviews, publisher profile opens, and download intent. Payloads are bounded and stored only when Postgres analytics is enabled.

Inputs. No path or query fields are required. The request body schema lists accepted fields and required values.

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. Write and protocol operations can have separate route-specific limits. Read Retry-After and retry_after_s when present; do not infer a write allowance from the public read budget.

Example setup. This example is not executed by documentation checks. Review the operation and obtain any required user consent before sending it.

post/api/events/action

Request

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

Request body

actionstring required
entityTypestring
entityIdstring
pathstring
routestring
metadataobject

Response

Action event accepted or safely ignored

object required

Action event accepted or safely ignored. Fields can vary; no stronger field guarantee is specified for this operation.

Changes

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