GuidesAPI ReferenceChangelog
API Reference

Moves a Membership

post
https://api.factorialhr.com/api/2026-10-01/resources/teams/memberships/move

Move a membership to a different team in one operation (the employee is removed from the current team and added to the destination). Requires the nested teams feature and permission to manage both teams. Only direct memberships can be moved — moving an inherited row is rejected.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

ID of the membership to move (must be a direct membership)

string
required

ID of the destination team

boolean

Whether the employee should be a lead in the destination team. Omit it to keep the membership's current lead flag; pass false to move the employee and drop their leadership. Worth being explicit when restructuring: omitting it carries leadership across, so a lead of a small team who lands in a large one leads the large one.

Response

Updated 4 days ago

Did this page help you?
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 days ago

Did this page help you?