Subscribe a callback to future successful completions

Requires a render or full API key. Creation is serialized with account completions; only events after start_cursor enqueue deliveries. Repeating the same URL with the same issuing key returns the same subscription. Notifications contain id, delivery_id, job_id, cursor and event=render.finished; retrieve authoritative output from GET /render/completions?job_id. Delivery is at least once, with bounded persisted retry and receipt retention. An already in-flight request can finish after unsubscribe/revocation. Responses never return target_url.

post/render/subscriptions

Request

  • Base URL: https://rendry.io/api/v1
  • URL: https://rendry.io/api/v1/render/subscriptions
  • Auth: HTTP bearer

Headers

X-End-Userstring

Analytics correlation only; never authorizes files or accounts. One safe ASCII value up to 64 bytes. Invalid values return 400. Persisted embedded subject takes precedence. Allowed by CORS.

X-Rendry-Accountstring

Browser/OAuth current member account selector. API keys/embed credentials are bound to their persisted account and reject another account. Omitting this header selects the browser actor personal account.

Request body

target_urlstring uri required

Public HTTP(S) destination; maximum 4096 UTF-8 bytes. Private addresses fail at creation; DNS and redirect destinations are checked on each delivery.

Response

Created subscription or same-key same-destination existing subscription

idstring required
created_atstring date-time required
start_cursorstring required

Committed completion cutoff when this subscription began; older retained jobs require explicit replay.

Changes

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