Update join organization invitation
PreviewPATCH/user/v1/flows/{flowId}:updateJoinOrganization
Update a join organization flow.
path parameters
The identifier of the flow.
body parameters
The identifier of the role.
Returns
The system-assigned identifier of the flow.
The current state of the flow.
Possible values:START_PENDINGSTARTEDCOMPLETEDCANCELEDEXPIRED
The code that best describes the reason for the state.
Possible values:JOIN_ORGANIZATIONSIGNUP
The target organization for the flow.
The system-assigned identifier of the organization.
The client defined unique identifier of the organization account.
The human-readable display name of the organization.
The email address of the organization.
Whether the organization's email address has been verified.
The photo/avatar URL of the organization.
The number of members in the organization.
This includes disabled users, but does not include user's marked for deletion.
Whether the organization is disabled.
The target user for the flow.
The system-assigned identifier of the user.
The client defined unique identifier of the user account.
The human-readable display name of the user.
The email address of the user.
Whether the user's email address has been verified.
The photo/avatar URL of the user.
Whether the user is disabled.
The user who created the flow.
The system-assigned identifier of the user.
The client defined unique identifier of the user account.
The human-readable display name of the user.
The email address of the user.
Whether the user's email address has been verified.
The photo/avatar URL of the user.
Whether the user is disabled.
joinOrganization
JoinOrganizationFlow
The join organization flow type specific data.
The display name of the invitee.
The email address of the invitee.
This is required if a user isn't provided or the user's email address is empty.
The role to be assigned to the invitee.
The system-assigned identifier of the role.
The client defined unique identifier of the role.
It is restricted to letters, numbers, underscores, and hyphens, with the first character a letter or a number, and a 255 character maximum.
ID's starting with role_ are reserved.
The human-readable display name of the role.
Possible values:OWNERMEMBERGUEST
The description of the role.
The maximum length is 1000 characters.
The policy that defines how a member is assigned a seat.
Possible values:DEFAULTMANUAL
The additional permissions allowed by the role.
Whether the role is the default for the tenant.
The signup flow type specific data.
The email address of the invitee.
The display name of the invitee.
createOrganization
boolean
Whether to create an organization as part of the signup flow.
The time the flow will expire.
The creation time of the flow.
The system-assigned identifier of the flow.
The current state of the flow.
Possible values:START_PENDINGSTARTEDCOMPLETEDCANCELEDEXPIRED
The code that best describes the reason for the state.
Possible values:JOIN_ORGANIZATIONSIGNUP
The target organization for the flow.
The system-assigned identifier of the organization.
The client defined unique identifier of the organization account.
The human-readable display name of the organization.
The email address of the organization.
Whether the organization's email address has been verified.
The photo/avatar URL of the organization.
The number of members in the organization.
This includes disabled users, but does not include user's marked for deletion.
Whether the organization is disabled.
The target user for the flow.
The system-assigned identifier of the user.
The client defined unique identifier of the user account.
The human-readable display name of the user.
The email address of the user.
Whether the user's email address has been verified.
The photo/avatar URL of the user.
Whether the user is disabled.
The user who created the flow.
The system-assigned identifier of the user.
The client defined unique identifier of the user account.
The human-readable display name of the user.
The email address of the user.
Whether the user's email address has been verified.
The photo/avatar URL of the user.
Whether the user is disabled.
joinOrganization
JoinOrganizationFlow
The join organization flow type specific data.
The display name of the invitee.
The email address of the invitee.
This is required if a user isn't provided or the user's email address is empty.
The role to be assigned to the invitee.
The system-assigned identifier of the role.
The client defined unique identifier of the role.
It is restricted to letters, numbers, underscores, and hyphens, with the first character a letter or a number, and a 255 character maximum.
ID's starting with role_ are reserved.
The human-readable display name of the role.
Possible values:OWNERMEMBERGUEST
The description of the role.
The maximum length is 1000 characters.
The policy that defines how a member is assigned a seat.
Possible values:DEFAULTMANUAL
The additional permissions allowed by the role.
Whether the role is the default for the tenant.
The signup flow type specific data.
The email address of the invitee.
The display name of the invitee.
createOrganization
boolean
Whether to create an organization as part of the signup flow.
The time the flow will expire.
The creation time of the flow.
curl https://api.userhub.com/user/v1/flows/string:updateJoinOrganization \
-H "UserHub-Api-Key: $USERHUB_USER_KEY" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-X PATCH \
--json '{
"roleId": "role_51jav4KK"
}'
const res = await userApi.flows.updateJoinOrganization(
"string",
{
roleId: "role_51jav4KK",
},
);
res, err := userApi.Flows().UpdateJoinOrganization(
context.Background(),
"string",
&userapi.FlowUpdateJoinOrganizationInput{
RoleId: userapi.Some[string]("role_51jav4KK"),
},
)
$res = $userApi->flows->updateJoinOrganization(
flowId: 'string',
roleId: 'role_51jav4KK',
);
res = user_api.flows.update_join_organization(
flow_id="string",
role_id="role_51jav4KK",
)
Response bodyJSON
{
"id": "flow_3on5rHNG5aMGao",
"state": "START_PENDING",
"type": "JOIN_ORGANIZATION",
"organization": {
"id": "org_28seyVGVL1got6",
"displayName": "Acme Inc",
"email": "[email protected]",
"emailVerified": true,
"imageUrl": "https://example.com/acme.jpg",
"memberCount": 0
},
"creator": {
"id": "usr_EHTXpuz9rs8TCU",
"displayName": "Jane Doe",
"email": "[email protected]",
"emailVerified": true,
"imageUrl": "https://example.com/jane.jpg"
},
"joinOrganization": {
"email": "[email protected]",
"role": {
"id": "role_51jav4KK",
"uniqueId": "admin",
"displayName": "Admin",
"type": "MEMBER",
"seatPolicy": "DEFAULT",
"permissionSets": [
"billing.readonly",
"members.readwrite"
],
"default": false
}
},
"expireTime": "2025-06-15T13:00:00Z",
"createTime": "2025-05-15T13:00:00Z"
}