renza

API reference / Imports

Anonymous import (no auth)

POST/v1/public/imports

Public. Hosts a single HTML deck without an account and tracks it against the supplied `anon_token`, returning a `/try/<id>` link. Pass the same `external_id` again to update that try in place (same link). Sign in later and claim the token's imports into a real org. Larger/multi-file imports require authentication.

Public — no authentication required. Supports idempotency keys.

`renza publish` uses this path when you're not logged in.

Body parameters

  • htmlstringoptional

    Single-file: the raw deck HTML. Provide this OR `files`.

  • filesarray of objectoptional

    Bounded multi-file bundle (entry + assets), entry auto-detected. Max 20 files / ~3 MB — sign in for larger bundles.

  • anon_tokenstringrequired

    A client-held token the import is tracked against (the claim key).

  • external_idstringoptionalmax 255 chars

    Stable id, unique per anon token. Republishing with the same one UPDATES the existing try in place — same /try link, fresh content and TTL — instead of minting a new link. Omitted → the server derives a fresh one from the deck title and returns it as `external_id`; reuse it to update in place.

Returns

  • 200An existing try, updated in place (matched by `external_id`).
  • 201The hosted anonymous import.

Failures use the standard error envelope with a closed set of codes.