Skip to content
FlagSwiftDocs

Invite and manage members

Bring people in with a link, change what they can do, reset a password and hand over ownership when you need to.

Time
About 12 min
Who can do it
Admins (members.invite, members.update, members.remove)
Where
Members, in the console
You finish with
People in the organization with the right role

What and why#

People join a FlagSwift organization by invitation. An invitation is a single-use link for one email address and one role: nobody can sign up into your organization on their own, and the link carries the role the person will hold when they arrive. Once they are in, you keep control of their access from the same page.

Two ways in#

Every invitation comes with a link and a one-time password. The person can open the link and choose their own password, or sign in with their email and the one-time password. Both routes accept the invitation. The link is the better route because it lets them choose a password straight away; the one-time password is a fallback for when a link cannot be delivered.

What you can manage afterwards#

Change a role, remove someone, reset a password and transfer ownership. A few rules keep the organization from locking itself out; they are listed under the steps.

Before you start#

  • Inviting takes the members.invite permission, changing roles and resetting passwords take members.update, and removing takes members.remove. Admins hold all three.
  • Decide the role first. Only the owner can invite someone as an admin. If you need a role that does not exist yet, see Create a custom role.
  • Your server must have an email provider (RESEND_API_KEY with MAIL_FROM, or SMTP_HOST with the related SMTP_* settings). If a send fails, for example because the sender is not verified, the invitation is still created and the dialog shows the reason so you can pass the link on yourself.
  • The person must not already belong to an organization. One email address can belong to one organization.

Walk through it#

  1. Invite one person

    Open Members and choose Invite member.

    Invite member
    FieldRuleDescription
    Full nameRequired, up to 80 charactersShown on the Members tab. The person can change it when they accept.
    Work emailRequired, a valid addressStored in lower case. Used as their username.
    RoleRequiredBuilt-in or custom. The picker only offers roles you may hand out.

    Send it. The confirmation, titled Invitation ready, shows the invitation link, the email as a username and a one-time password. The link works once and expires after 7 days. It is shown only now, because only a hash is stored. If your server has SMTP configured the link is emailed too, and the dialog says whether that worked. Otherwise use Copy everything as a message and send the details privately.

    The Invite member dialog. The Role list shows only roles you may hand out, each with a one-line description.
    You should see. The invitation appears under Pending invitations with the role and an expiry date. If you invite an address that already has an open invitation, the new one replaces it and only the newest link works.
  2. Invite a team at once

    Choose Bulk invite. Paste addresses one per line, as email, as Name <email> or as email, Name, up to 50 at a time. People pasted without a name are named from their email, so jane.doe@example.com becomes Jane Doe. Repeated addresses are dropped and lines without an email are flagged before you send. Pick one role for everyone. Each address succeeds or fails on its own, and the results list shows which, with a copy button for each person.

  3. What the person does

    They open the link, which shows the organization name, the role and who invited them. A new person chooses a password. Someone whose account has no organization yet confirms with the password they already have. A new password needs at least 6 characters, including a number, a symbol, and upper and lower case letters, and at most 72 bytes; the form shows a checklist as they type. Accepting signs them in and ends any other session they had.

  4. Manage pending invitations

    The Pending invitations tab lists invitations that are pending or expired, newest first. Accepted and revoked ones leave the list. Use Create new link if one was lost or expired: you confirm first, and it replaces the old link and password and starts a fresh 7 days. Use Revoke invitation to stop its link and password working.

    Pending invitations. An expired one offers Renew link instead of New link.
    Create new link asks first, because the old link stops working. The button is the brand colour: nothing is lost that you cannot recreate. The dialog is locked while the link is made.
    Revoke invitation. The person can be invited again at any time.
  5. Change a role or remove someone

    On the Members tab, change a person's role from the role menu on their row, or use the remove button. A row only offers roles you are allowed to hand out. Picking a role opens a confirmation, and nothing changes until you confirm; demoting an admin warns that their admin access ends straight away. Removing also asks you to confirm. Removed people lose access at once and are detached from the organization. Their past changes stay in the audit log. You cannot remove yourself.

    The Members tab. The owner badge is green and each role has its own colour: admin blue, release manager amber, developer orange, viewer grey. Your own row, and rows you may not change, show a plain role badge instead of the role menu.
    Changing a role asks you to confirm. Demoting an admin turns the button red and says their administrator access ends straight away.
    Removing a member, and the same dialog while the request runs. It cannot be closed until it finishes.
    You should see. The row shows the new role. The audit log has member.role_changed or member.removed.
  6. Reset a password

    The key button on a row opens Reset password. Confirm and it generates a new password and shows it once for you to pass on. The old password stops working and the person is signed out everywhere. You reset your own password from your account instead, with Change password.

  7. Transfer ownership

    The owner can choose Make owner on an admin's row. You stay an admin. Only the new owner can then appoint or remove admins, transfer ownership again, or deactivate the organization. Ownership can only go to an existing admin, so make the person an admin first.

