# Members and roles: questions and answers

Short answers about roles, what each role can do, changing roles, removing
members and the rule that an organization always keeps an owner. Each answer
links to the section of
[Members and roles](../organizations/members-and-roles.md) that owns the
rule.

## The roles

### Which roles are there in Talewright?

Three: `owner`, `admin` and `member`. In the app they read "Owner", "Admin"
and "Member". Every member of an organization has exactly one of them.

More: [Members and roles, Organization roles](../organizations/members-and-roles.md#organization-roles)

### What is the difference between an owner and an admin?

Only owners make someone an owner, change an owner's role, remove an owner,
invite an owner, delete the organization and restore it. Everything else an
owner can do, an admin can do too.

More: [Members and roles, Organization roles](../organizations/members-and-roles.md#organization-roles)

### What is the difference between an admin and a member?

An admin manages the organization, its workspaces, members, invitations and
exports, and reaches every workspace. A member works in the workspaces they
are added to and manages nothing.

More: [Members and roles, Summary](../organizations/members-and-roles.md#summary)

### What can an owner do?

Everything: all an admin can do, plus managing other owners and deleting
and restoring the organization.

More: [Members and roles, Summary](../organizations/members-and-roles.md#summary)

### What can an admin do?

Rename the organization, create, delete and restore workspaces, change
roles and remove admins and members, invite admins and members, start and
download exports, see and revoke every member's API keys and connected
apps, and change statuses, fields and the organization folder. An admin reaches
every workspace.

More: [Members and roles, In the organization](../organizations/members-and-roles.md#in-the-organization)

### What can a member do?

Open the workspaces they were added to, and read, upload, edit, organize,
trash and restore files there. They can read the organization folder, see the
member list and leave. They cannot manage anything.

More: [Members and roles, Who can do what](../organizations/members-and-roles.md#who-can-do-what)

### Can someone have two roles in one organization?

No. Every member has exactly one organization role. They can, in addition,
hold a role in single workspaces.

More: [Members and roles, Organization roles](../organizations/members-and-roles.md#organization-roles)

### Can an organization have more than one owner?

Yes, any number. It must have at least one.

More: [Members and roles, Organization roles](../organizations/members-and-roles.md#organization-roles)

### Can I create custom roles?

No. The roles are owner, admin and member, in the organization and in a
workspace. Their rights are fixed.

More: [Members and roles, Organization roles](../organizations/members-and-roles.md#organization-roles)

### Are there guest users?

No. Everyone who works in an organization is a member of it with one of the
three roles. Someone who is not a member reaches nothing of it, apart from
files shared with a public link.

More: [Members and roles, Organization roles](../organizations/members-and-roles.md#organization-roles)

### Is there a read-only role that can look at files but not change them?

No. The lowest role, member, reads and changes the files of the workspaces
they are added to. Only in the organization folder does a member read without
changing.

More: [Roles and permissions, Workspace files and organization folder files](../reference/permissions.md#workspace-files-and-organization-folder-files)

### How does the app describe the three roles?

- Owner: "Everything an admin can do, plus managing owners and deleting the
  organization."
- Admin: "Manages members, invitations, workspaces and exports, and reaches
  every workspace."
- Member: "Works in the workspaces they are added to."

More: [Members and roles, Organization roles](../organizations/members-and-roles.md#organization-roles)

### When does a change of role take effect?

At once. Roles are checked on every request, so a change also applies to
pages that are already open and to credentials.

More: [Members and roles, Organization roles](../organizations/members-and-roles.md#organization-roles)

### Does an owner have every right an admin has?

Yes. An owner can do everything an admin can, and an admin everything a
member can.

More: [Roles and permissions, Roles](../reference/permissions.md#roles)

## Workspace roles

### What is a workspace role?

A role in one workspace. A plain member gets one when they are added to a
workspace. It can be member, admin or owner, and it counts only there.

More: [Members and roles, Workspace roles](../organizations/members-and-roles.md#workspace-roles)

### What is an effective role?

The role that counts in a workspace: the stronger of the member's
organization role, when it is owner or admin, and their role in that
workspace. Owner is stronger than admin, and admin is stronger than member.

More: [Members and roles, Workspace roles](../organizations/members-and-roles.md#workspace-roles)

### Can a member be an admin of just one workspace?

Yes. Give them the workspace role admin. They then manage that workspace
and its files, but not the organization.

More: [Members and roles, Workspace roles](../organizations/members-and-roles.md#workspace-roles)

### What can a workspace admin do that a workspace member cannot?

Rename the workspace, manage its members, set file statuses, share files
and folders publicly and delete files for good, all in that one workspace.

More: [Members and roles, Workspace roles](../organizations/members-and-roles.md#workspace-roles)

### What can a workspace owner do that a workspace admin cannot?

Give and take away the workspace role owner in that workspace, and remove a
workspace owner's membership.

More: [Members and roles, In a workspace](../organizations/members-and-roles.md#in-a-workspace)

### What can a workspace admin not do?

Create, delete or restore workspaces, invite people or manage the
organization. Those need the organization role owner or admin.

More: [Members and roles, Workspace roles](../organizations/members-and-roles.md#workspace-roles)

### Is an organization owner automatically owner in every workspace?

Yes. An organization owner is owner in every workspace, and an organization
admin is at least admin in every workspace.

More: [Members and roles, Workspace roles](../organizations/members-and-roles.md#workspace-roles)

### Can a plain member be the owner of a workspace?

Yes. A plain member with the workspace role owner manages that workspace
like a workspace admin, and can also give and take away the workspace role
owner there.

More: [Members and roles, Workspace roles](../organizations/members-and-roles.md#workspace-roles)

### Does a workspace role give any rights in other workspaces?

No. It counts only in its own workspace.

More: [Members and roles, Workspace roles](../organizations/members-and-roles.md#workspace-roles)

### An organization admin is also added to a workspace as member. How are they listed there?

Once, with the role admin and `source` `workspace`. The stronger role wins,
and the membership is still recorded.

More: [Members and roles, Edge cases](../organizations/members-and-roles.md#edge-cases)

## What each role may do

### Can an admin delete the organization?

No. Only an owner deletes the organization, and only an owner restores it.

More: [Members and roles, In the organization](../organizations/members-and-roles.md#in-the-organization)

### Can an admin delete a workspace?

Yes, with a verified email address. Admins also list and restore deleted
workspaces.

More: [Members and roles, In the organization](../organizations/members-and-roles.md#in-the-organization)

### Can an admin make someone an owner?

No. Only an owner makes a member an owner. An admin who tries gets
`403 FORBIDDEN` and nothing changes.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### Can an admin remove an owner?

No. Only an owner removes an owner.

More: [Members and roles, Removing members](../organizations/members-and-roles.md#removing-members)

### Can an admin remove another admin?

Yes. An admin removes admins and members.

More: [Members and roles, Removing members](../organizations/members-and-roles.md#removing-members)

### Can an admin change another admin's role?

Yes. An admin sets the roles admin and member, for admins and members. An
admin can make another admin a member.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### Can an admin change an owner's role?

No. Only an owner changes the role of an owner.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### Can an owner remove another owner?

Yes. An owner removes anyone, other owners included, as long as an owner
remains.

More: [Members and roles, Removing members](../organizations/members-and-roles.md#removing-members)

### Can an admin see every member's API keys?

Yes. Owners and admins see and revoke every member's API keys and connected
apps in the organization. They never see a key's secret.

More: [Credentials and scopes, Oversight by owners and admins](../agents/credentials.md#oversight-by-owners-and-admins)

### Can a member see other members' API keys?

No. Only owners and admins see the organization's credentials. A member
sees and manages their own.

More: [Members and roles, In the organization](../organizations/members-and-roles.md#in-the-organization)

### Can a member create an API key?

Yes, for themselves, for the workspaces they reach. Giving the key the
scope `files:approve` needs the role owner or admin in every workspace the
key lists.

More: [Roles and permissions, Credentials and connected apps](../reference/permissions.md#credentials-and-connected-apps)

### Can a member upload and edit files?

Yes, in the workspaces they are added to: upload, edit, organize, trash and
restore.

More: [Members and roles, In a workspace](../organizations/members-and-roles.md#in-a-workspace)

### Can a member set the status of a file?

No. Setting a file's status needs the effective role owner or admin in the
workspace.

More: [Members and roles, In a workspace](../organizations/members-and-roles.md#in-a-workspace)

### Can a member share a file with a public link?

No. Sharing files and folders publicly needs the effective role owner or
admin in the workspace.

More: [Members and roles, In a workspace](../organizations/members-and-roles.md#in-a-workspace)

### Can a member delete files for good?

No. A member can move files to the trash. Deleting for good is for
effective workspace owners and admins.

More: [Members and roles, In a workspace](../organizations/members-and-roles.md#in-a-workspace)

### Can a member change files in the organization folder?

No. Every member reads the organization folder. Only owners and admins of the
organization change it.

More: [Members and roles, In the organization](../organizations/members-and-roles.md#in-the-organization)

### Can an admin change the organization's file statuses and fields?

Yes. Owners and admins change them. Members cannot.

More: [Members and roles, In the organization](../organizations/members-and-roles.md#in-the-organization)

### Can a workspace admin invite people to the organization?

No. Inviting needs the organization role owner or admin. A workspace admin
can add people who are already in the organization to their workspace.

More: [Members and roles, Workspace roles](../organizations/members-and-roles.md#workspace-roles)

### Who in a workspace can approve files?

Everyone whose effective role there is owner or admin. They can set file
statuses in that workspace.

More: [Members and roles, In a workspace](../organizations/members-and-roles.md#in-a-workspace)

### Can a member do anything in a workspace they were not added to?

No. A member reaches only the workspaces they have been added to. For any
other workspace they get `404 NOT_FOUND`.

More: [Members and roles, Organization roles](../organizations/members-and-roles.md#organization-roles)

### Can a member who belongs to no workspace do anything in the organization?

They can see the member list, read the organization folder and leave. They can
open no workspace until an owner or admin adds them to one.

More: [Members and roles, Organization roles](../organizations/members-and-roles.md#organization-roles)

## The member list

### Who can see the member list of an organization?

Every member of the organization.

More: [Members and roles, The member list](../organizations/members-and-roles.md#the-member-list)

### What does the member list show about each person?

Their name, email address, organization role and the date they joined. In
the app the table shows the name and email address under "Name", and the
role under "Role".

More: [Members and roles, The member list](../organizations/members-and-roles.md#the-member-list)

### Can members see each other's email addresses?

Yes, on purpose. Every member can read the member list, and each entry holds
the name and email address of every member, also of people in workspaces
they cannot open. People who must not see each other belong in separate
organizations.

More: [Members and roles, The member list](../organizations/members-and-roles.md#the-member-list)

### In what order are members listed?

In the order they joined, oldest first.

More: [Members and roles, The member list](../organizations/members-and-roles.md#the-member-list)

### Can I search or sort the member list?

No. The list is in the order members joined, and "Load more" shows further
members.

More: [Members and roles, The Members page](../organizations/members-and-roles.md#the-members-page)

### Are pending invitations shown in the member list?

No. Owners and admins see them in their own list, under "Invitations" on
the Members page.

More: [Members and roles, The member list](../organizations/members-and-roles.md#the-member-list)

### Can someone outside the organization read its member list?

No. They get `404 NOT_FOUND`. Outsiders cannot tell the organization
exists.

More: [Members and roles, The member list](../organizations/members-and-roles.md#the-member-list)

### Where is the Members page?

At **Settings > Organization > Members**. Its section "Members" says
"Owners and admins reach every workspace; members reach the workspaces they
are added to."

More: [Members and roles, The Members page](../organizations/members-and-roles.md#the-members-page)

### What does the label "You" mean on the Members page?

It marks your own row.

More: [Members and roles, The Members page](../organizations/members-and-roles.md#the-members-page)

### What does "Load more" do on the Members page?

It shows further members when there is more than one page. A page holds 50
entries by default.

More: [Members and roles, The Members page](../organizations/members-and-roles.md#the-members-page)

### Can I see when a member was last active?

No. A member entry holds the name, the email address, the role and the date
they joined. Owners and admins can see when each API key or connected app
was last used.

More: [Members and roles, The member list](../organizations/members-and-roles.md#the-member-list)

### Can I download the member list?

Not from the app, and the organization export leaves members out. A
credential with `workspace:read` can read the list through the API.

More: [Members and roles, Listing members](../organizations/members-and-roles.md#listing-members)

### How many members can an organization have?

There is no limit.

More: [Members and roles, Limits](../organizations/members-and-roles.md#limits)

### What does a member see on the Members page?

The list of members. A member sees no menus on the rows and no
"Invitations" section.

More: [Members and roles, The Members page](../organizations/members-and-roles.md#the-members-page)

### Why is there no menu button on an owner's row?

You are an admin. An admin sees no menu on an owner's row, because only
owners manage owners.

More: [Members and roles, The Members page](../organizations/members-and-roles.md#the-members-page)

## Changing roles

### How do I change a member's role?

On **Settings > Organization > Members**, open "Manage {name}" on their
row and choose "Owner", "Admin" or "Member" under "Role". The current role
is marked.

More: [Members and roles, Changing a role](../organizations/members-and-roles.md#changing-a-role)

### Who can change roles in an organization?

Owners and admins. Members cannot change anyone's role.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### How do I make someone an owner?

As an owner, open "Manage {name}", choose "Owner" and confirm "Make {name}
an Owner?" with "Make Owner". They get an email about it.

More: [Members and roles, Changing a role](../organizations/members-and-roles.md#changing-a-role)

### How do I transfer ownership of an organization?

Make the other person an owner. Then lower your own role or leave. There is
no separate transfer step.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### Can I change my own role?

Yes, under the same rules as anyone's. An admin can make themselves a
member. An owner can step down when another owner remains.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### Why can I not lower my own role as owner?

You are the only owner. On your row the other roles are disabled, with the
hint "Make another member an owner first."

More: [Members and roles, Changing a role](../organizations/members-and-roles.md#changing-a-role)

### Can I take my role back after giving it up?

No, not by yourself. After giving up owner, another owner must give the
role back. After giving up admin, an owner or admin must.

More: [Members and roles, Changing a role](../organizations/members-and-roles.md#changing-a-role)

### What does "Give up Owner?" ask me?

It confirms that you lower your own role from owner. When you step down to
admin it warns "You can no longer manage owners or delete {organization}.
Another owner must give the role back." Confirm with "Give up Owner".

More: [Members and roles, Changing a role](../organizations/members-and-roles.md#changing-a-role)

### What does "Make {name} an Owner?" warn me about?

"Owners can delete {organization} and change or remove any member,
including you." Confirm with "Make Owner" only if you mean that.

More: [Members and roles, Changing a role](../organizations/members-and-roles.md#changing-a-role)

### Is there a confirmation when I change someone between Admin and Member?

No. Changing someone else between "Admin" and "Member" happens at once.
Changes that involve the owner role, and lowering your own role, ask first.

More: [Members and roles, Changing a role](../organizations/members-and-roles.md#changing-a-role)

### Is a member told when their role changes?

Only when they are made an owner. No other role change sends an email.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### What is the email "You are now an owner of {organization}"?

It is sent to a member whose role was changed to owner. It has a button
"Open organization settings".

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### Can the new-owner email be turned off?

No. It cannot be turned off. New owners are always told.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### Does a role change sign the member out?

No. A role change does not sign anyone out.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### Does a role change revoke the member's API keys or connected apps?

No. Each request made with them is checked against the member's role at
that moment.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### What happens to a key with `files:approve` when its member is made a plain member?

The key still exists, but setting a file status with it is refused. The key
acts with the member's current role on every request.

More: [Members and roles, Edge cases](../organizations/members-and-roles.md#edge-cases)

### What happens to invitations someone sent when their role is lowered?

The pending invitations their new role could not send are deleted, and
their links stop working. An owner made admin loses the owner invitations
they sent. An owner or admin made member loses every invitation they sent.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### I was made an admin. Why do I now see every workspace?

Owners and admins reach every workspace of the organization without being
added to each one.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### I was made a member and lost all workspaces. Why?

As an admin you reached workspaces through your role. As a member you reach
only the workspaces you were added to. An owner or admin can add you.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### Does a role change add or remove workspace memberships?

No. A member with workspace memberships who is made admin and then member
again keeps the workspace memberships they had.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### Why is "Owner" disabled in the role menu?

Roles you cannot give are disabled. For an admin that is "Owner".

More: [Members and roles, Changing a role](../organizations/members-and-roles.md#changing-a-role)

### What happens when the only two owners make each other admin at the same moment?

One change succeeds. The other gets `403 FORBIDDEN`, because its sender is
an admin by then. One owner remains.

More: [Members and roles, Edge cases](../organizations/members-and-roles.md#edge-cases)

### What happens when I set the role a member already has?

It succeeds and changes nothing. No email is sent.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### Why does an admin get `403` for setting an owner to owner, although nothing would change?

Admins never act on an owner, also when nothing would change.

More: [Members and roles, Edge cases](../organizations/members-and-roles.md#edge-cases)

### What does `503 UNAVAILABLE` with reason `EMAIL_UNAVAILABLE` mean when I make someone an owner?

Email cannot be sent right now. The role does not change, because the
change and its email succeed or fail together. Try again later.

More: [Members and roles, Errors](../organizations/members-and-roles.md#errors)

### What does "Could not change the role. Try again." mean?

The role change failed for a reason other than your rights, for example
because the member was removed meanwhile.

More: [Members and roles, Messages when something is refused](../organizations/members-and-roles.md#messages-when-something-is-refused)

### In which order are the checks made when a role is changed?

Sign-in (`401`), the organization (`404`), a valid role (`422`), whether
you are a plain member (`403`), whether the person is a member (`404`),
whether owner is involved and you are not one (`403`), then the last-owner
rule (`409 SOLE_OWNER`). The first that fails decides the answer.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### What does the app show after a role change?

"{name} is now an Admin" (or "a Member", "an Owner"), or "You are now an
Admin" for your own role.

More: [Members and roles, Changing a role](../organizations/members-and-roles.md#changing-a-role)

### Does someone who joins as owner through an invitation get the new-owner email?

No. That email is sent only when an existing member's role is changed to
owner.

More: [Members and roles, Edge cases](../organizations/members-and-roles.md#edge-cases)

### What happens if my role is lowered while I am changing someone else's role?

Your change is refused with `403 FORBIDDEN`. The sender's role is read
again at the moment of the change, not from when the page loaded.

More: [Members and roles, Edge cases](../organizations/members-and-roles.md#edge-cases)

### An admin was made a member and was never added to a workspace. What can they open?

No workspace. They stay in the organization, and home shows "No workspace
yet" until someone adds them to one.

More: [Members and roles, Changing roles](../organizations/members-and-roles.md#changing-roles)

### What does "Make {name} a Member?" warn about?

It appears when you make another owner a member: "{name} can no longer
manage {organization} or reach workspaces they are not added to." Confirm
with "Make Member".

More: [Members and roles, Changing a role](../organizations/members-and-roles.md#changing-a-role)

### Does the member list on my screen update when someone's role changes elsewhere?

It shows the new role after its next refresh. Any action you take meanwhile
is checked against the real roles.

More: [Members and roles, Edge cases](../organizations/members-and-roles.md#edge-cases)

## Removing members

### How do I remove someone from an organization?

On **Settings > Organization > Members**, open "Manage {name}" and choose
"Remove from organization". Confirm "Remove {name}?" with "Remove member".
The app shows "Removed {name}".

More: [Members and roles, Removing a member](../organizations/members-and-roles.md#removing-a-member)

### Who can remove members from an organization?

Owners and admins. An admin removes admins and members. Only an owner
removes an owner.

More: [Members and roles, Removing members](../organizations/members-and-roles.md#removing-members)

### Can I remove myself from an organization?

In the app, "Remove from organization" is not offered on your own row: use
"Leave organization". Through the API, an admin or owner who removes
themselves gets the same result as leaving. A plain member cannot remove
anyone, themselves included.

More: [Members and roles, Removing members](../organizations/members-and-roles.md#removing-members)

### Is the person told when I remove them?

No. The removed person is not asked and gets no email.

More: [Members and roles, Removing members](../organizations/members-and-roles.md#removing-members)

### What happens when a member is removed from an organization?

Their organization membership and every workspace membership in it are
deleted. Their API keys and connected apps for this organization are
revoked, and their pending invitations for it are deleted. Their account,
their sessions and their other organizations are untouched. Their files
stay.

More: [Members and roles, What removal does](../organizations/members-and-roles.md#what-removal-does)

### What happens to someone's files when I remove them?

Nothing. Files and versions they uploaded stay where they are. The history
still shows their name.

More: [Members and roles, What removal does](../organizations/members-and-roles.md#what-removal-does)

### What happens to a removed member's API keys?

Every API key they hold for this organization is revoked. A request with
one answers `401 UNAUTHENTICATED` from then on. Their keys for other
organizations keep working.

More: [Members and roles, What removal does](../organizations/members-and-roles.md#what-removal-does)

### What happens to a removed member's connected apps?

Every connected app they authorized for this organization is revoked. Its
tokens stop working.

More: [Members and roles, What removal does](../organizations/members-and-roles.md#what-removal-does)

### What happens to invitations a removed member had sent?

Their pending invitations for this organization are deleted, and those
links stop working. Invitations sent by other people stay.

More: [Members and roles, What removal does](../organizations/members-and-roles.md#what-removal-does)

### Is a removed member signed out?

No. Nothing happens to their sessions. They stay signed in, but can no
longer open this organization.

More: [Members and roles, What removal does](../organizations/members-and-roles.md#what-removal-does)

### Can a removed member still see the organization's files?

No. Access ends at once, in the app and through every credential.

More: [Members and roles, Removing members](../organizations/members-and-roles.md#removing-members)

### Does removing a member delete their Talewright account?

No. The account is untouched. They can still sign in, create an
organization and accept invitations.

More: [Members and roles, What removal does](../organizations/members-and-roles.md#what-removal-does)

### Does removal affect the person's other organizations?

No. Nothing happens to their memberships, credentials or files in other
organizations.

More: [Members and roles, What removal does](../organizations/members-and-roles.md#what-removal-does)

### I removed the wrong person. How do I undo it?

Invite them again. There is no undo: a removed person comes back only
through a new invitation, which decides their role and workspaces afresh.
Their revoked credentials do not come back; they create new ones.

More: [Members and roles, What removal does](../organizations/members-and-roles.md#what-removal-does)

### Can I suspend a member without removing them?

No. There is no suspended state. You can remove their workspace
memberships, so that a plain member can open no workspace, or remove them
from the organization and invite them again later.

More: [Members and roles, Removing members](../organizations/members-and-roles.md#removing-members)

### What does the removed person see?

If they have a workspace of the organization open, their next action is
refused and the app says "You no longer have access to {workspace}". The
organization leaves their switcher and their list, and its settings pages
show "Not found".

More: [Members and roles, What the removed person sees](../organizations/members-and-roles.md#what-the-removed-person-sees)

### What does the "Remove {name}?" confirmation say?

"They lose access to {organization} and its workspaces at once. Files they
uploaded stay." The buttons are "Remove member" and "Cancel".

More: [Members and roles, Removing a member](../organizations/members-and-roles.md#removing-a-member)

### What does "Could not remove the member. Try again." mean on the Members page?

The removal failed for a reason other than your rights, for example because
someone else already removed them.

More: [Members and roles, Messages when something is refused](../organizations/members-and-roles.md#messages-when-something-is-refused)

### What happens when two admins remove the same member?

The first removal works. The second gets `404 NOT_FOUND`, because the
membership is already gone.

More: [Members and roles, Edge cases](../organizations/members-and-roles.md#edge-cases)

### What happens to a file a member was uploading when they were removed?

It is not added. Access ends at once.

More: [Members and roles, Edge cases](../organizations/members-and-roles.md#edge-cases)

### In which order are the checks made when a member is removed?

Sign-in (`401`), the organization (`404`), whether you are a plain member
(`403`), whether the person is a member (`404`), whether they are an owner
and you are not (`403`), then the last-owner rule (`409 SOLE_OWNER`).
Otherwise they are removed: `204`.

More: [Members and roles, Removing members](../organizations/members-and-roles.md#removing-members)

### What is the difference between removing someone from a workspace and from the organization?

Removing a workspace membership ends access to that one workspace and
leaves everything else. Removing someone from the organization ends all
their access to it and revokes their credentials for it.

More: [Members and roles, What removal does](../organizations/members-and-roles.md#what-removal-does)

### Do public links to a removed member's files keep working?

Yes. Removal changes nothing about the files they uploaded, and a member's
removal is not among the things that stop a public link.

More: [Sharing and public links, What stops a link and what brings it back](../files/sharing.md#what-stops-a-link-and-what-brings-it-back)

### Where does a removed person land in the app?

Home opens another workspace they can still reach. With no organization
left, home is "Set up your organization". With organizations left but no
workspace they can open, home is "No workspace yet".

More: [Members and roles, What the removed person sees](../organizations/members-and-roles.md#what-the-removed-person-sees)

### Is removing a member the same as the member leaving?

The result is the same. Everything that removal does also happens when a
member leaves by themselves.

More: [Members and roles, What removal does](../organizations/members-and-roles.md#what-removal-does)

### A contractor has finished. What is the cleanest way to end their access?

Remove them from the organization. Their access to every workspace ends at
once and their API keys and connected apps for the organization are
revoked. Their files stay.

More: [Members and roles, What removal does](../organizations/members-and-roles.md#what-removal-does)

## The last owner

### What is the last-owner rule?

A live organization always has at least one owner. Any action that would
take the last owner away is refused with `409 SOLE_OWNER`.

More: [Members and roles, The last-owner rule](../organizations/members-and-roles.md#the-last-owner-rule)

### What does `SOLE_OWNER` mean?

The action would leave an organization without an owner. Make another
member an owner, then try again, or delete the organization.

More: [Members and roles, The last-owner rule](../organizations/members-and-roles.md#the-last-owner-rule)

### Which actions does the last-owner rule refuse?

Four: changing the only owner's role to admin or member, removing the only
owner, the only owner leaving, and the only owner deleting their account.

More: [Members and roles, The last-owner rule](../organizations/members-and-roles.md#the-last-owner-rule)

### The only owner has left the company. What can we do?

The person who holds that account must sign in and make another member an
owner. Nobody else can: only an owner makes someone an owner, and the only
owner cannot be removed or lowered. Until then admins keep managing
members, workspaces, invitations and exports.

More: [Members and roles, The last-owner rule](../organizations/members-and-roles.md#the-last-owner-rule)

### What does "{organization} needs another owner first. Make another member an owner, then try again." mean?

The action would leave the organization without an owner. Make another
member an owner first.

More: [Members and roles, Messages when something is refused](../organizations/members-and-roles.md#messages-when-something-is-refused)

### What does `details.organizationIDs` hold in a `SOLE_OWNER` error?

The organization that would be left without an owner. For account deletion
it lists every organization the account alone owns.

More: [Members and roles, The last-owner rule](../organizations/members-and-roles.md#the-last-owner-rule)

### Does the last-owner rule protect a deleted organization?

No. It protects live organizations only. The only owner of a deleted
organization may delete their account; nobody can then restore that
organization.

More: [Members and roles, The last-owner rule](../organizations/members-and-roles.md#the-last-owner-rule)

### Can the only owner of an organization delete their account?

No, not while the organization is live. Account deletion is refused until
another member is an owner or the organization is deleted.

More: [Members and roles, Account deletion and membership](../organizations/members-and-roles.md#account-deletion-and-membership)

### What happens to a member's memberships when they delete their account?

They leave every organization they belong to, with everything that removal
does. Files they uploaded stay.

More: [Members and roles, Account deletion and membership](../organizations/members-and-roles.md#account-deletion-and-membership)

### What does "Deleted user" mean in a file's history?

The person who uploaded or changed the file has deleted their account.
Their name in the history becomes "Deleted user". The files stay.

More: [Members and roles, Account deletion and membership](../organizations/members-and-roles.md#account-deletion-and-membership)

### Is an admin enough to satisfy the last-owner rule?

No. The rule is about the role owner. Other admins and members do not
count.

More: [Deleting an account, The last-owner rule](../accounts/delete-account.md#the-last-owner-rule)

### Does the last-owner rule hold when two owners act at the same moment?

Yes. The two changes are handled one after the other, so one of them finds
the other already done and is refused.

More: [Members and roles, The last-owner rule](../organizations/members-and-roles.md#the-last-owner-rule)

### How many owners does an organization need at least?

One. There is no upper limit.

More: [Members and roles, Limits](../organizations/members-and-roles.md#limits)

### What does "Too many attempts. Try again {when}." mean on the Members page?

A rate limit was reached. Wait until the time shown, then try again.

More: [Members and roles, Messages when something is refused](../organizations/members-and-roles.md#messages-when-something-is-refused)

## The API and agents

### Can an agent change roles or remove members?

No. A credential can read who is in the organization and in a workspace.
Role changes and removals answer a credential with `403 FORBIDDEN` and
`details.reason` `SESSION_REQUIRED`.

More: [Members and roles, For agents](../organizations/members-and-roles.md#for-agents)

### How does an agent list the members of an organization?

With `GET /v1/organizations/{organizationID}/members`, or the MCP tool
`organizations_members_list`:

```sh
curl -s "https://app.usetalewright.com/v1/organizations/01928f3e-7c1a-7d2b-9a41-3f0c2d9e8b17/members" \
  -H "Authorization: Bearer $TALEWRIGHT_API_KEY"
```

More: [Members and roles, Listing members](../organizations/members-and-roles.md#listing-members)

### Which scope does a credential need to list members?

`workspace:read`. Without it the answer is `403 FORBIDDEN` with reason
`INSUFFICIENT_SCOPE`.

More: [Members and roles, For agents](../organizations/members-and-roles.md#for-agents)

### What does a member entry look like in the API?

It has `user` with `id`, `email` and `fullName`, then `role`, `source` and
`joinedAt`. A page of entries comes as `items` with a `nextCursor`.

More: [Members and roles, Listing members](../organizations/members-and-roles.md#listing-members)

### What does `source` mean in a member list?

Where the access comes from. `workspace` is a workspace membership, which
can be removed. `organization` is access through the organization role
owner or admin. In the organization's own list it is always `organization`.

More: [Members and roles, Listing members](../organizations/members-and-roles.md#listing-members)

### What is `joinedAt` in a workspace's member list?

When the workspace membership was made, or when the member joined the
organization if they have none.

More: [Members and roles, Listing members](../organizations/members-and-roles.md#listing-members)

### How does an agent find out who can approve files in a workspace?

It lists the workspace's members. Everyone in the answer whose `role` is
`owner` or `admin` can set file statuses in that workspace.

More: [Members and roles, A worked example](../organizations/members-and-roles.md#a-worked-example)

### What does the API take to change a member's role?

`PATCH /v1/organizations/{organizationID}/members/{userID}` with
`{"role": "owner" | "admin" | "member"}`, from a browser session. It
answers `200` with the member.

More: [Members and roles, Session-only operations](../organizations/members-and-roles.md#session-only-operations)

### Can a credential list the members of any workspace in its organization?

No. A credential reads the member list of its own organization and of the
workspaces it was given. Any other ID answers `404 NOT_FOUND`.

More: [Members and roles, Listing members](../organizations/members-and-roles.md#listing-members)

### What does `422 VALIDATION_FAILED` mean when a role is changed?

`role` is missing or is not `owner`, `admin` or `member`. Unknown roles are
refused.

More: [Members and roles, Errors](../organizations/members-and-roles.md#errors)

### Why do I get `404 NOT_FOUND` when I change or remove a member?

The organization is unknown, deleted or not yours, or the person named is
not a member of it. There is no membership to change or remove.

More: [Members and roles, Errors](../organizations/members-and-roles.md#errors)

### How is the member list paged in the API?

Both list operations take `limit` (1 to 100, default 50) and `cursor`. Pass
the `nextCursor` of one page to get the next.

More: [Members and roles, Listing members](../organizations/members-and-roles.md#listing-members)

### Does an API key ever have more rights than the member it acts for?

No. A credential never has more rights than its member has at the moment of
the request.

More: [Members and roles, Who can do what](../organizations/members-and-roles.md#who-can-do-what)

### Can I see who changed a role or removed a member?

No. Role changes, removals and leaving are recorded in the audit trail, but
there is no page and no API operation that lists the whole trail. The
product shows the activity of single credentials only.

More: [Audit trail, Who can do what](../reference/audit-trail.md#who-can-do-what)

### What does the API answer when a member is removed?

`204`, with no body. `DELETE .../members/{userID}` takes no body either.

More: [Members and roles, Session-only operations](../organizations/members-and-roles.md#session-only-operations)

### What happens to a credential when its member becomes an admin?

It acts with the new role at the next request. Its scopes do not change.

More: [Credentials and scopes, When the member's access changes](../agents/credentials.md#when-the-members-access-changes)

### Why does a plain member get `403` when calling the remove operation on themselves?

Removing is for owners and admins. A member leaves the organization
instead.

More: [Members and roles, Removing members](../organizations/members-and-roles.md#removing-members)

### Is there an MCP tool that changes a role or removes a member?

No. The only MCP tools about people are `organizations_members_list` and
`workspaces_members_list`, and both only read.

More: [Members and roles, For agents](../organizations/members-and-roles.md#for-agents)
