Skip to content

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.

id
required
string format: uuid

The team’s id.

parent_id
required
string format: uuid

The parent’s id.

The link was removed.

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed