# Team Management

In Terrakube you can define user permissions inside your organization using teams.

### Creating a Team

Once you are in the desired organization, click the **Settings** button and then in the left menu select the **Teams** option.

<figure><img src="https://4014930676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfAN3V983Y82_trlbcu%2Fuploads%2Fgit-blob-5f27d2ae8bc545f1ea2b782e889d8fdd753d3653%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Click the **Create team** button

<figure><img src="https://4014930676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfAN3V983Y82_trlbcu%2Fuploads%2Fgit-blob-12d695c3578f324fc8f05bcbc172dda35befb0c9%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

In the popup, provide the team name and the permissions assigned to the team. Use the below table as reference:

<table><thead><tr><th width="341">Field</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td><p>Must be a valid group based on the Dex connector you are using to manage users and groups.</p><p>For example if you are using Azure Active Directory, you must use a valid Active Directory Group like TERRAKUBE_ADMIN, or if you are using Github the format should be MyGithubOrg:TERRAKUBE_ADMIN</p></td></tr><tr><td>Manage Workspaces</td><td>Allow members to create and administrate all workspaces within the organization</td></tr><tr><td>Manage Modules</td><td>Allow members to create and administrate all modules within the organization</td></tr><tr><td>Manage Providers</td><td>Allow members to create and administrate all providers within the organization</td></tr><tr><td>Manage <a href="templates">Templates</a></td><td>Allow members to create and administrate all <a href="templates">templates</a> within the organization</td></tr><tr><td>Manage <a href="../vcs-providers">VCS Settings</a></td><td>Allow members to create and administrate all <a href="../vcs-providers">VCS Providers</a> within the organization</td></tr><tr><td>Manage State</td><td>Allow members to see the terraform/tofu state from the UI</td></tr></tbody></table>

<figure><img src="https://4014930676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfAN3V983Y82_trlbcu%2Fuploads%2Fgit-blob-2e7cb4319971995c6ec869f080e7c30565ab29a8%2Fimage%20(426).png?alt=media" alt=""><figcaption></figcaption></figure>

Finally click the **Create team** button and the team will be created

<figure><img src="https://4014930676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfAN3V983Y82_trlbcu%2Fuploads%2Fgit-blob-657cc9d71be39e05d4bd02413d669da931071d29%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Now all the users inside the team will be able to manage the specific resources within the organization based on the permissions you grantted.

### Edit a Team

Click the **Edit** button next to the team you want to edit

<figure><img src="https://4014930676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfAN3V983Y82_trlbcu%2Fuploads%2Fgit-blob-052beb989c0d75a07aff24ece9816be655032a41%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Change the permissions you need and click the **Save team** button

<figure><img src="https://4014930676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfAN3V983Y82_trlbcu%2Fuploads%2Fgit-blob-3f0d4808ef91e6a7258ac401c2ec5aaced29c1d0%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Delete a Team

Click the **Delete** button next to the team you want to delete, and then click the Yes button to confirm the deletion. Please take in consideration the deletion is irreversible

<figure><img src="https://4014930676-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfAN3V983Y82_trlbcu%2Fuploads%2Fgit-blob-6a25df873903473333a69b4c69ad9b7d7c2e324b%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.terrakube.io/user-guide/organizations/team-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
