Subscribe to Entity News
Creates or refreshes a webhook subscription to news newly linked to one entity. A new endpoint must echo a signed verification challenge before the subscription exists.
Authentication
AuthorizationBearer
Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token
Request
This endpoint expects an object.
arguments
Arguments of the entity.news.published event.
delivery
Webhook delivery target and secret.
name
Subscribable event name
Allowed values:
cursor
Opaque watermark from an earlier grant or event to resume after; null starts a new subscription from now and keeps an existing subscription’s position.
ttlMs
Requested subscription lifetime in milliseconds; the server caps it.
Response headers
X-RateLimit-Limit
Requests allowed per client IP in the current rate-limit window.
X-RateLimit-Remaining
Requests left before the tightest applicable rate-limit bucket rejects.
X-RateLimit-Reset
Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.
Response
OK
cursor
Opaque watermark the subscription delivers after.
id
Stable subscription id; sent as X-MCP-Subscription-Id.
refreshBefore
The subscription expires unless refreshed before this instant.
truncated
Whether events between the requested cursor and now were lost.
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error