Flow
Menu

Reference

Remove somebody from a project, or leave it

The remove-project-member tool, and the REST call it is generated from.

RESTDELETE /api/v1/projects/{id}/members/{user}
MCPremove-project-member

Removes a member, and their seats on the project's teams. An admin removes anyone, which is also how an open invitation is cancelled; any member leaves with me. Declining an invitation is decline-invitation. The last admin cannot leave (409 last_admin). Tasks they hold keep their holder; held_tasks counts the open ones left to reassign.

Parameters

  • idpath · required · string

    The project's proj_… id.

  • userpath · required · string

    The member's user_… id, or me for the caller.

Responses

200Who was removed, and what they still hold
401No Flow access token was presented, or it is not valid
403Authenticated, and not allowed — answered only where the caller already knows the resource exists. A project they are not a member of answers 404 instead.
404No such project, or none this caller is a member of
409The last admin cannot leave or be removed

Generated from the spec this operation is implemented against, so the two names above cannot disagree with the surface a client sees.