Skip to content

api!: delete_transport() must not be used by UIs anymore. Instead, set_transport_unpublished() must be called when a user clicks on "Remove"#8408

Merged
Hocuri merged 2 commits into
mainfrom
hoc/deprecate-delete-transport
Jul 9, 2026
Merged

api!: delete_transport() must not be used by UIs anymore. Instead, set_transport_unpublished() must be called when a user clicks on "Remove"#8408
Hocuri merged 2 commits into
mainfrom
hoc/deprecate-delete-transport

Conversation

@Hocuri

@Hocuri Hocuri commented Jul 8, 2026

Copy link
Copy Markdown
Collaborator

Make it clear that from now on, UIs must use set_transport_unpublished() instead of delete_transport().

Companion PR for #8402, related to #8384

I marked this as a breaking change so that it visibly appears in the changelog.

…`set_transport_unpublished()` must be called when a user clicks on "Remove"

I marked this as a breaking change so that it visibly appears in the changelog.
@Hocuri Hocuri requested review from j-g00da, link2xt and r10s July 8, 2026 13:43
@j-g00da

j-g00da commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

I also modified docs in #8402 - maybe we should combine these?

BREAKING CHANGE: UIs should use `list_transports()` rather than `list_transports_ex()`, because unpublished transports count as removed from the user point of view, and should not be shown in the relay list anymore.
@Hocuri Hocuri enabled auto-merge (rebase) July 9, 2026 12:17
@Hocuri

Hocuri commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator Author

@j-g00da you can just rebase #8402 as soon as the PR here is merged - in general, unfortunately we have some of the documentation duplicated, so you need to make sure to update all of the doc comments when updating documentation:

  • The JsonRPC API (mostly in api.rs)
  • The Rust API (in the top-level src folder)
  • deltachat.h for all the functions that exist in the legacy C API (which is not the case for the transport APIs, so that it wasn't necessary to update it here)

I accidentally merged #8409 first so that it got merged into the PR here, but it doesn't matter, I'll rebase-merge now so that the two PRs get merged as two commits into main

@Hocuri Hocuri merged commit 6322758 into main Jul 9, 2026
62 of 74 checks passed
@Hocuri Hocuri deleted the hoc/deprecate-delete-transport branch July 9, 2026 13:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants