Save the draft (Workspace, owner only)
Save the app’s mutable draft: a save is never rejected for validation failures — full validation still runs and the result (valid/issues) comes back alongside; “save half now, keep editing later” is a model promise.
The app identity is created implicitly on the first save (there is no separate “create app” endpoint). Only three minimal hard checks (400): the account has a username, the content is within the size limit, and attached file names are legal (identity.app_name in the manifest is no longer compared to the path — the routing name follows the ref; the declared name in the file is consumed only at creation). Optimistic concurrency via expected_revision (409 revision-conflict; multiple tabs never overwrite silently). Bundled secrets are stored only when this save is valid (no credentials scattered from half-finished drafts); names not stored are reported via secrets_deferred. Editing stays allowed while deprecated (self-testing is harmless; what is rejected is a new Release).
Authorizations
DataHub API Key
Path Parameters
Body
Response
Successful Response