# Organizations: questions and answers

Short answers about organizations: creating one, its name and ID, belonging
to several, switching, leaving and the settings pages. Each answer links to
the section of [Organizations](../organizations/organizations.md) that owns
the rule.

## The basics

### What is an organization in Talewright?

An organization is your team's account in Talewright. It holds the members
and their roles, the workspaces, the shared files organization folder, the
invitations and the exports. Each workspace and the organization folder have
their own file statuses, fields and tags.

More: [Organizations, Summary](../organizations/organizations.md#summary)

### What is the difference between an organization and a workspace?

The organization is the team: its members, roles, organization folder and
settings. A workspace is one brand, client or business inside it, with its
own files and its own members.

More: [Organizations, Summary](../organizations/organizations.md#summary)

### Do I need an organization to use Talewright?

Yes. Files live in workspaces, and workspaces live in organizations. A new
account creates one on "Set up your organization" or joins one through an
invitation.

More: [Organizations, Your first organization](../organizations/organizations.md#your-first-organization)

### Does every file belong to an organization?

Yes. Every file belongs to exactly one organization, either in one of its
workspaces or in its organization folder.

More: [Organizations, Summary](../organizations/organizations.md#summary)

### Does an organization always have a workspace?

Yes. An organization always has at least one live workspace. The first one
is created together with the organization.

More: [Organizations, Creating](../organizations/organizations.md#creating)

### Is an organization the same thing as my account?

No. Your account is you: one person with an email address and a password. An
organization is a team that accounts belong to. One account can create and
belong to any number of organizations.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

### How does an account become part of an organization?

In one of two ways: by creating the organization, or by accepting an
invitation to it. There is no other way in.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

## Creating an organization

### How do I create an organization?

Choose "Create organization", enter the organization's name and the name of
its first workspace, and confirm with "Create organization". A new account
without any organization does this on the page "Set up your organization".

More: [Organizations, Creating another organization](../organizations/organizations.md#creating-another-organization)

### Who can create an organization?

Any signed-in account. No role is needed, because you are not acting inside
an existing organization.

More: [Organizations, Creating](../organizations/organizations.md#creating)

### How many organizations can I create?

As many as you like. There is no limit on how many organizations one account
creates or belongs to.

More: [Organizations, Limits](../organizations/organizations.md#limits)

### Do I need a verified email address to create an organization?

No. Creating an organization works with an unverified email. A verified
email is needed only for deleting things.

More: [Organizations, Who can do what](../organizations/organizations.md#who-can-do-what)

### What do I have to fill in to create an organization?

Two names: the organization's name and the name of its first workspace. Both
are required. Nothing else is asked.

More: [Organizations, Creating](../organizations/organizations.md#creating)

### Why does creating an organization ask for a workspace name?

Because an organization always has at least one workspace. The organization
and its first workspace are created together, so the first workspace needs a
name at that moment.

More: [Organizations, Creating](../organizations/organizations.md#creating)

### Can I create an organization without a workspace?

No. The first workspace is created with the organization. If either name is
refused, nothing is created.

More: [Organizations, Creating](../organizations/organizations.md#creating)

### What role do I get in an organization I create?

Owner. The account that creates an organization becomes its owner and, at
that moment, its only member.

More: [Organizations, Creating](../organizations/organizations.md#creating)

### Am I added to the first workspace as a workspace member?

No. You reach the first workspace through your owner role. No separate
workspace membership is made for the creator.

More: [Organizations, Creating](../organizations/organizations.md#creating)

### What does a new organization start with?

One workspace, one owner and an empty organization folder. The workspace and the
organization folder each start with three file statuses.
It has no other members until you invite them.

More: [Organizations, Creating](../organizations/organizations.md#creating)

### Is an email sent when I create an organization?

No. No email is sent to anyone when an organization is created.

More: [Organizations, Creating](../organizations/organizations.md#creating)

### Where is "Create organization" in the app?

In four places: the workspace switcher at the top of the sidebar, the
organization picker in the settings navigation, the "Organizations" settings
page, and the command palette.

More: [Organizations, Creating another organization](../organizations/organizations.md#creating-another-organization)

### What happens right after I create an organization?

The app shows "{name} created" and opens Files & Assets of the new
workspace. You can start uploading at once.

More: [Organizations, Your first organization](../organizations/organizations.md#your-first-organization)

### What is the "Set up your organization" page?

It is where a signed-in account without any organization lands. It has the
fields "Organization name" and "First workspace name", the button "Create
organization" and "Sign out".

More: [Organizations, Your first organization](../organizations/organizations.md#your-first-organization)

### Why does "First workspace name" fill itself in while I type?

"First workspace name" follows what you type in "Organization name" until
you type in it yourself. From then on it keeps its own text.

More: [Organizations, Your first organization](../organizations/organizations.md#your-first-organization)

### What happens if I double-click "Create organization"?

One organization is created, not two. The app sends one request at a time
for this form.

More: [Organizations, Creating another organization](../organizations/organizations.md#creating-another-organization)

### What if the workspace name is refused while the organization name is fine?

Nothing is created. The API answers `422 VALIDATION_FAILED` on
`workspaceName`, and no organization is left behind.

More: [Organizations, Creating](../organizations/organizations.md#creating)

### Why does "Set up your organization" mention an organization that was deleted?

Because you own a deleted organization that can still be restored. The page
says "{name} was deleted." with a link "Restore {name}" and the date until
which that works. You can restore it or create a new one.

More: [Organizations, Your first organization](../organizations/organizations.md#your-first-organization)

### Why did the app open an invitation and not "Set up your organization"?

You opened an invitation link in this browser before. The app opens that
invitation first, so you can join the organization that invited you.

More: [Invitations, A kept invitation comes first](../organizations/invitations.md#a-kept-invitation-comes-first)

### What does the "Create organization" dialog tell me?

"You become its owner. Its first workspace keeps your team's files; you can
add more later." You will own the new organization, and more workspaces can
be added after the first.

More: [Organizations, Creating another organization](../organizations/organizations.md#creating-another-organization)

## Names

### How long can an organization name be?

1 to 200 characters, counted after spaces at the start and end are removed.

More: [Organizations, Naming rules](../organizations/organizations.md#naming-rules)

### Which characters can an organization name contain?

Anything except control characters such as tabs and line breaks. Letters of
any script, digits, punctuation, spaces inside the name, accents and emoji
are allowed.

More: [Organizations, Naming rules](../organizations/organizations.md#naming-rules)

### Can an organization name contain emoji or non-Latin letters?

Yes. Accents, non-Latin scripts and emoji are all allowed.

More: [Organizations, Naming rules](../organizations/organizations.md#naming-rules)

### Can two organizations have the same name?

Yes. Organization names are not unique, also for the same account. Both
exist, and the organization ID tells them apart.

More: [Organizations, Naming rules](../organizations/organizations.md#naming-rules)

### Why do I see "Enter a name, up to 200 characters."?

The name is empty or longer than 200 characters. The message appears under
the field that is wrong, "Organization name" or "First workspace name".

More: [Organizations, Creating another organization](../organizations/organizations.md#creating-another-organization)

### Are spaces at the start or end of an organization name kept?

No. They are removed before the name is measured and stored.

More: [Organizations, Naming rules](../organizations/organizations.md#naming-rules)

### Can an organization name contain a tab or a line break?

No. Tabs and line breaks are control characters and are refused. They are
refused even at the very end of the name, where trimming would otherwise
remove them.

More: [Organizations, Naming rules](../organizations/organizations.md#naming-rules)

### Is the 200-character limit of a name counted in characters or bytes?

In characters. An accented letter or a non-Latin letter counts as one.

More: [Organizations, Naming rules](../organizations/organizations.md#naming-rules)

### Can an organization name consist only of spaces?

No. A name that is empty after trimming is refused with
`422 VALIDATION_FAILED` on `name`.

More: [Organizations, Naming rules](../organizations/organizations.md#naming-rules)

### What does `422 VALIDATION_FAILED` on `name` mean for an organization?

The name is empty after trimming, longer than 200 characters or holds a
control character. `details.field` names the field. Correct it and send the
request again.

More: [Organizations, Errors](../organizations/organizations.md#errors)

### Is a 201-character organization name cut to 200 characters?

No. It is refused with `422 VALIDATION_FAILED` on `name`. Nothing is
shortened for you.

More: [Organizations, Naming rules](../organizations/organizations.md#naming-rules)

## Renaming

### How do I rename an organization?

Open **Settings > Organization > General**, change "Organization name" and
choose "Save". The app then shows "Organization renamed".

More: [Organizations, The General page](../organizations/organizations.md#the-general-page)

### Who can rename an organization?

Owners and admins. Members cannot.

More: [Organizations, Renaming](../organizations/organizations.md#renaming)

### Can a member rename the organization?

No. A member who tries gets `403 FORBIDDEN` and the name does not change. In
the app a member sees the name without a field.

More: [Organizations, Renaming](../organizations/organizations.md#renaming)

### Does renaming an organization break links, API calls or API keys?

No. A rename does not change the organization ID, the workspaces, the
members or any file. Links, API calls and credentials use the ID.

More: [Organizations, Renaming](../organizations/organizations.md#renaming)

### Why is "Save" disabled next to the organization name?

"Save" is disabled until the name differs from the current one. Type a
different name to enable it.

More: [Organizations, The General page](../organizations/organizations.md#the-general-page)

### What happens when two admins rename the organization at the same moment?

Both renames succeed. The one that finishes last is the name that stays.

More: [Organizations, Renaming](../organizations/organizations.md#renaming)

### Do emails that were already sent show the new organization name?

No. Emails already sent keep the name the organization had when they were
sent.

More: [Organizations, Renaming](../organizations/organizations.md#renaming)

### Can I rename an organization that was deleted?

No. A deleted organization cannot be renamed. Restore it first.

More: [Organizations, Renaming](../organizations/organizations.md#renaming)

### Can an admin who belongs to no workspace rename the organization?

Yes. Admins manage the organization through their organization role, not
through a workspace.

More: [Organizations, Edge cases](../organizations/organizations.md#edge-cases)

### What does "Only owners and admins can rename the organization." mean?

You are a member of this organization. Members see the name on the General
page with this line in place of the field.

More: [Organizations, The General page](../organizations/organizations.md#the-general-page)

### How soon do other members see a new organization name?

At once. A rename takes effect for every member, in every list and page.

More: [Organizations, Renaming](../organizations/organizations.md#renaming)

### What happens if I rename the organization to the name it already has?

It succeeds and changes nothing visible.

More: [Organizations, Renaming](../organizations/organizations.md#renaming)

### Is anyone told when an organization is renamed?

No. No email is sent for a rename.

More: [Organizations, Questions and answers](../organizations/organizations.md#questions-and-answers)

## The organization ID

### What is the organization ID?

A UUID that identifies the organization, for example
`01928f3e-7c1a-7d2b-9a41-3f0c2d9e8b17`. It is in the address of the
settings pages and in every API call about the organization.

More: [Organizations, The organization ID](../organizations/organizations.md#the-organization-id)

### Where do I find my organization ID?

On **Settings > Organization > General**, in the section "Organization ID",
with a "Copy" button. An agent finds it with `GET /v1/workspaces`.

More: [Organizations, The General page](../organizations/organizations.md#the-general-page)

### Is the organization ID a secret?

No. Knowing it gives no access. Someone who is not a member gets
`404 NOT_FOUND` for it, exactly as for an ID that does not exist.

More: [Organizations, The organization ID](../organizations/organizations.md#the-organization-id)

### Does the organization ID ever change?

No. It is assigned when the organization is created and does not change
when the organization is renamed, deleted or restored.

More: [Organizations, The organization ID](../organizations/organizations.md#the-organization-id)

### Who can see the organization ID?

Every member, whatever their role.

More: [Organizations, The organization ID](../organizations/organizations.md#the-organization-id)

### What does "Copy failed" mean next to the organization ID?

The browser refused to copy to the clipboard. After a successful copy the
button reads "Copied" for a moment. Select the ID and copy it by hand.

More: [Organizations, The General page](../organizations/organizations.md#the-general-page)

### Can I choose my own organization ID?

No. The ID is assigned when the organization is created.

More: [Organizations, The organization ID](../organizations/organizations.md#the-organization-id)

### Can I set a custom address or short name for my organization?

No. An organization is identified by its ID in the address of its settings
pages and in the API. Its name is for people and is not part of any address.

More: [Organizations, The organization ID](../organizations/organizations.md#the-organization-id)

## Several organizations and switching

### Can I belong to more than one organization?

Yes, to as many as you like. Each membership is separate.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

### Can I have a different role in each organization?

Yes. Your role in one organization says nothing about your role in another.
You can be owner in one and member in another.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

### How do I switch organizations?

Choose a workspace of the other organization in the workspace switcher at
the top of the sidebar. In settings, use the organization picker at the top
of the "Organization" group.

More: [Organizations, Switching](../organizations/organizations.md#switching)

### In what order are my organizations listed?

In the order you joined them, oldest first.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

### What does the "Workspaces" column on the Organizations page count?

The workspaces of that organization that you can open, for example "2
workspaces". It is not the total number of workspaces the organization has.

More: [Organizations, The organizations list](../organizations/organizations.md#the-organizations-list)

### Does the app remember which workspace I used last?

Yes. The workspace you last used is remembered in your browser, and opening
the app takes you there.

More: [Organizations, Switching](../organizations/organizations.md#switching)

### Does the remembered workspace give me access to it?

No. It is a convenience only. If you can no longer open it, the app opens
another workspace you can.

More: [Organizations, Switching](../organizations/organizations.md#switching)

### Can I see organizations I do not belong to?

No. You see only organizations you belong to. Other organizations do not
exist as far as your account can tell.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

### Can files or members be shared between two organizations?

No. Files, members, invitations, statuses, fields and exports never cross
from one organization to another.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

### What does "No organizations yet." mean?

Your account belongs to no organization. The message is on **Settings >
Organizations**. Create one, or accept an invitation.

More: [Organizations, The organizations list](../organizations/organizations.md#the-organizations-list)

### What does "No workspace yet" mean?

You belong to at least one organization but can open no workspace anywhere.
The page says "An owner or admin of {names} needs to add you to one of its
workspaces." and offers "Create organization".

More: [Organizations, Edge cases](../organizations/organizations.md#edge-cases)

### Why does an organization show "0 workspaces" in my list?

You are a member of the organization but of none of its workspaces. Members
reach only the workspaces they are added to. An owner or admin can add you.

More: [Organizations, Edge cases](../organizations/organizations.md#edge-cases)

### What does the organization picker in the settings navigation do?

It names the organization whose settings are shown and switches the
settings pages to another organization. It opens the same page for the
other organization when that page exists for you, and its General page
otherwise.

More: [Organizations, Organization settings](../organizations/organizations.md#organization-settings)

### Do I have to switch organizations before calling the API?

No. Nothing is "switched" on the server. Every request names the workspace
or organization it is about.

More: [Organizations, Switching](../organizations/organizations.md#switching)

### What does each row of the Organizations page show?

The organization's name, how many of its workspaces you can open, and your
role. The columns are "Name", "Workspaces" and "Role". A name opens that
organization's General page.

More: [Organizations, The organizations list](../organizations/organizations.md#the-organizations-list)

### What does "Show more" do on the Organizations page?

It loads further organizations when you have more than one page of them.

More: [Organizations, The organizations list](../organizations/organizations.md#the-organizations-list)

## Agencies and several brands

### Should an agency use one organization or one per client?

Both work, and the difference is what is shared. One organization with a
workspace per client has one member list and one organization folder, and each
workspace has its own file statuses, fields and tags. Separate
organizations share nothing: files, members, invitations, statuses, fields
and exports never cross from one to another.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

### Can I keep each client or brand in its own workspace?

Yes. A workspace is one brand, client or business inside the organization,
with its own files and its own members.

More: [Workspaces, Summary](../organizations/workspaces.md#summary)

### If two clients are members of one organization, what can they see of each other?

Not each other's workspace files, as long as each is a plain member added
only to their own workspace. They do share what belongs to the whole
organization: every member can read the member list, with names, email
addresses and roles, and can read the organization folder. Use separate
organizations when even that must stay apart.

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

### Can one person work for two organizations with a single account?

Yes. One account can belong to any number of organizations, each with its
own role.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

### Can I merge two organizations into one?

No. There is no merge. Files, members and settings never cross from one
organization to another, and a workspace cannot be moved to another
organization.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

### Can I split one organization into two?

No. A workspace belongs to exactly one organization and cannot be moved to
another. A second organization starts empty.

More: [Workspaces, What a workspace holds](../organizations/workspaces.md#what-a-workspace-holds)

### Can an organization have sub-organizations?

No. The structure has two levels: an organization and its workspaces. Use
workspaces for the brands, clients or businesses inside one organization.

More: [Organizations, Summary](../organizations/organizations.md#summary)

### Do my organizations share one organization folder?

No. Each organization has its own organization folder. It is shared by the
workspaces of that organization only.

More: [The organization folder and suggestions, The organization folder](../files/library-and-suggestions.md#the-organization-folder)

## Leaving an organization

### How do I leave an organization?

Open **Settings > Organization > General**, go to "Leave organization",
choose "Leave organization" and confirm. It takes effect at once.

More: [Organizations, Leaving in the app](../organizations/organizations.md#leaving-in-the-app)

### Who can leave an organization?

Any member, whatever their role, with one exception: the only owner cannot
leave.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### Why is the "Leave organization" button disabled?

You are the only owner. The section says "Make another member an owner
before leaving this organization." Make another member an owner first, or
delete the organization.

More: [Organizations, Leaving in the app](../organizations/organizations.md#leaving-in-the-app)

### What exactly happens when I leave an organization?

Your membership of the organization and of all its workspaces is removed.
Every API key and connected app you hold for that organization is revoked,
and every pending invitation you sent for it is deleted. Your account, your
sessions and your other organizations are untouched.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### What happens to files I uploaded when I leave an organization?

They stay in the organization. Their history still names you.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### What happens to my API keys and connected apps when I leave?

The ones you hold for that organization are revoked at once. A request with
one answers `401 UNAUTHENTICATED`. Keys and apps for your other
organizations keep working.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### Am I signed out when I leave an organization?

No. Leaving does not sign you out. Your sessions stay.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### Does leaving one organization affect my other organizations?

No. Leaving does not touch your other organizations, their files or the
credentials you hold for them.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### Does someone have to approve my leaving?

No. Leaving takes effect at once. No one has to approve it.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### Is anyone emailed when a member leaves?

No. No email is sent when someone leaves.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### Can I come back after leaving an organization?

Only through a new invitation from an owner or admin.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### Do I get my old workspaces and API keys back when I am invited again?

No. A new invitation grants the role and workspaces it names. Earlier
workspace memberships and credentials do not come back.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### What does `409 SOLE_OWNER` mean when I try to leave?

You are the only owner, and a live organization always has an owner. The
error lists the organization's ID in `details.organizationIDs`. Make another
member an owner, or delete the organization.

More: [Organizations, Errors](../organizations/organizations.md#errors)

### What happens if the only two owners leave at the same moment?

One succeeds and the other gets `409 SOLE_OWNER`. The two requests are
handled one after the other, so an owner always remains.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### Can I leave an organization that has been deleted?

No. Leaving a deleted organization answers `404 NOT_FOUND`. Membership of a
deleted organization is frozen until it is restored or removed for good.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### What does "Could not check the other owners. Reload to try again." mean?

Before it lets an owner leave, the app checks whether there are other
owners. This message means that check failed. Reload the page. While the
check runs the section says "Checking the other owners."

More: [Organizations, Leaving in the app](../organizations/organizations.md#leaving-in-the-app)

### Where does the app take me after I leave?

It shows "You left {name}" and opens another workspace you can reach. With
no organization left it opens "Set up your organization". With
organizations but no workspace it opens "No workspace yet".

More: [Organizations, Leaving in the app](../organizations/organizations.md#leaving-in-the-app)

### What does the "Leave {name}?" confirmation tell me?

"Your access to its workspaces ends at once. Files you uploaded stay." The
buttons are "Cancel" and "Leave organization".

More: [Organizations, Leaving in the app](../organizations/organizations.md#leaving-in-the-app)

### What does "Could not leave the organization. Try again." mean?

Leaving failed for a reason other than being the only owner. Nothing
changed. Try again.

More: [Organizations, Leaving in the app](../organizations/organizations.md#leaving-in-the-app)

### What is the difference between leaving an organization and deleting my account?

Leaving removes you from one organization and keeps your account, your
sessions and your other organizations. Deleting your account erases your
name and email, signs you out everywhere and removes you from every
organization, and it cannot be undone.

More: [Deleting an account, What deletion does](../accounts/delete-account.md#what-deletion-does)

## The settings pages

### Where are the organization's settings?

Under **Settings**, in the group "Organization". "Organization settings" in
the workspace switcher and in the command palette opens the General page of
the current workspace's organization.

More: [Organizations, Organization settings](../organizations/organizations.md#organization-settings)

### Which settings pages does an organization have?

Five: General, Members, Workspaces, Key management and Delete organization.
Every member sees General, Members and Workspaces. Owners and admins also
see Key management. Only owners see Delete organization. Below them,
"File spaces" lists the organization folder and each
workspace you can open; each opens its own navigation with its "Statuses",
"Custom fields" and "Tags" (and, for a workspace, "General").

More: [Organizations, Organization settings](../organizations/organizations.md#organization-settings)

### Why can I not see "Key management"?

Only owners and admins see that link. It holds every member's API keys and
connected apps.

More: [Organizations, Organization settings](../organizations/organizations.md#organization-settings)

### Why is there no "Delete organization" link in my settings?

Only owners see it. If an admin or member opens the page's address
directly, it says "Only owners can delete the organization."

More: [Organizations, Organization settings](../organizations/organizations.md#organization-settings)

### What is on the General page of an organization?

Four sections, in this order: "General" with the name, "Organization ID",
"Export" for owners and admins, and "Leave organization". The workspaces
are on their own page, **Settings > Organization > Workspaces**.

More: [Organizations, The General page](../organizations/organizations.md#the-general-page)

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

The name without a field, the organization ID and "Leave organization". A
member does not see "Export".

More: [Organizations, The General page](../organizations/organizations.md#the-general-page)

### What does the line "Your role: Admin · 2 workspaces you can open" mean?

Every organization settings page starts with the organization's name and a
line like this. It states your role in the organization and how many of its
workspaces you can open.

More: [Organizations, Organization settings](../organizations/organizations.md#organization-settings)

### Why do I get "Not found" when I open an organization's settings?

You are not a member of it, it was deleted, or the address is wrong. The
page says "This page does not exist, or you do not have access to it." All
three look the same on purpose.

More: [Organizations, Organization settings](../organizations/organizations.md#organization-settings)

### What does "Your role no longer allows that. The page now shows what you can do." mean?

Your role was lowered in another browser while the page was open, and you
used a control your new role does not allow. The app redraws the page for
your new role.

More: [Organizations, When your access changes while a page is open](../organizations/organizations.md#when-your-access-changes-while-a-page-is-open)

### What does "You no longer have access to {name}" mean in settings?

You were removed from the organization while its settings were open. The
app says so and takes you home.

More: [Organizations, When your access changes while a page is open](../organizations/organizations.md#when-your-access-changes-while-a-page-is-open)

### Can I open a settings page by its address if I do not see its link?

No. A page whose link you do not see still refuses you if you open its
address directly.

More: [Organizations, Organization settings](../organizations/organizations.md#organization-settings)

### What does the label "Deleted" mean in my list of organizations?

It marks an organization you own that was deleted and can still be
restored. It shows no workspace count. Opening it lets you restore it.

More: [Organizations, The organizations list](../organizations/organizations.md#the-organizations-list)

### Why did an organization vanish from my list?

It was deleted, or you were removed from it. Admins and members no longer
see a deleted organization at all. Only its owners still see it, marked as
deleted.

More: [Organizations, What a member sees while an organization is deleted](../organizations/organizations.md#what-a-member-sees-while-an-organization-is-deleted)

### Can a member open the Organization folder page of an organization?

Yes. Every member sees "Organization folder" under "File spaces" in the settings navigation, whose pages "Statuses", "Custom
fields" and "Tags" hold the organization folder's statuses, custom fields
and tags. Only the organization's owners
and admins change them.

More: [Organizations, Organization settings](../organizations/organizations.md#organization-settings)

### Where are a workspace's statuses, fields and tags?

On the workspace's pages "Statuses", "Custom fields" and "Tags": choose the
workspace under "File spaces" in the settings
navigation, then the page under "Files & Assets" in its own navigation.
Everyone who can open the workspace sees them. Only the workspace's owners
and admins, and the organization's, change them, renaming and deleting tags
included.

More: [Organizations, Organization settings](../organizations/organizations.md#organization-settings)

## What an organization does not have

### Is there single sign-on for an organization?

No. A person signs in with their email address and password. An
organization cannot connect an identity provider.

More: [Sign-in and sessions, Signing in](../accounts/sign-in-and-sessions.md#signing-in)

### Can people with our email domain join the organization automatically?

No. An account joins an organization only by creating it or by accepting
an invitation sent to its address.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

### Can I upload a logo for my organization?

No. An organization has a name and an ID. There is no logo or picture to
set.

More: [Organizations, The General page](../organizations/organizations.md#the-general-page)

### Is there a limit on how many owners an organization can have?

No. An organization has at least 1 owner and no upper limit.

More: [Organizations, Limits](../organizations/organizations.md#limits)

### Can I pause or archive an organization without deleting it?

No. There is no paused or archived state. An organization is live, or it is
deleted and restorable for 30 days.

More: [Deleting and restoring, Summary](../organizations/delete-and-restore.md#summary)

## The API and agents

### Can an API key create an organization?

No. `POST /v1/organizations` answers a credential with `403 FORBIDDEN` and
`details.reason` `SESSION_REQUIRED`. A person creates an organization in a
browser.

More: [Organizations, Session-only operations](../organizations/organizations.md#session-only-operations)

### Can an agent rename or leave an organization?

No. A credential never creates, renames or leaves an organization. Those
need a person signed in with a browser.

More: [Organizations, Who can do what](../organizations/organizations.md#who-can-do-what)

### Which organization operations can a credential call?

Three, all of them reads: `GET /v1/workspaces`, `GET /v1/organizations` and
`GET /v1/organizations/{organizationID}`. A credential sees only its own
organization.

More: [Organizations, For agents](../organizations/organizations.md#for-agents)

### Which scope does a credential need to read an organization?

`workspace:read`. Listing the workspaces the credential reaches works with
any scope.

More: [Organizations, For agents](../organizations/organizations.md#for-agents)

### How does an agent find out which organization it works for?

It calls `GET /v1/workspaces`, or the MCP tool `workspaces_list`. Each
workspace in the answer carries `organizationID` and `organizationName`.

More: [Organizations, Discovering workspaces and the organization](../organizations/organizations.md#discovering-workspaces-and-the-organization)

### Why does my API key get `404 NOT_FOUND` for my other organization?

A credential belongs to exactly one organization. It sees only that
organization, even when its member belongs to others. Create another
credential for the other organization.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

### Why does `GET /v1/organizations` return only one organization for my API key?

A credential lists only its own organization, and counts only its own
workspaces in `workspaceCount`. A browser session lists every organization
the account belongs to.

More: [Organizations, Listing organizations](../organizations/organizations.md#listing-organizations)

### What does `GET /v1/organizations/{organizationID}` return?

The organization's `id`, `name`, your `role`, `createdAt`, `deletedAt`,
`purgeAfter`, and `workspaces`: the workspaces you can open, each with your
effective role there, sorted by name.

More: [Organizations, Reading an organization](../organizations/organizations.md#reading-an-organization)

### What does `role` mean in the answer for an organization?

It is the caller's role in the organization: `owner`, `admin` or `member`.
For a credential it is the role of the member it acts for.

More: [Organizations, Reading an organization](../organizations/organizations.md#reading-an-organization)

### What do `deletedAt` and `purgeAfter` mean on an organization?

They are `null` for a live organization. They are set only for an owner
reading a deleted one: `deletedAt` is when it was deleted and `purgeAfter`
is when it is removed for good. `workspaces` is then empty.

More: [Organizations, Reading an organization](../organizations/organizations.md#reading-an-organization)

### How do I page through the list of organizations?

Pass `limit` (1 to 100, default 50) and `cursor`, the `nextCursor` of the
previous page. When `nextCursor` is `null` there are no more.

More: [Organizations, Listing organizations](../organizations/organizations.md#listing-organizations)

### What does `workspaceCount` count in the list of organizations?

The workspaces the caller can open. For a deleted organization it counts
the workspaces a restore brings back.

More: [Organizations, Listing organizations](../organizations/organizations.md#listing-organizations)

### Is there an MCP tool for reading an organization?

Yes, `organizations_get`, with `{"organizationID": "..."}`. It is also a
resource. Listing organizations has no MCP tool; it is REST only. An agent
starts with `workspaces_list`.

More: [Organizations, For agents](../organizations/organizations.md#for-agents)

### What does `SESSION_REQUIRED` mean on an organization operation?

A credential called an operation that only a person in a browser may call:
create, rename or leave. The answer is `403 FORBIDDEN` with `details.reason`
`SESSION_REQUIRED`.

More: [Organizations, Errors](../organizations/organizations.md#errors)

### What does `INSUFFICIENT_SCOPE` mean when I read an organization?

The credential lacks `workspace:read`. `details.requiredScopes` names the
scope. Create a credential that holds it.

More: [Organizations, Errors](../organizations/organizations.md#errors)

### What does the API answer when an organization is created?

`201` with the new organization, your role `owner` and exactly one
workspace. The request body is `{"name": "...", "workspaceName": "..."}`.

More: [Organizations, Session-only operations](../organizations/organizations.md#session-only-operations)

### What does the API answer when I leave an organization?

`204`, with no body. `POST /v1/organizations/{organizationID}/leave` takes
no body either.

More: [Organizations, Session-only operations](../organizations/organizations.md#session-only-operations)

### What does a signed-out request for an organization get?

`401 UNAUTHENTICATED`. Sign-in is checked before anything else.

More: [Organizations, Errors](../organizations/organizations.md#errors)

### Why do I get `404` and not `403` for an organization I am not a member of?

So that the answer does not reveal that the organization exists. Someone
who is not a member gets the same answer as for an ID that does not exist.

More: [Organizations, The organization ID](../organizations/organizations.md#the-organization-id)

### What happens if the organization ID in a request is not a valid UUID?

The answer is `404 NOT_FOUND`. A malformed ID names nothing.

More: [Organizations, Edge cases](../organizations/organizations.md#edge-cases)

### How many requests can a credential make against an organization?

600 a minute with one credential, and 3,000 a minute with all credentials
of one organization together. Past the limit the answer is
`429 RATE_LIMITED`, and `Retry-After` says when to try again.

More: [Organizations, Limits](../organizations/organizations.md#limits)

### Does `GET /v1/workspaces` show workspaces from all my organizations?

For a browser session, yes: every workspace the account can open, in every
organization. For a credential it shows the workspaces the credential was
given, minus any its member can no longer open and minus deleted ones.

More: [Organizations, Discovering workspaces and the organization](../organizations/organizations.md#discovering-workspaces-and-the-organization)

### In what order does `GET /v1/workspaces` return its workspaces?

Sorted by organization name, then workspace name. The list is not paged.

More: [Organizations, Discovering workspaces and the organization](../organizations/organizations.md#discovering-workspaces-and-the-organization)

### Why does my API key answer `401` after I left the organization?

Leaving revoked it. A credential acts for a member, and you are no longer
one. Being invited back does not bring the key back; create a new one.

More: [Organizations, Leaving](../organizations/organizations.md#leaving)

### Why does a browser request sent from outside the app get `403 FORBIDDEN`?

A browser request that changes something must come from the app's own
address. Use the app, or a credential for the operations that allow one.

More: [Organizations, Errors](../organizations/organizations.md#errors)

### Can a credential read an organization where its member is also a member, if it is not the credential's own?

No. It answers `404 NOT_FOUND`. A credential is bound to one organization,
whatever else its member belongs to.

More: [Organizations, Belonging to several organizations](../organizations/organizations.md#belonging-to-several-organizations)

### How do I read my organization with curl?

Send the key as a bearer token:

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

The key needs `workspace:read`, and the ID must be the key's own
organization.

More: [Organizations, A worked example](../organizations/organizations.md#a-worked-example)
