> For the complete documentation index, see [llms.txt](https://docs.stg.ai.neevcloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stg.ai.neevcloud.com/getting-started/org-and-project.md).

# Organizations and Projects

In NeevCloud, every resource is organized within an Organization and associated Projects.

Organizations help you manage teams and billing, while projects help you structure workloads, environments, and resources efficiently.

## Find Your Organization ID and Project ID

Most NeevCloud APIs, SDKs, and the `neev-cli` need two IDs alongside your credentials: the **Organization ID** and the **Project ID**. Both are shown in the NeevCloud Console.

| ID              | Starts with | Example          |
| --------------- | ----------- | ---------------- |
| Organization ID | `org-`      | `org-xxxxxxxxxx` |
| Project ID      | `prj-`      | `prj-xxxxxxxxxx` |

### Find Your Organization ID

1. Log in to the [NeevCloud Console](https://console.ai.neevcloud.com/).
2. In the left navigation menu, under **Account**, select **Organization**.
3. In the **Organization** table, find your organization and copy the value in the **Organization ID** column.

![](https://1980728309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSqquJG2zKVZ5l1Sd5aQy%2Fuploads%2Fgit-blob-ca1637835132adf7d9925164a18128fdda82de69%2Forganization-id.png?alt=media)

**Note**: If you belong to more than one organization, each one is listed in this table. Copy the ID of the organization that owns the resources you want to work with. The organization marked **Default** is the one created with your account.

### Find Your Project ID

1. In the left navigation menu, under **Account**, select **Projects**.
2. The **All Projects** table lists the projects in the organization currently selected at the top of the left navigation menu.
3. Find the project you want to use and copy the value in the **Project ID** column.

![](https://1980728309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSqquJG2zKVZ5l1Sd5aQy%2Fuploads%2Fgit-blob-e6c990837a012b212ecf874f00161124d3b6b773%2Fproject-id.png?alt=media)

**Note**: Projects belong to an organization. If you don't see the project you expect, switch to the right organization from the selector at the top of the left navigation menu, then open **Projects** again.

### Use the IDs

Pass the IDs wherever a request asks for them.

**neev-cli**

```bash
export NEEV_API_TOKEN="pat-nc-..."
neev-cli sandbox list --org-id org-xxxxxxxxxx --project-id prj-xxxxxxxxxx
```

**SDK environment variables**

```bash
NEEV_API_KEY=your-api-key
NEEV_ORG_ID=org-xxxxxxxxxx
NEEV_PROJECT_ID=prj-xxxxxxxxxx
```

**Tip**: Organization and Project IDs are identifiers, not secrets, but your API key is. Keep the API key private and never commit it to a repository. See [API Key](/getting-started/create-api-key.md) and [NeevCloud CLI](/getting-started/neev-cli.md) for details.

## Creating an Organization

You can create an organization to collaborate with your team and manage resources under one unified account.

### Steps to Create an Organization (Coming Soon)

1. Go to your NeevCloud Dashboard.
2. Navigate to Organizations → Create.
3. Enter the following details:
   * **Organization Name**: A unique name to identify your organization.
   * **Description**: (Optional) Add details or purpose of the organization.
4. Click Create to finish setup.

Once created, you'll be redirected to the organization overview page, where you can manage projects, members, and roles.

**Note**: Each user account comes with a default organization. You can create additional organizations as needed for separate teams or environments.

**Caution**: Deleting an organization will permanently remove all projects, resources, and associated data. This action cannot be undone.

## Creating Projects

Projects are isolated workspaces within your organization where you can deploy and manage compute instances, storage, and other resources.

### Create a Project

1. In your Organization Dashboard, go to Projects → Create.
2. Fill in the following details:
   * **Project Name**: A descriptive name for your project.
   * **Tags**: (Optional) Add tags to organize and filter your projects.
   * **Description**: (Optional) Add a short description of the project purpose.
3. Click Create to initialize your project.

Once created, your project will appear in the Projects list. You can now allocate resources, invite members, or integrate APIs.

## Deleting Projects

Delete a project when it is no longer needed, but be aware that this action is irreversible.

### Delete a Project

1. Go to Projects → Select the project you want to delete.
2. Click Delete Project.
3. Confirm the deletion when prompted.

**Warning**: Deleting a project is permanent and will remove all associated resources, data, and configurations. Proceed with caution.

## Managing Members

Collaborate effectively by inviting team members to your organization or specific projects.

### Invite Members

1. Go to your Organization Dashboard → Members → Invite.
2. Enter the email address of the member you want to invite.
3. Select the project (optional) and assign a role.
4. Click Invite to send an email invitation.

Once accepted, the member will appear in your Members list with their assigned role.

### Remove Members

1. Navigate to Members under your organization or project.
2. Select the member you want to remove.
3. Click Remove and confirm the action.

**Tip**: Removing a member immediately revokes their access to all organization and project resources.

## Roles and Permissions

NeevCloud supports role-based access control (RBAC) to maintain secure and organized collaboration.

| Role   | Description                                                                                     |
| ------ | ----------------------------------------------------------------------------------------------- |
| Owner  | Full control of the organization. Can create/delete projects, manage billing, and assign roles. |
| Admin  | Can manage members, create projects, and deploy resources within the organization.              |
| Member | Limited access. Can view and manage resources within assigned projects only.                    |

**Note**: You can modify member roles anytime under the Members tab.

## Need Help?

If you encounter issues while managing organizations or projects:

* Visit the NeevCloud Documentation Portal
* Or reach out to <support@neevcloud.com>