Rules that protect the organization

Nobody can change their own role, and the owner cannot be changed or removed until ownership moves. The last admin cannot be demoted or removed. Only the owner can make or change an admin, or reset an admin's password. Ownership can only go to an admin.

Do it with the API

The Dashboard API takes a session cookie, not an API key. The link and password are in this response only, and the response is marked no-store. POST /api/invitations/bulk takes { role, invitees: [{ name, email }] }, up to 50. Reissue with POST /api/invitations/{id}/reissue, revoke with DELETE /api/invitations/{id}, remove a member with DELETE /api/members/{id}, reset a password with POST /api/members/{id}/reset-password and transfer ownership with POST /api/members/{id}/transfer-ownership. Details are in the Members and invitations API.

Request
# Sign in first (POST /api/auth/login with -c jar.txt). Invitations need members.invite.
curl -s -b jar.txt -X POST https://flags.example.com/api/invitations \
  -H "Content-Type: application/json" \
  -d '{"name":"Ada Obi","email":"ada@example.com","role":"developer"}'
Response
{
  "status": "success",
  "message": "Invitation created",
  "data": {
    "invitation": {
      "id": "inv_123",
      "name": "Ada Obi",
      "email": "ada@example.com",
      "role": "developer",
      "roleLabel": "Developer",
      "customRoleId": null,
      "status": "pending",
      "invitedByEmail": "you@example.com",
      "createdAt": "2026-10-03T09:30:00.000Z",
      "expiresAt": "2026-10-10T09:30:00.000Z"
    },
    "inviteUrl": "https://flags.example.com/invite/TOKEN",
    "temporaryPassword": "shown-once",
    "emailed": false
  }
}

Good to know#

Send the link, not just the password

Pass on the link when you can. A person who joins with the link chooses their own password. A person who signs in with the one-time password keeps that shared password until they change it, so treat it like a secret and send it by a different channel than the email.

Not built yet

There is no single sign-on, SCIM provisioning or multi-factor sign-in.
Can I see an invitation link again?
No. Only a hash is stored. Choose Create new link on the Pending invitations tab to get a new link and password.
What if the email never arrives?
The dialog says whether the email was sent. Without an email provider, or if the send failed, copy the details and pass them on yourself. A failed email never stops the invitation being created.
Can I invite someone who is already in another organization?
Not today. An address that already belongs to an organization is refused. The person needs an account with no organization to accept.
Does removing a member delete their work?
No. Flags and history stay. The person loses access and their past changes remain in the audit log.
Who can reset an admin's password?
Only the owner. You reset your own password from your account.

If something goes wrong#

This invitation link is invalid, expired or has already been used

Why: The link is older than 7 days, was revoked, was replaced by a newer link, or was already accepted. The message is the same for all of them on purpose.

Fix: Open Pending invitations and choose Create new link, then send the new details.

This person is already a member, or This email already belongs to another organization

Why: The address has an account with an organization already.

Fix: Use a different address, or ask the person to leave the other organization first.

Only the owner can make someone an administrator

Why: Admin is a role that only the owner can hand out or change.

Fix: Ask the owner, or have them transfer ownership to you.

This is the last administrator. Make someone else an administrator first

Why: You tried to demote or remove the only admin.

Fix: Promote another person to Admin first.

The Invite member button is missing

Why: Only people with members.invite see it. Without it the page ends with Only administrators can invite people or change roles.

Fix: Ask an Admin.

A row has a role badge but no role menu

Why: It is your own row, or the owner and admin rules lock it for you (for example an Admin row when you are not the owner). Hover the badge for the reason.

Fix: Ask the owner to make the change.

The invitation dialog says the email could not be sent

Why: An email provider is configured but the send failed, so the message gives the reason.

Fix: Copy the link and password and pass them on yourself, then ask your operator to check the email settings (Resend or SMTP).

What to check#

  • The person opens the link and creates an account with a password they choose. They then show on the Members tab with the right role.
  • Your invitation leaves Pending invitations once accepted.
  • The audit log has member.invited and member.joined.