List deleted branches
One page of branches created after this update was deployed and then soft-deleted, whether discarded through the delete endpoint (merged_at null) or archived by a merge (merged_at set), newest archive first. A page holds at most 200 rows (pass a smaller limit to take fewer); to continue, pass the cursor of the last row shown as before. search keeps only names containing the text, ignoring case. Every merge archives its branch, so pass merged=false to list only discarded branches, or merged=true only merged ones. Each row is a candidate for the restore preview and the restore endpoint.
Authorizations
Headers
Workspace identifier
Path Parameters
Project UUID, not a slug. Resolve a slug with GET /project/slug/{slug} using the same workspace and credentials, then pass the returned id.
Query Parameters
false lists only discarded branches, true only merged ones; omitted lists both.
A user id: the person who deleted the row; keeps only rows that match it (or, with exclude_deleted_by=true, every other row).
true inverts deleted_by: rows that do not match it, including rows with no value.
ISO 8601 instant; keeps only rows deleted at or after it.
ISO 8601 instant; keeps only rows deleted before it.
A user id: the branch's owner; keeps only rows that match it (or, with exclude_owner=true, every other row).
true inverts owner: rows that do not match it, including rows with no value.
A branch id, or "master" for Base: the branch the row was created from; keeps only rows that match it (or, with exclude_parent=true, every other row).
true inverts parent: rows that do not match it, including rows with no value.
A tag, matched ignoring case; keeps only rows that match it (or, with exclude_tag=true, every other row).
true inverts tag: rows that do not match it, including rows with no value.
ISO 8601 instant; keeps only rows created at or after it.
ISO 8601 instant; keeps only rows created before it.
Case-insensitive substring of the branch name; omitted or blank lists every deleted branch.
The cursor of the last row already shown; returns the page after it. Omit for the first page.
Response
Pass as before to fetch the page after this row. Opaque; valid only as handed out.
When the branch was archived: the merge time for a merged branch, the delete time for a discarded one.
Who deleted a discarded branch. Null for a merged branch: the merge does not record its actor on the row.
Set when a merge archived the branch; null when it was discarded through the delete endpoint.
Project-scoped branch number.
Name of the parent branch; null when the parent is Base.