Remove a parent from a team
DELETE /teams/{id}/parents/{parent_id}
Removes the direct link between a team and one of its parents.
You need to be signed in with teams.admin or system.admin
granted globally; a grant within a team isn’t enough, and neither is
being a member. An id or parent_id that isn’t a UUID gets a
plain-text 400 before sign-in is checked.
Neither team is looked up: the link is matched exactly, and when there’s none, including on a second request, the answer is 404. A link involving a deleted team can still be removed.
Ancestry is then worked out again for every team. A team still below a former ancestor through another parent keeps it, and grants given within that ancestor still reach the team. Grants that reached the team only through this link stop applying, but an account that’s already signed in may keep its earlier reach until the server reloads its permissions. Memberships and grants given within the team itself aren’t touched.
Parent changes are applied one at a time, so of two identical removals one gets 204 and the other 404. The team’s cached copy is cleared. Nobody is notified, and no audit entry is recorded. Server errors get a plain-text 500.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The team’s id.
The parent’s id.
Responses
Section titled “ Responses ”The link was removed.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completedResource not found
object
Human-readable error summary
Example
the request could not be completed