Skip to navigation
aVenture APINews and ContentNews

List Entity News Subscriptions

View as Markdown

The caller’s news webhook subscriptions with each one’s delivery state. The signing secret is never returned; each item’s subscription is the unsubscribe body.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

OK
consecutiveFailureCountinteger
Failed deliveries since the last acknowledged one or refresh.
createdAtdatetime
cursorstring
Opaque watermark the next delivery resumes after.
idstring

Stable subscription id; sent as X-MCP-Subscription-Id.

nextAttemptAtdatetime
Earliest time the next delivery attempt runs.
refreshBeforedatetime
The subscription expires unless refreshed before this instant.
statusenum

active delivers; retrying backs off after a failure; paused stopped after the maximum consecutive failures until the subscription is refreshed; expired passed refreshBefore and is about to be removed.

Allowed values:
subscriptionobject

Event, arguments, and url; the unsubscribe request body.

updatedAtdatetime
Latest subscribe, refresh, acknowledged, or failed delivery.
verifiedAtdatetime
When the endpoint last answered the verification challenge.
lastErrorstring or nullOptional

Short cause of the latest failed delivery; null after a success.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error