API reference

Renza is API-first: the dashboard, the CLI, and the SDK are all clients of this API — anything they can do, you can do here. Every operation page shows the same call three ways: CLI, curl, and SDK.

https://api.renza.io/v1

Authorization: Bearer rza_sk_live_…

The version is in the path — v1 is frozen, breaking changes ship as a new version (see Versioning). Auth, pagination, idempotency, and the error contract each have a short page under Platform in the sidebar. The machine-readable spec lives at api.renza.io/openapi.json.

Resources

• DecksThe governed document.
  GETListPOSTCreateGETRetrievePATCHUpdateDELETEDelete
• FoldersFolders organize decks inside an org.
  GETListPOSTCreateGETRetrievePATCHUpdateDELETEDelete
• ImportsHow content enters Renza.
  GETListPOSTCreateGETRetrievePOSTClaimPOSTAnonymous import
• ArtifactsThe stored, immutable HTML versions of a deck.
  GETListGETRetrieveGETContent
• SlidesThe parsed structure of an artifact — one entry per slide, with the stable anchor_id that comments pin to across versions..
  GETList
• SharesLink access to a deck.
  GETListPOSTCreateDELETERevokeGETResolve
• CommentsThe review loop.
  GETListPOSTCreateGETRetrievePATCHUpdateDELETEDelete
• GrantsThe permissions model.
  GETListPOSTCreateGETRetrieveDELETERevoke
• Orgs & membershipsThe tenancy spine.
  GETListGETRetrievePATCHUpdateGETMemberships
• API keysCredentials for agents, CI, and integrations.
  GETListPOSTCreateDELETERevoke
• MeWho am I? Resolves the authenticated actor, the active org, and the credential mode — the first call to make when wiring up a client..
  GETRetrieve
• CLI pairingThe browser pairing flow behind renza login: start a pairing, approve it in the browser on the auth origin, poll to collect the minted org-scoped key.
  POSTStartPOSTPoll
• HealthLiveness probe.
  GETCheck