> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nelkap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces and projects

> How your team, your apps, and your environments fit into workspaces and projects.

Nelkap organizes everything in two levels. A workspace is your team: its members, its plan, and its limits. A project is one app in one environment: its endpoint, its keys, and its workflows, runs, and events.

## Workspaces

A workspace holds your projects and the people who work on them. Everything the plan decides applies to the whole workspace: how many runs go at once, how many requests per second it takes, and how long history is kept.

You create a workspace from your account, with a name, a plan, and the name of its first project. You become its owner. One person can own up to 5 workspaces, and be a member of as many as they're invited to.

Rename a workspace from its settings. Only the owner can.

## Projects

A project is what your app connects to. It has:

* An endpoint: the URL Nelkap calls to run your workflows.
* A secret, which your app uses to check that each call comes from Nelkap.
* API keys, which your app uses to start runs, emit events, and save steps.
* Its workflows, runs, events, webhooks, and alerts.

Two projects never see each other's workflows, runs, or events. A run started with a project's API key runs on that project's endpoint, and an event emitted in one project starts and wakes runs of that project only.

## Create a project

Go to Projects and create one, with a name, up to 100 characters, and its endpoint. Creating and changing projects takes the Member role or above. A new workspace's first project has no endpoint yet: edit it to set one before you create its API keys.

Your plan sets how many projects your workspace can have. See [Limits](https://docs.nelkap.com/limits.md#by-plan).

## One project per app and per environment

A project has a single endpoint, so all its workflows run in one app. Create one project:

* Per app. Two apps with their own workflows each need their own project, since each registers its own list of workflows.
* Per environment. Staging and production each get a project, so tests never touch production. See [Staging and production](https://docs.nelkap.com/deploy/environments.md).

## Change a project

Edit a project to rename it or change its endpoint. A new endpoint applies to the next call Nelkap makes: runs in progress go on at the new address.

From the project, you can also reveal its secret and rotate it. Rotating takes the Admin role. See [API keys and secrets](https://docs.nelkap.com/manage/api-keys.md).

## See one project at a time

Lists of workflows, runs, events, webhooks, API keys, and alerts show the whole workspace, with a column for the project. Choose a project at the top of the page to see only that project, on every page you open next.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.