docs(concepts): add org tokens (#3871)

docs/docs/concepts/environment-token.mdx → docs/docs/concepts/environment-tokens.mdx

@@ -1,7 +1,7 @@
 ---
 id: environment-tokens
 title: Environment Tokens
-description: Environment Tokens are strings used to authenticate Tracetest CLI against an organization and environment.
+description: Environment Tokens are strings used to authenticate Tracetest CLI against an environment.
 hide_table_of_contents: false
 keywords:
   - tracetest
@@ -12,7 +12,7 @@ keywords:
 image: https://res.cloudinary.com/djwdcmwdz/image/upload/v1698686403/docs/Blog_Thumbnail_14_rsvkmo.jpg
 ---
 
-Environment Tokens are strings used to authenticate the Tracetest CLI against an organization and environment.
+Environment Tokens are strings used to authenticate the Tracetest CLI against an environment in an organization.
 
 ![](https://res.cloudinary.com/djwdcmwdz/image/upload/v1701296331/docs/environment-tokens_gkt9kx.png)
 

docs/docs/concepts/organization-tokens.mdx

@@ -0,0 +1,34 @@
+---
+id: organization-tokens
+title: Organization Tokens
+description: Organization Tokens are strings used to authenticate Tracetest CLI against an organization and the environments and resources within the organization.
+hide_table_of_contents: false
+keywords:
+  - tracetest
+  - trace-based testing
+  - observability
+  - distributed tracing
+  - testing
+image: https://res.cloudinary.com/djwdcmwdz/image/upload/v1698686403/docs/Blog_Thumbnail_14_rsvkmo.jpg
+---
+
+Organization Tokens are strings used to authenticate Tracetest CLI against an organization and the environments and resources within the organization.
+
+![](https://res.cloudinary.com/djwdcmwdz/image/upload/v1716818893/docs/app.tracetest.io_organizations_ttorg_e66318ba6544b856_tokens_veklnd.png)
+
+These tokens are used to configure environments with the Tracetest CLI. You can configure detailed environment automation with an organization token.
+
+Create a new token by clicking on the `Create a new token` button, choosing a name, role and expiration and then clicking on `Create`.
+
+![](https://res.cloudinary.com/djwdcmwdz/image/upload/v1716819703/docs/app.tracetest.io_organizations_ttorg_e66318ba6544b856_tokens_1_mx7cr1.png)
+
+Two roles are available:
+
+- **Admin** - This token will enable authenticating both the CLI and Tracetest Agent with a single token.
+- **Agent** - Thsi token will only be for authenticating and running the Tracetest Agent.
+
+This will create a token that you can copy and use to configure Tracetest CLI with:
+
+```bash
+tracetest configure --token {ADD_YOUR_TOKEN_HERE}
+```

docs/sidebars.js

@@ -752,6 +752,11 @@ const sidebars = {
           id: "concepts/roles-and-permissions",
           label: "Roles and Permissions",
         },
+        {
+          type: "doc",
+          id: "concepts/organization-tokens",
+          label: "Organization Tokens",
+        },
         {
           type: "doc",
           id: "concepts/environment-tokens",