Organizations

An organization holds projects and people. Create an organization, add projects to it, and see which organization tasks the dashboard does not have yet.

Manage organizations in the dashboard. An API key cannot reach them.

What runs today: a signed-in person creates an organization from the user menu. An owner or admin adds a project from the project menu in the top bar.

What is not available: an API key cannot create or read an organization in this release. See In API Requests for the routes that a key reaches.

An organization holds projects and the people who work on them.

A project belongs to one organization. The traces, the API keys and the settings belong to the project. See Projects.
A person has one role in an organization. See Roles.
You can belong to more than one organization. The project menu in the top bar lists the projects of all your organizations by project name. It does not show the organization name, so two projects in different organizations can look the same.

Create an organization

Any person with an approved account can create an organization. You become its owner.

Open the dialog

Open the user menu in the top bar and click Create organization.

Name the organization

Enter an Organization name. It is required and has at most 255 characters.

Name the first project

Enter a First project name (optional). If you leave it empty, the first project is named "My Project".

Create it

Click Create Organization.

Risicare creates three things in one step: the organization with you as owner, its first project, and the first API key of that project.

The dialog Organization Created then shows the key once. It says "This is the only time you will see this API key." The dialog also shows a Quick Start snippet that holds your key. Copy the key with the copy button, or show it with the eye button. Escape and a click outside the dialog do not close the dialog while the key shows. Click Done when you have saved the key. The dashboard then opens the new project.

Risicare shows this key nowhere else. If you lose it, create a new key in Settings → API Keys and revoke the lost one. See API Keys. For the first steps in the new project, see the Quickstart.

Creating an organization also creates a key, so it needs a sign-in from the last 15 minutes. If your sign-in is older, the dialog shows a message and a Sign in again button. Sign in, then open Create organization again.

Refusals

When Risicare refuses, the dialog shows its message. Two causes are an account that is not approved yet, and a person who has created the most organizations that one person can create.

The organization page

The organization page has the address /organization/ followed by the organization ID. In this release no menu item or link in the dashboard opens it.

The page has the title Projects and the text "Every project in this organization". It shows one card for each project, with the project name and its slug. Click a card to open the project. If the organization has no project, the page says "No projects yet". If you are not a member, the page says "No access to this organization" and a View your organizations button leads to the sign-in page, which lists your organizations.

New Project in this organization

The New Project button next to the title creates a project in this organization.

Click New Project.
Enter a project name and click Create.
The dashboard opens the new project.

Only owners and admins of the organization can create a project, and it needs a sign-in from the last 15 minutes. If your sign-in is older, the control shows a message and a Sign in again button.

This control shows no API key. Create a key in the new project, in Settings → API Keys.

The New Project item in the project menu of the top bar creates the project in the organization of your current sign-in. The dashboard has no link to the page of another organization, so it has no way to choose a different organization for a new project.

Roles

A role applies to the whole organization, not to one project. The roles are owner, admin, member and viewer. The person who creates an organization is its owner. Owners and admins invite people and change roles in Settings → Team. See Team and the permission matrix.

Not available in this release

The dashboard has no control to rename an organization, to leave it, or to transfer its ownership. These tasks are not available in this release. It has no control to delete an organization either. See Deleting your account or organization.