renza

API reference / Decks

Update a deck

PATCH/v1/decks/{id}

Partial update — only provided fields change. `metadata` merges (key→value sets, key→null deletes, {} clears all). State transitions are field updates (no verb routes).

Requires an API key (bearer), scoped to the active org. Supports idempotency keys.

Path parameters

  • idstringrequired

Body parameters

  • titlestringoptionalmax 300 chars
  • statusstringoptional
  • share_modestringoptional
  • folderstring | nulloptional

    Move to a folder, or null for the root.

  • current_artifactstringoptional

    Roll the deck back to one of its own prior artifact versions.

  • metadataobjectoptional

    Arbitrary key/value map; merge-on-write (§6).

  • trashedbooleanoptional

    Set false to restore a trashed deck.

Returns

  • 200The updated deck.

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