Administration
Organizations
An organization is the top-level container in Topographer: it holds your projects, teams and users. This page covers switching between organizations, organization settings, the activity log and managing projects.
Switch organizations
If you belong to more than one organization, the first item in the breadcrumb at the top of the page is the organization switcher. Choose it to see every organization you belong to, then choose one.
Switching opens that organization and takes you into a project you can reach. If the organization has no project you can reach yet, you see its organization page instead (below). Some organizations ask for another verification step when you enter them: the dashboard says the organization “asks for another verification step” and you sign in again.
The organization page
The organization page shows “Your organization” with the organization’s name, and a Projects heading with a card for each project you can open. Choose a card to open that project.
If you can create projects, a + Create Project card opens the “Create a project” dialog: enter a Name and choose Create Project. If you cannot reach any project and cannot create one, the page says “You don’t have access to any projects in this organization yet. Ask an organization admin to add your team to a project.”
Organization settings
Open the menu (☰) and choose Settings in the Organization group. Only the Admin role can open this page (permission org:manage_org).
| Section | Field | What it does |
|---|---|---|
| General | Name | The organization’s name, shown in the organization switcher and on admin pages |
| General | ID | The organization’s id. Read-only. |
| Data Retention | Retention Period (days) | How long deleted projects can be restored. Any whole number from 1 to 365. The default is 90. |
Change a value and choose Save. The dashboard confirms with “Organization Settings Saved”.
The Data Retention section reads “Data in the trash will be permanently deleted after this period”. While the period lasts, an Admin can restore a deleted project from the Projects page. After it ends, the project may be deleted permanently.
Activity
The activity log records who did what in the organization. Open the menu (☰) and choose Activity. Admins, Members and Viewers can all read it (permission org:view_activity_log).
It records actions such as:
- people joining the organization, being removed from it, and being added to or removed from teams
- projects created, deleted and restored
- Spice Passes and API tokens created, and credentials revoked
- survey uploads as they arrive and are queued for processing
Each row shows Timestamp, Project, Actor (the person’s email) and Action. Narrow the list with the filters above it:
- Project: all projects, entries with no project (
<None>), or one project - Action: all actions or one kind, such as Create Project or Remove User From Org
- Show: 10, 25, 50 or 100 entries
Choose a row to expand it. The full entry appears as formatted JSON, with the details of the action. Many entries carry a traceId.
Projects
Open the menu (☰) and choose Projects, or choose Manage projects at the bottom of the project switcher in the breadcrumb. Admins, Members and Viewers can all open this page (permission org:view).
The list shows the organization’s projects. The project you are in is marked Active. For any other project you can reach, an Open project button switches to it. A project’s name links to its project page only if you hold project:admin on it (Admin and Member roles).
Create a project
Admins and Members can create projects (permission org:create_project).
-
Choose Create Project
On the Projects page, choose Create Project.
-
Name it
Enter a Project name and choose Create. The dashboard confirms that the project was created.
Who can reach the new project depends on your teams. Teams set to all projects, including the built-in Admins and Members teams, reach it at once. A team set to selected projects reaches it only after you add it to that team: see Teams and roles.
Rename a project
Choose the project’s name on the Projects page, or open the project and choose Settings in the menu’s Project group. The project page has a General section with Name and ID. Change the name and choose Save.
The project page also shows a Resources section with Storage Size, Memory and CPU. These are read-only. To discuss different resources for a project, contact support@spicelabs.io.
Delete a project
Only the Admin role can delete projects (permission org:delete_project).
-
Open the project page
On the Projects page, choose the project’s name.
-
Choose Delete Project
In the Danger Zone section, choose Delete Project.
-
Confirm by typing the name
The dialog says the project will move to the trash. Type the project name exactly and choose Delete Project.
A deleted project leaves the project list immediately. Its surveys, reports and portfolios become unreachable, and sign-ins to it stop working. You cannot delete an organization’s last project.
Restore a deleted project
Deleted projects stay restorable for the organization’s retention period (90 days unless an Admin changed it in Organization settings). Only the Admin role sees deleted projects and can restore them.
-
Show deleted projects
On the Projects page, turn on Show deleted. Deleted projects appear with a Deleted badge.
-
Restore
Choose Restore on the project’s row. The dashboard confirms that the project was restored.
The restored project comes back with its surveys, reports and portfolios.