diff --git a/docs/api-reference/assets/create-workspace-asset-upload.md b/docs/api-reference/assets/create-workspace-asset-upload.md
index 472445a3..f5e18f13 100644
--- a/docs/api-reference/assets/create-workspace-asset-upload.md
+++ b/docs/api-reference/assets/create-workspace-asset-upload.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, assets, create workspace
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/assets/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/assets/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Generate presigned URL for generic asset upload
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/assets/delete-user-asset.md b/docs/api-reference/assets/delete-user-asset.md
index 1fdef243..4ef203b1 100644
--- a/docs/api-reference/assets/delete-user-asset.md
+++ b/docs/api-reference/assets/delete-user-asset.md
@@ -51,9 +51,9 @@ Asset ID
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/assets/user-assets/550e8400-e29b-41d4-a716-446655440002/" \
+  "https://api.plane.so/api/v1/assets/user-assets/asset-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -63,7 +63,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/assets/user-assets/550e8400-e29b-41d4-a716-446655440002/",
+    "https://api.plane.so/api/v1/assets/user-assets/asset-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -73,7 +73,7 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch("https://api.plane.so/api/v1/assets/user-assets/550e8400-e29b-41d4-a716-446655440002/", {
+const response = await fetch("https://api.plane.so/api/v1/assets/user-assets/asset-uuid/", {
   method: "DELETE",
   headers: {
     "X-API-Key": "your-api-key",
diff --git a/docs/api-reference/assets/get-workspace-asset.md b/docs/api-reference/assets/get-workspace-asset.md
index b36672dc..9eeab670 100644
--- a/docs/api-reference/assets/get-workspace-asset.md
+++ b/docs/api-reference/assets/get-workspace-asset.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, assets, get workspace ass
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/assets/{asset_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/assets/{asset_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Get presigned URL for asset download
 
 <ApiParam name="asset_id" type="string" :required="true">
 
-Asset id.
+The unique identifier of the asset.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/assets/550e8400-e29b-41d4-a716-446655440002/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/assets/asset-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/assets/550e8400-e29b-41d4-a716-446655440002/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/assets/asset-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/assets/550e8400-e29b-41d4-a716-446655440002/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/assets/asset-uuid/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/assets/update-user-asset.md b/docs/api-reference/assets/update-user-asset.md
index 1a9e0635..d90901f2 100644
--- a/docs/api-reference/assets/update-user-asset.md
+++ b/docs/api-reference/assets/update-user-asset.md
@@ -63,7 +63,7 @@ Additional attributes to update for the asset
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/assets/user-assets/550e8400-e29b-41d4-a716-446655440002/" \
+  "https://api.plane.so/api/v1/assets/user-assets/asset-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -84,7 +84,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/assets/user-assets/550e8400-e29b-41d4-a716-446655440002/",
+    "https://api.plane.so/api/v1/assets/user-assets/asset-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "attributes": {
@@ -102,7 +102,7 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch("https://api.plane.so/api/v1/assets/user-assets/550e8400-e29b-41d4-a716-446655440002/", {
+const response = await fetch("https://api.plane.so/api/v1/assets/user-assets/asset-uuid/", {
   method: "PATCH",
   headers: {
     "X-API-Key": "your-api-key",
diff --git a/docs/api-reference/assets/update-workspace-asset.md b/docs/api-reference/assets/update-workspace-asset.md
index 054beab1..2aca4b3e 100644
--- a/docs/api-reference/assets/update-workspace-asset.md
+++ b/docs/api-reference/assets/update-workspace-asset.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, assets, update workspace
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/assets/{asset_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/assets/{asset_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Update generic asset after upload completion
 
 <ApiParam name="asset_id" type="string" :required="true">
 
-Asset ID
+The unique identifier of the asset.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -69,7 +69,7 @@ Whether the asset has been successfully uploaded
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/assets/550e8400-e29b-41d4-a716-446655440002/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/assets/asset-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -85,7 +85,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/assets/550e8400-e29b-41d4-a716-446655440002/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/assets/asset-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "is_uploaded": true
@@ -98,19 +98,16 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/assets/550e8400-e29b-41d4-a716-446655440002/",
-  {
-    method: "PATCH",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      is_uploaded: true,
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/assets/asset-uuid/", {
+  method: "PATCH",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    is_uploaded: true,
+  }),
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/customer/add-customer-property.md b/docs/api-reference/customer/add-customer-property.md
index 7bd6f05f..a1b13e9b 100644
--- a/docs/api-reference/customer/add-customer-property.md
+++ b/docs/api-reference/customer/add-customer-property.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, create a custom
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/customer-properties/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customer-properties/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Create a new customer property in the specified workspace.
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/customer/add-customer-request.md b/docs/api-reference/customer/add-customer-request.md
index 06fef4ef..ccd84dd7 100644
--- a/docs/api-reference/customer/add-customer-request.md
+++ b/docs/api-reference/customer/add-customer-request.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, create a custom
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{customer_id}/requests/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{customer_id}/requests/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Create a new request for the specified customer.
 
 <ApiParam name="customer_id" type="string" :required="true">
 
-Customer id.
+The unique identifier of the customer.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -93,7 +93,7 @@ Work item ids.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -115,7 +115,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -134,23 +134,20 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Example Name",
-      description: "example-value",
-      description_html: "<p>Example content</p>",
-      link: "https://example.com/resource",
-      work_item_ids: ["550e8400-e29b-41d4-a716-446655440000"],
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Example Name",
+    description: "example-value",
+    description_html: "<p>Example content</p>",
+    link: "https://example.com/resource",
+    work_item_ids: ["550e8400-e29b-41d4-a716-446655440000"],
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/customer/add-customer.md b/docs/api-reference/customer/add-customer.md
index 6784d8e7..e03b09c3 100644
--- a/docs/api-reference/customer/add-customer.md
+++ b/docs/api-reference/customer/add-customer.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, create a custom
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Create a new customer in the specified workspace.
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/customer/delete-customer-property.md b/docs/api-reference/customer/delete-customer-property.md
index c873e59c..9f9e3988 100644
--- a/docs/api-reference/customer/delete-customer-property.md
+++ b/docs/api-reference/customer/delete-customer-property.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, delete a custom
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/customer-properties/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customer-properties/{property_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Permanently delete a customer property from the workspace.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Slug.
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/property-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/property-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -76,15 +76,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/property-uuid/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/customer/delete-customer-request.md b/docs/api-reference/customer/delete-customer-request.md
index 73d16a41..186c0549 100644
--- a/docs/api-reference/customer/delete-customer-request.md
+++ b/docs/api-reference/customer/delete-customer-request.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, delete a custom
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{customer_id}/requests/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{customer_id}/requests/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Permanently delete a customer request and unlink any linked issue
 
 <ApiParam name="customer_id" type="string" :required="true">
 
-Customer id.
+The unique identifier of the customer.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Slug.
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/resource-id-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/customer/delete-customer.md b/docs/api-reference/customer/delete-customer.md
index 77cbdcce..e005bd54 100644
--- a/docs/api-reference/customer/delete-customer.md
+++ b/docs/api-reference/customer/delete-customer.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, delete a custom
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Permanently delete a customer from the workspace.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Slug.
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -76,15 +76,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/customers/resource-id-uuid/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/customer/get-customer-detail.md b/docs/api-reference/customer/get-customer-detail.md
index 17e64837..e75e9a25 100644
--- a/docs/api-reference/customer/get-customer-detail.md
+++ b/docs/api-reference/customer/get-customer-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, retrieve a cust
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Get a specific customer by ID
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Slug.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/customers/resource-id-uuid/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/customer/get-customer-property-detail.md b/docs/api-reference/customer/get-customer-property-detail.md
index e29f0459..bba728ac 100644
--- a/docs/api-reference/customer/get-customer-property-detail.md
+++ b/docs/api-reference/customer/get-customer-property-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, retrieve a cust
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/customer-properties/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customer-properties/{property_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Retrieve a specific customer property by ID.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Slug.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/property-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/property-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/property-uuid/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/customer/get-customer-property-value.md b/docs/api-reference/customer/get-customer-property-value.md
index 4b61fa02..e56c2be9 100644
--- a/docs/api-reference/customer/get-customer-property-value.md
+++ b/docs/api-reference/customer/get-customer-property-value.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, retrieve a cust
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{customer_id}/property-values/{property_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{customer_id}/property-values/{property_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Retrieve values for a specific property of a customer.
 
 <ApiParam name="customer_id" type="string" :required="true">
 
-Customer id.
+The unique identifier of the customer.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property id.
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Slug.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/property-values/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/property-values/property-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/property-values/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/property-values/property-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/property-values/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/property-values/property-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/customer/get-customer-request-detail.md b/docs/api-reference/customer/get-customer-request-detail.md
index 84ef2aa0..06e88ce1 100644
--- a/docs/api-reference/customer/get-customer-request-detail.md
+++ b/docs/api-reference/customer/get-customer-request-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, retrieve a cust
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{customer_id}/requests/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{customer_id}/requests/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Get a specific customer request by ID
 
 <ApiParam name="customer_id" type="string" :required="true">
 
-Customer id.
+The unique identifier of the customer.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Slug.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/resource-id-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/customer/link-work-items-to-customer.md b/docs/api-reference/customer/link-work-items-to-customer.md
index 9c30e4f0..22154d53 100644
--- a/docs/api-reference/customer/link-work-items-to-customer.md
+++ b/docs/api-reference/customer/link-work-items-to-customer.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, link work items
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{customer_id}/issues/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{customer_id}/issues/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Link one or more issues to a customer, optionally within a specific customer req
 
 <ApiParam name="customer_id" type="string" :required="true">
 
-Customer id.
+The unique identifier of the customer.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -69,7 +69,7 @@ Array of issue IDs to link
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/issues/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/issues/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -87,7 +87,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/issues/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/issues/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "issue_ids": [
@@ -102,19 +102,16 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/issues/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      issue_ids: ["550e8400-e29b-41d4-a716-446655440000"],
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/issues/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    issue_ids: ["550e8400-e29b-41d4-a716-446655440000"],
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/customer/list-customer-properties.md b/docs/api-reference/customer/list-customer-properties.md
index 23738d5f..541b8430 100644
--- a/docs/api-reference/customer/list-customer-properties.md
+++ b/docs/api-reference/customer/list-customer-properties.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, list all custom
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/customer-properties/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customer-properties/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ List all customer properties in a workspace.
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -50,7 +50,7 @@ Slug.
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/customer/list-customer-property-values.md b/docs/api-reference/customer/list-customer-property-values.md
index 615a986f..9a2a76b4 100644
--- a/docs/api-reference/customer/list-customer-property-values.md
+++ b/docs/api-reference/customer/list-customer-property-values.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, list all custom
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{customer_id}/property-values/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{customer_id}/property-values/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Retrieve all property values for a specific customer.
 
 <ApiParam name="customer_id" type="string" :required="true">
 
-Customer id.
+The unique identifier of the customer.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Slug.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/property-values/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/property-values/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/property-values/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/property-values/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -77,7 +77,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/property-values/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/property-values/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/customer/list-customer-requests.md b/docs/api-reference/customer/list-customer-requests.md
index ab8a9dcc..d80fcef8 100644
--- a/docs/api-reference/customer/list-customer-requests.md
+++ b/docs/api-reference/customer/list-customer-requests.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, list all custom
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{customer_id}/requests/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{customer_id}/requests/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ List all requests for a customer with optional search filtering
 
 <ApiParam name="customer_id" type="string" :required="true">
 
-Customer id.
+The unique identifier of the customer.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Slug.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/customer/list-customer-work-items.md b/docs/api-reference/customer/list-customer-work-items.md
index 6176b9fe..3a307418 100644
--- a/docs/api-reference/customer/list-customer-work-items.md
+++ b/docs/api-reference/customer/list-customer-work-items.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, list all custom
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{customer_id}/issues/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{customer_id}/issues/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ List all issues linked to a customer, with filtering by request
 
 <ApiParam name="customer_id" type="string" :required="true">
 
-Customer id.
+The unique identifier of the customer.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Slug.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/issues/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/issues/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/issues/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/issues/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/issues/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/issues/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/customer/list-customers.md b/docs/api-reference/customer/list-customers.md
index 667c8425..34f4e34c 100644
--- a/docs/api-reference/customer/list-customers.md
+++ b/docs/api-reference/customer/list-customers.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, list all custom
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ List all customers in a workspace with optional search filtering
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -50,7 +50,7 @@ Slug.
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customers/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/customer/unlink-work-item-from-customer.md b/docs/api-reference/customer/unlink-work-item-from-customer.md
index 5feb2f34..ad6c6c50 100644
--- a/docs/api-reference/customer/unlink-work-item-from-customer.md
+++ b/docs/api-reference/customer/unlink-work-item-from-customer.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, unlink work ite
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{customer_id}/issues/{issue_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{customer_id}/issues/{work_item_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Remove the link between an issue and a customer/customer request.
 
 <ApiParam name="customer_id" type="string" :required="true">
 
-Customer id.
+The unique identifier of the customer.
 
 </ApiParam>
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue id.
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Slug.
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/issues/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/issues/work-item-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/issues/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/issues/work-item-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/issues/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/issues/work-item-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/customer/update-customer-detail.md b/docs/api-reference/customer/update-customer-detail.md
index 11d9c89f..cf45ed6e 100644
--- a/docs/api-reference/customer/update-customer-detail.md
+++ b/docs/api-reference/customer/update-customer-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, update a custom
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Update an existing customer with the provided fields.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -159,7 +159,7 @@ Logo asset.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -190,7 +190,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -218,34 +218,31 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "PATCH",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Example Name",
-      description: "example-value",
-      description_html: "<p>Example content</p>",
-      description_stripped: "Example description",
-      email: "Example Name",
-      website_url: "https://example.com/resource",
-      logo_props: "example-value",
-      domain: "Example Name",
-      employees: 1,
-      stage: "Example Name",
-      contract_status: "Example Name",
-      revenue: "Example Name",
-      archived_at: "2024-01-01T00:00:00Z",
-      created_by: "550e8400-e29b-41d4-a716-446655440000",
-      updated_by: "550e8400-e29b-41d4-a716-446655440000",
-      logo_asset: "550e8400-e29b-41d4-a716-446655440000",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/customers/resource-id-uuid/", {
+  method: "PATCH",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Example Name",
+    description: "example-value",
+    description_html: "<p>Example content</p>",
+    description_stripped: "Example description",
+    email: "Example Name",
+    website_url: "https://example.com/resource",
+    logo_props: "example-value",
+    domain: "Example Name",
+    employees: 1,
+    stage: "Example Name",
+    contract_status: "Example Name",
+    revenue: "Example Name",
+    archived_at: "2024-01-01T00:00:00Z",
+    created_by: "550e8400-e29b-41d4-a716-446655440000",
+    updated_by: "550e8400-e29b-41d4-a716-446655440000",
+    logo_asset: "550e8400-e29b-41d4-a716-446655440000",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/customer/update-customer-property-detail.md b/docs/api-reference/customer/update-customer-property-detail.md
index 750379cb..9bf0c0b1 100644
--- a/docs/api-reference/customer/update-customer-property-detail.md
+++ b/docs/api-reference/customer/update-customer-property-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, update a custom
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/customer-properties/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customer-properties/{property_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Update an existing customer property with the provided fields.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -168,7 +168,7 @@ Updated by.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/property-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -201,7 +201,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/property-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "display_name": "Example Name",
@@ -231,34 +231,31 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "PATCH",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      display_name: "Example Name",
-      description: "Example description",
-      logo_props: "example-value",
-      sort_order: 1,
-      property_type: "TEXT",
-      relation_type: "ISSUE",
-      is_required: true,
-      default_value: ["Example Name"],
-      settings: "example-value",
-      is_active: true,
-      is_multi: true,
-      validation_rules: "example-value",
-      external_source: "github",
-      external_id: "550e8400-e29b-41d4-a716-446655440000",
-      created_by: "550e8400-e29b-41d4-a716-446655440000",
-      updated_by: "550e8400-e29b-41d4-a716-446655440000",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/property-uuid/", {
+  method: "PATCH",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    display_name: "Example Name",
+    description: "Example description",
+    logo_props: "example-value",
+    sort_order: 1,
+    property_type: "TEXT",
+    relation_type: "ISSUE",
+    is_required: true,
+    default_value: ["Example Name"],
+    settings: "example-value",
+    is_active: true,
+    is_multi: true,
+    validation_rules: "example-value",
+    external_source: "github",
+    external_id: "550e8400-e29b-41d4-a716-446655440000",
+    created_by: "550e8400-e29b-41d4-a716-446655440000",
+    updated_by: "550e8400-e29b-41d4-a716-446655440000",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/customer/update-customer-property-value.md b/docs/api-reference/customer/update-customer-property-value.md
index 041d31bd..ef8eacd8 100644
--- a/docs/api-reference/customer/update-customer-property-value.md
+++ b/docs/api-reference/customer/update-customer-property-value.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, update a custom
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{customer_id}/property-values/{property_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{customer_id}/property-values/{property_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Update values for a specific property of a customer.
 
 <ApiParam name="customer_id" type="string" :required="true">
 
-Customer id.
+The unique identifier of the customer.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property id.
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -75,7 +75,7 @@ Array of values for the property
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/property-values/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/property-values/property-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -93,7 +93,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/property-values/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/property-values/property-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "values": [
@@ -109,7 +109,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/property-values/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/property-values/property-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/customer/update-customer-request-detail.md b/docs/api-reference/customer/update-customer-request-detail.md
index 3cbf60bb..ceb77f3c 100644
--- a/docs/api-reference/customer/update-customer-request-detail.md
+++ b/docs/api-reference/customer/update-customer-request-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, customer, update a custom
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/customers/{customer_id}/requests/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/customers/{customer_id}/requests/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Update an existing customer request with the provided fields.
 
 <ApiParam name="customer_id" type="string" :required="true">
 
-Customer id.
+The unique identifier of the customer.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -99,7 +99,7 @@ Work item ids.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -121,7 +121,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -141,7 +141,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/550e8400-e29b-41d4-a716-446655440001/requests/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/customers/customer-uuid/requests/resource-id-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/cycle/add-cycle-work-items.md b/docs/api-reference/cycle/add-cycle-work-items.md
index cb4e7106..37b438c4 100644
--- a/docs/api-reference/cycle/add-cycle-work-items.md
+++ b/docs/api-reference/cycle/add-cycle-work-items.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, cycle, add work items to
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/cycles/{cycle_id}/cycle-issues/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/{cycle_id}/cycle-issues/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Assign multiple work items to a cycle. Automatically handles bulk creation and u
 
 <ApiParam name="cycle_id" type="string" :required="true">
 
-Cycle id.
+The unique identifier of the cycle.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -75,7 +75,7 @@ List of issue IDs to add to the cycle
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/cycle-issues/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/cycle-issues/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -94,7 +94,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/cycle-issues/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/cycle-issues/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "issues": [
@@ -111,7 +111,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/cycle-issues/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/cycle-issues/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/cycle/add-cycle.md b/docs/api-reference/cycle/add-cycle.md
index c8583509..402b2a4c 100644
--- a/docs/api-reference/cycle/add-cycle.md
+++ b/docs/api-reference/cycle/add-cycle.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, cycle, create a cycle
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/cycles/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Create a new development cycle with specified name, description, and date range.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -543,7 +543,7 @@ External id.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -564,7 +564,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -582,24 +582,21 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Example Name",
-      description: "Example description",
-      start_date: "2024-01-01T00:00:00Z",
-      end_date: "2024-01-01T00:00:00Z",
-      external_id: "550e8400-e29b-41d4-a716-446655440000",
-      external_source: "github",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Example Name",
+    description: "Example description",
+    start_date: "2024-01-01T00:00:00Z",
+    end_date: "2024-01-01T00:00:00Z",
+    external_id: "550e8400-e29b-41d4-a716-446655440000",
+    external_source: "github",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/cycle/archive-cycle.md b/docs/api-reference/cycle/archive-cycle.md
index c5338049..f57d6278 100644
--- a/docs/api-reference/cycle/archive-cycle.md
+++ b/docs/api-reference/cycle/archive-cycle.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, cycle, archive a cycle
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/cycles/{cycle_id}/archive/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/{cycle_id}/archive/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Move a completed cycle to archived status for historical tracking. Only cycles t
 
 <ApiParam name="cycle_id" type="string" :required="true">
 
-Cycle id.
+The unique identifier of the cycle.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/archive/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/archive/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/archive/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/archive/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/archive/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/archive/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/cycle/delete-cycle.md b/docs/api-reference/cycle/delete-cycle.md
index 99ed115f..7a746916 100644
--- a/docs/api-reference/cycle/delete-cycle.md
+++ b/docs/api-reference/cycle/delete-cycle.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, cycle, delete a cycle
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/cycles/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Permanently remove a cycle and all its associated issue relationships
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/resource-id-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/cycle/get-cycle-detail.md b/docs/api-reference/cycle/get-cycle-detail.md
index 8983676c..896f7810 100644
--- a/docs/api-reference/cycle/get-cycle-detail.md
+++ b/docs/api-reference/cycle/get-cycle-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, cycle, retrieve a cycle
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/cycles/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Retrieve details of a specific cycle by its ID. Supports cycle status filtering.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/resource-id-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/cycle/list-archived-cycles.md b/docs/api-reference/cycle/list-archived-cycles.md
index a9ceb777..108becdf 100644
--- a/docs/api-reference/cycle/list-archived-cycles.md
+++ b/docs/api-reference/cycle/list-archived-cycles.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, cycle, list all archived
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/archived-cycles/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/archived-cycles/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Retrieve all cycles that have been archived in the project.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -75,9 +75,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archived-cycles/?cursor=20:1:0&per_page=20" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archived-cycles/?cursor=20:1:0&per_page=20" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -87,7 +87,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archived-cycles/?cursor=20:1:0&per_page=20",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archived-cycles/?cursor=20:1:0&per_page=20",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -98,7 +98,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archived-cycles/?cursor=20:1:0&per_page=20",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archived-cycles/?cursor=20:1:0&per_page=20",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/cycle/list-cycle-work-items.md b/docs/api-reference/cycle/list-cycle-work-items.md
index baedbf55..9273c5e8 100644
--- a/docs/api-reference/cycle/list-cycle-work-items.md
+++ b/docs/api-reference/cycle/list-cycle-work-items.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, cycle, list all work item
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/cycles/{cycle_id}/cycle-issues/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/{cycle_id}/cycle-issues/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Retrieve all work items assigned to a cycle.
 
 <ApiParam name="cycle_id" type="string" :required="true">
 
-Cycle id.
+The unique identifier of the cycle.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -81,9 +81,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/cycle-issues/?cursor=20:1:0&per_page=20" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/cycle-issues/?cursor=20:1:0&per_page=20" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -93,7 +93,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/cycle-issues/?cursor=20:1:0&per_page=20",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/cycle-issues/?cursor=20:1:0&per_page=20",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -104,7 +104,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/cycle-issues/?cursor=20:1:0&per_page=20",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/cycle-issues/?cursor=20:1:0&per_page=20",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/cycle/list-cycles.md b/docs/api-reference/cycle/list-cycles.md
index 978cf750..cc49c962 100644
--- a/docs/api-reference/cycle/list-cycles.md
+++ b/docs/api-reference/cycle/list-cycles.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, cycle, list all cycles
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/cycles/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Retrieve all cycles in a project. Supports filtering by cycle status like curren
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -99,9 +99,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/?cursor=20:1:0&cycle_view=all" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/?cursor=20:1:0&cycle_view=all" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -111,7 +111,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/?cursor=20:1:0&cycle_view=all",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/?cursor=20:1:0&cycle_view=all",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -122,7 +122,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/?cursor=20:1:0&cycle_view=all",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/?cursor=20:1:0&cycle_view=all",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/cycle/remove-cycle-work-item.md b/docs/api-reference/cycle/remove-cycle-work-item.md
index 7dbd1f4c..1f86caff 100644
--- a/docs/api-reference/cycle/remove-cycle-work-item.md
+++ b/docs/api-reference/cycle/remove-cycle-work-item.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, cycle, remove work item f
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/cycles/{cycle_id}/cycle-issues/{issue_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/{cycle_id}/cycle-issues/{work_item_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Remove a work item from a cycle while keeping the work item in the project.
 
 <ApiParam name="cycle_id" type="string" :required="true">
 
-Cycle id.
+The unique identifier of the cycle.
 
 </ApiParam>
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue id.
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/cycle-issues/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/cycle-issues/work-item-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/cycle-issues/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/cycle-issues/work-item-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -89,7 +89,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/cycle-issues/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/cycle-issues/work-item-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/cycle/transfer-cycle-work-items.md b/docs/api-reference/cycle/transfer-cycle-work-items.md
index 754f91dc..9987cc95 100644
--- a/docs/api-reference/cycle/transfer-cycle-work-items.md
+++ b/docs/api-reference/cycle/transfer-cycle-work-items.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, cycle, transfer cycle wor
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/cycles/{cycle_id}/transfer-issues/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/{cycle_id}/transfer-issues/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Move incomplete work items from the current cycle to a new target cycle. Capture
 
 <ApiParam name="cycle_id" type="string" :required="true">
 
-Cycle id.
+The unique identifier of the cycle.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -75,7 +75,7 @@ ID of the target cycle to transfer issues to
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/transfer-issues/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/transfer-issues/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -91,7 +91,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/transfer-issues/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/transfer-issues/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "new_cycle_id": "550e8400-e29b-41d4-a716-446655440000"
@@ -105,7 +105,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440001/transfer-issues/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/cycle-uuid/transfer-issues/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/cycle/unarchive-cycle.md b/docs/api-reference/cycle/unarchive-cycle.md
index 8ea4b333..1caa1c2f 100644
--- a/docs/api-reference/cycle/unarchive-cycle.md
+++ b/docs/api-reference/cycle/unarchive-cycle.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, cycle, restore a cycle
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/archived-cycles/{cycle_id}/unarchive/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/archived-cycles/{cycle_id}/unarchive/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Restore an archived cycle to active status, making it available for regular use.
 
 <ApiParam name="cycle_id" type="string" :required="true">
 
-Cycle id.
+The unique identifier of the cycle.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archived-cycles/550e8400-e29b-41d4-a716-446655440001/unarchive/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archived-cycles/cycle-uuid/unarchive/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archived-cycles/550e8400-e29b-41d4-a716-446655440001/unarchive/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archived-cycles/cycle-uuid/unarchive/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archived-cycles/550e8400-e29b-41d4-a716-446655440001/unarchive/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archived-cycles/cycle-uuid/unarchive/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/cycle/update-cycle-detail.md b/docs/api-reference/cycle/update-cycle-detail.md
index ef789eae..0e38fc17 100644
--- a/docs/api-reference/cycle/update-cycle-detail.md
+++ b/docs/api-reference/cycle/update-cycle-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, cycle, update a cycle
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/cycles/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Modify an existing cycle's properties like name, description, or date range. Com
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -549,7 +549,7 @@ External id.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -570,7 +570,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -589,7 +589,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/cycles/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/cycles/resource-id-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/epics/get-epic-detail.md b/docs/api-reference/epics/get-epic-detail.md
index c43d7e0e..c9e4e559 100644
--- a/docs/api-reference/epics/get-epic-detail.md
+++ b/docs/api-reference/epics/get-epic-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, epics, retrieve an epic
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/epics/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/epics/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Retrieve an epic by id
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -75,9 +75,9 @@ Comma-separated list of fields to include in response
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/epics/550e8400-e29b-41d4-a716-446655440000/?fields=id,name,description" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/epics/resource-id-uuid/?fields=id,name,description" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -87,7 +87,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/epics/550e8400-e29b-41d4-a716-446655440000/?fields=id,name,description",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/epics/resource-id-uuid/?fields=id,name,description",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -98,7 +98,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/epics/550e8400-e29b-41d4-a716-446655440000/?fields=id,name,description",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/epics/resource-id-uuid/?fields=id,name,description",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/epics/list-epics.md b/docs/api-reference/epics/list-epics.md
index 12dca05d..66fe0a30 100644
--- a/docs/api-reference/epics/list-epics.md
+++ b/docs/api-reference/epics/list-epics.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, epics, list all epics
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/epics/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/epics/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ List epics
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -75,9 +75,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/epics/?cursor=20:1:0&per_page=20" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/epics/?cursor=20:1:0&per_page=20" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -87,7 +87,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/epics/?cursor=20:1:0&per_page=20",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/epics/?cursor=20:1:0&per_page=20",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -98,7 +98,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/epics/?cursor=20:1:0&per_page=20",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/epics/?cursor=20:1:0&per_page=20",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/estimate/add-estimate-points.md b/docs/api-reference/estimate/add-estimate-points.md
index 75b35ad8..bd3d6df7 100644
--- a/docs/api-reference/estimate/add-estimate-points.md
+++ b/docs/api-reference/estimate/add-estimate-points.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, estimate points, create e
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/estimates/{estimate_id}/estimate-points/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/estimates/{estimate_id}/estimate-points/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Create estimate points for a project estimate. You can send a JSON array directl
 
 <ApiParam name="estimate_id" type="string" :required="true">
 
-Estimate ID
+The unique identifier of the estimate.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -76,7 +76,7 @@ Array of estimate point objects. Each object can include: `value` (string, requi
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/550e8400-e29b-41d4-a716-446655440000/estimate-points/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/estimate-uuid/estimate-points/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -101,7 +101,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/550e8400-e29b-41d4-a716-446655440000/estimate-points/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/estimate-uuid/estimate-points/",
     headers={"X-API-Key": "your-api-key"},
     json=[
         {"key": 1, "value": "1", "description": "Tiny"},
@@ -116,7 +116,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/550e8400-e29b-41d4-a716-446655440000/estimate-points/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/estimate-uuid/estimate-points/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/estimate/add-estimate.md b/docs/api-reference/estimate/add-estimate.md
index 15bdeb10..3ba658db 100644
--- a/docs/api-reference/estimate/add-estimate.md
+++ b/docs/api-reference/estimate/add-estimate.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, estimates, create an esti
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/estimates/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/estimates/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Create a new estimate for the project.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -99,7 +99,7 @@ External source identifier.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -117,7 +117,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/",
     headers={"X-API-Key": "your-api-key"},
     json={
         "name": "Story Points",
@@ -132,21 +132,18 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Story Points",
-      description: "Standard story point scale",
-      type: "points",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Story Points",
+    description: "Standard story point scale",
+    type: "points",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/estimate/delete-estimate-point.md b/docs/api-reference/estimate/delete-estimate-point.md
index 7066abff..948c4d22 100644
--- a/docs/api-reference/estimate/delete-estimate-point.md
+++ b/docs/api-reference/estimate/delete-estimate-point.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, estimate points, delete a
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/estimates/{estimate_id}/estimate-points/{estimate_point_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/estimates/{estimate_id}/estimate-points/{estimate_point_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Delete a single estimate point from a project estimate.
 
 <ApiParam name="estimate_point_id" type="string" :required="true">
 
-Estimate point ID
+The unique identifier of the estimate point.
 
 </ApiParam>
 
 <ApiParam name="estimate_id" type="string" :required="true">
 
-Estimate ID
+The unique identifier of the estimate.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -66,7 +66,7 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/550e8400-e29b-41d4-a716-446655440000/estimate-points/550e8400-e29b-41d4-a716-446655440010/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/estimate-uuid/estimate-points/estimate-point-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
@@ -78,7 +78,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/550e8400-e29b-41d4-a716-446655440000/estimate-points/550e8400-e29b-41d4-a716-446655440010/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/estimate-uuid/estimate-points/estimate-point-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -89,7 +89,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/550e8400-e29b-41d4-a716-446655440000/estimate-points/550e8400-e29b-41d4-a716-446655440010/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/estimate-uuid/estimate-points/estimate-point-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/estimate/delete-estimate.md b/docs/api-reference/estimate/delete-estimate.md
index 97da4a77..2369b756 100644
--- a/docs/api-reference/estimate/delete-estimate.md
+++ b/docs/api-reference/estimate/delete-estimate.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, estimates, delete an esti
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/estimates/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/estimates/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Delete the estimate configured for a project.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,7 +54,7 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -76,15 +76,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/estimate/get-estimate.md b/docs/api-reference/estimate/get-estimate.md
index 518b78b5..6f8a9833 100644
--- a/docs/api-reference/estimate/get-estimate.md
+++ b/docs/api-reference/estimate/get-estimate.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, estimates, get an estimat
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/estimates/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/estimates/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Retrieve the estimate configured for a project.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,7 +54,7 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/estimate/list-estimate-points.md b/docs/api-reference/estimate/list-estimate-points.md
index 57f0287c..639fe99a 100644
--- a/docs/api-reference/estimate/list-estimate-points.md
+++ b/docs/api-reference/estimate/list-estimate-points.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, estimate points, list est
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/estimates/{estimate_id}/estimate-points/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/estimates/{estimate_id}/estimate-points/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Retrieve all estimate points for a project estimate.
 
 <ApiParam name="estimate_id" type="string" :required="true">
 
-Estimate ID
+The unique identifier of the estimate.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,7 +60,7 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/550e8400-e29b-41d4-a716-446655440000/estimate-points/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/estimate-uuid/estimate-points/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/550e8400-e29b-41d4-a716-446655440000/estimate-points/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/estimate-uuid/estimate-points/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/550e8400-e29b-41d4-a716-446655440000/estimate-points/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/estimate-uuid/estimate-points/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/estimate/update-estimate-point.md b/docs/api-reference/estimate/update-estimate-point.md
index 624c6a70..198c35d0 100644
--- a/docs/api-reference/estimate/update-estimate-point.md
+++ b/docs/api-reference/estimate/update-estimate-point.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, estimate points, update a
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/estimates/{estimate_id}/estimate-points/{estimate_point_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/estimates/{estimate_id}/estimate-points/{estimate_point_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Update a single estimate point for a project estimate.
 
 <ApiParam name="estimate_point_id" type="string" :required="true">
 
-Estimate point ID
+The unique identifier of the estimate point.
 
 </ApiParam>
 
 <ApiParam name="estimate_id" type="string" :required="true">
 
-Estimate ID
+The unique identifier of the estimate.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -105,7 +105,7 @@ External source identifier.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/550e8400-e29b-41d4-a716-446655440000/estimate-points/550e8400-e29b-41d4-a716-446655440010/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/estimate-uuid/estimate-points/estimate-point-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -122,7 +122,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/550e8400-e29b-41d4-a716-446655440000/estimate-points/550e8400-e29b-41d4-a716-446655440010/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/estimate-uuid/estimate-points/estimate-point-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={"value": "3", "description": "Small"},
 )
@@ -134,7 +134,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/550e8400-e29b-41d4-a716-446655440000/estimate-points/550e8400-e29b-41d4-a716-446655440010/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/estimate-uuid/estimate-points/estimate-point-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/estimate/update-estimate.md b/docs/api-reference/estimate/update-estimate.md
index 42c734f4..8ea1c691 100644
--- a/docs/api-reference/estimate/update-estimate.md
+++ b/docs/api-reference/estimate/update-estimate.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, estimates, update an esti
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/estimates/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/estimates/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Update the estimate for a project. Only fields provided in the request will be u
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -87,7 +87,7 @@ External source identifier.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -103,7 +103,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/",
     headers={"X-API-Key": "your-api-key"},
     json={"description": "Updated story point scale"},
 )
@@ -114,19 +114,16 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/estimates/",
-  {
-    method: "PATCH",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      description: "Updated story point scale",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/estimates/", {
+  method: "PATCH",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    description: "Updated story point scale",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/initiative/add-epics-to-initiative.md b/docs/api-reference/initiative/add-epics-to-initiative.md
index 546542f9..e8472885 100644
--- a/docs/api-reference/initiative/add-epics-to-initiative.md
+++ b/docs/api-reference/initiative/add-epics-to-initiative.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, add epics to
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/{initiative_id}/epics/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/epics/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Add epics to an initiative by its ID
 
 <ApiParam name="initiative_id" type="string" :required="true">
 
-Initiative ID
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -69,7 +69,7 @@ Epic ids.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/epics/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/epics/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -87,7 +87,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/epics/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/epics/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "epic_ids": [
@@ -102,19 +102,16 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/epics/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      epic_ids: ["550e8400-e29b-41d4-a716-446655440000"],
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/epics/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    epic_ids: ["550e8400-e29b-41d4-a716-446655440000"],
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/initiative/add-initiative-label.md b/docs/api-reference/initiative/add-initiative-label.md
index c8dff09d..7c154990 100644
--- a/docs/api-reference/initiative/add-initiative-label.md
+++ b/docs/api-reference/initiative/add-initiative-label.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, create an ini
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/labels/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/labels/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Create a new initiative label in the workspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/initiative/add-initiative.md b/docs/api-reference/initiative/add-initiative.md
index c36d363a..57c8a6ae 100644
--- a/docs/api-reference/initiative/add-initiative.md
+++ b/docs/api-reference/initiative/add-initiative.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, create an ini
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Create a new initiative in the workspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/initiative/add-labels-to-initiative.md b/docs/api-reference/initiative/add-labels-to-initiative.md
index 237f4bec..245ad081 100644
--- a/docs/api-reference/initiative/add-labels-to-initiative.md
+++ b/docs/api-reference/initiative/add-labels-to-initiative.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, add labels to
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/{initiative_id}/labels/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/labels/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Add labels to an initiative by its ID
 
 <ApiParam name="initiative_id" type="string" :required="true">
 
-Initiative ID
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -69,7 +69,7 @@ Label ids.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/labels/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/labels/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -87,7 +87,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/labels/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/labels/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "label_ids": [
@@ -103,7 +103,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/labels/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/labels/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/initiative/add-projects-to-initiative.md b/docs/api-reference/initiative/add-projects-to-initiative.md
index 2aa0a9c9..514f864e 100644
--- a/docs/api-reference/initiative/add-projects-to-initiative.md
+++ b/docs/api-reference/initiative/add-projects-to-initiative.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, add projects
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/{initiative_id}/projects/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/projects/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Add projects to an initiative by its ID
 
 <ApiParam name="initiative_id" type="string" :required="true">
 
-Initiative ID
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -69,7 +69,7 @@ Project ids.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/projects/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/projects/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -87,7 +87,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/projects/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/projects/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "project_ids": [
@@ -103,7 +103,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/projects/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/projects/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/initiative/delete-initiative-label.md b/docs/api-reference/initiative/delete-initiative-label.md
index 2b570181..33fff1f6 100644
--- a/docs/api-reference/initiative/delete-initiative-label.md
+++ b/docs/api-reference/initiative/delete-initiative-label.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, delete an ini
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/labels/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/labels/{label_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Delete an initiative label by its ID
 
 <ApiParam name="initiative_label_id" type="string" :required="true">
 
-Initiative label ID
+The unique identifier of the initiative label.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="label_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the label.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/label-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/label-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -82,15 +82,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/label-uuid/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/initiative/delete-initiative.md b/docs/api-reference/initiative/delete-initiative.md
index c0715537..568e2bab 100644
--- a/docs/api-reference/initiative/delete-initiative.md
+++ b/docs/api-reference/initiative/delete-initiative.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, delete an ini
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Delete an initiative by its ID
 
 <ApiParam name="initiative_id" type="string" :required="true">
 
-Initiative ID
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="initiative_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -82,15 +82,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/initiative/get-initiative-detail.md b/docs/api-reference/initiative/get-initiative-detail.md
index a18e6cf1..44a27990 100644
--- a/docs/api-reference/initiative/get-initiative-detail.md
+++ b/docs/api-reference/initiative/get-initiative-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, retrieve an i
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Retrieve an initiative by its ID
 
 <ApiParam name="initiative_id" type="string" :required="true">
 
-Initiative ID
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="initiative_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -82,15 +82,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/initiative/get-initiative-label-detail.md b/docs/api-reference/initiative/get-initiative-label-detail.md
index bac42713..50cabd61 100644
--- a/docs/api-reference/initiative/get-initiative-label-detail.md
+++ b/docs/api-reference/initiative/get-initiative-label-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, retrieve an i
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/labels/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/labels/{label_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Retrieve an initiative label by its ID
 
 <ApiParam name="initiative_label_id" type="string" :required="true">
 
-Initiative label ID
+The unique identifier of the initiative label.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="label_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the label.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/label-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/label-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -82,15 +82,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/label-uuid/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/initiative/list-initiative-epics.md b/docs/api-reference/initiative/list-initiative-epics.md
index be387e8f..acc4de4d 100644
--- a/docs/api-reference/initiative/list-initiative-epics.md
+++ b/docs/api-reference/initiative/list-initiative-epics.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, list all epic
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/{initiative_id}/epics/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/epics/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ List all epics associated with an initiative
 
 <ApiParam name="initiative_id" type="string" :required="true">
 
-Initiative ID
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -75,9 +75,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/epics/?cursor=20:1:0&per_page=20" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/epics/?cursor=20:1:0&per_page=20" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -87,7 +87,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/epics/?cursor=20:1:0&per_page=20",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/epics/?cursor=20:1:0&per_page=20",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -98,7 +98,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/epics/?cursor=20:1:0&per_page=20",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/epics/?cursor=20:1:0&per_page=20",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/initiative/list-initiative-labels-for-initiative.md b/docs/api-reference/initiative/list-initiative-labels-for-initiative.md
index 6e2fdcff..b588edfe 100644
--- a/docs/api-reference/initiative/list-initiative-labels-for-initiative.md
+++ b/docs/api-reference/initiative/list-initiative-labels-for-initiative.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, list all labe
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/{initiative_id}/labels/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/labels/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ List all labels associated with an initiative
 
 <ApiParam name="initiative_id" type="string" :required="true">
 
-Initiative ID
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -75,9 +75,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/labels/?cursor=20:1:0&per_page=20" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/labels/?cursor=20:1:0&per_page=20" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -87,7 +87,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/labels/?cursor=20:1:0&per_page=20",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/labels/?cursor=20:1:0&per_page=20",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -98,7 +98,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/labels/?cursor=20:1:0&per_page=20",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/labels/?cursor=20:1:0&per_page=20",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/initiative/list-initiative-labels.md b/docs/api-reference/initiative/list-initiative-labels.md
index 97b20d89..d8d6f1e2 100644
--- a/docs/api-reference/initiative/list-initiative-labels.md
+++ b/docs/api-reference/initiative/list-initiative-labels.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, list all init
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/labels/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/labels/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ List all initiative labels in the workspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -71,7 +71,7 @@ Number of results per page (default: 20, max: 100)
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/?cursor=20:1:0&per_page=20" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/initiative/list-initiative-projects.md b/docs/api-reference/initiative/list-initiative-projects.md
index aac3d6c4..173e9d61 100644
--- a/docs/api-reference/initiative/list-initiative-projects.md
+++ b/docs/api-reference/initiative/list-initiative-projects.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, list all proj
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/{initiative_id}/projects/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/projects/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ List all projects associated with an initiative
 
 <ApiParam name="initiative_id" type="string" :required="true">
 
-Initiative ID
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -75,9 +75,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/projects/?cursor=20:1:0&per_page=20" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/projects/?cursor=20:1:0&per_page=20" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -87,7 +87,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/projects/?cursor=20:1:0&per_page=20",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/projects/?cursor=20:1:0&per_page=20",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -98,7 +98,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/projects/?cursor=20:1:0&per_page=20",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/projects/?cursor=20:1:0&per_page=20",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/initiative/list-initiatives.md b/docs/api-reference/initiative/list-initiatives.md
index b93d5a3f..8a184886 100644
--- a/docs/api-reference/initiative/list-initiatives.md
+++ b/docs/api-reference/initiative/list-initiatives.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, list all init
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ List all initiatives in the workspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -71,7 +71,7 @@ Number of results per page (default: 20, max: 100)
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/?cursor=20:1:0&per_page=20" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/initiative/remove-epics-from-initiative.md b/docs/api-reference/initiative/remove-epics-from-initiative.md
index 3f8bd7b9..f57559f4 100644
--- a/docs/api-reference/initiative/remove-epics-from-initiative.md
+++ b/docs/api-reference/initiative/remove-epics-from-initiative.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, remove epics
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/{initiative_id}/epics/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/epics/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Remove epics from an initiative by its ID
 
 <ApiParam name="initiative_id" type="string" :required="true">
 
-Initiative ID
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/epics/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/epics/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/epics/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/epics/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -76,15 +76,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/epics/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/epics/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/initiative/remove-labels-from-initiative.md b/docs/api-reference/initiative/remove-labels-from-initiative.md
index 48aee1c7..d2fd8254 100644
--- a/docs/api-reference/initiative/remove-labels-from-initiative.md
+++ b/docs/api-reference/initiative/remove-labels-from-initiative.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, remove labels
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/{initiative_id}/labels/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/labels/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Remove labels from an initiative by its ID
 
 <ApiParam name="initiative_id" type="string" :required="true">
 
-Initiative ID
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/labels/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/labels/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/labels/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/labels/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -77,7 +77,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/labels/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/labels/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/initiative/remove-projects-from-initiative.md b/docs/api-reference/initiative/remove-projects-from-initiative.md
index c016eeda..4c7f9101 100644
--- a/docs/api-reference/initiative/remove-projects-from-initiative.md
+++ b/docs/api-reference/initiative/remove-projects-from-initiative.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, remove projec
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/{initiative_id}/projects/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/projects/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Remove projects from an initiative by its ID
 
 <ApiParam name="initiative_id" type="string" :required="true">
 
-Initiative ID
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/projects/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/projects/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/projects/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/projects/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -77,7 +77,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440001/projects/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/projects/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/initiative/update-initiative-detail.md b/docs/api-reference/initiative/update-initiative-detail.md
index a2322177..879c30f9 100644
--- a/docs/api-reference/initiative/update-initiative-detail.md
+++ b/docs/api-reference/initiative/update-initiative-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, update an ini
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/{initiative_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Update an initiative by its ID
 
 <ApiParam name="initiative_id" type="string" :required="true">
 
-Initiative ID
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="initiative_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the initiative.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -145,7 +145,7 @@ Lead.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -172,7 +172,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -196,30 +196,27 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "PATCH",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Example Name",
-      description: "Example description",
-      description_html: "<p>Example content</p>",
-      description_stripped: "Example description",
-      start_date: "2024-01-01T00:00:00Z",
-      end_date: "2024-01-01T00:00:00Z",
-      logo_props: "example-value",
-      state: "DRAFT",
-      archived_at: "2024-01-01T00:00:00Z",
-      created_by: "550e8400-e29b-41d4-a716-446655440000",
-      updated_by: "550e8400-e29b-41d4-a716-446655440000",
-      lead: "550e8400-e29b-41d4-a716-446655440000",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/initiative-uuid/", {
+  method: "PATCH",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Example Name",
+    description: "Example description",
+    description_html: "<p>Example content</p>",
+    description_stripped: "Example description",
+    start_date: "2024-01-01T00:00:00Z",
+    end_date: "2024-01-01T00:00:00Z",
+    logo_props: "example-value",
+    state: "DRAFT",
+    archived_at: "2024-01-01T00:00:00Z",
+    created_by: "550e8400-e29b-41d4-a716-446655440000",
+    updated_by: "550e8400-e29b-41d4-a716-446655440000",
+    lead: "550e8400-e29b-41d4-a716-446655440000",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/initiative/update-initiative-label-detail.md b/docs/api-reference/initiative/update-initiative-label-detail.md
index e8a19901..2398bf31 100644
--- a/docs/api-reference/initiative/update-initiative-label-detail.md
+++ b/docs/api-reference/initiative/update-initiative-label-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, initiative, update an ini
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/initiatives/labels/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/initiatives/labels/{label_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Update an initiative label by its ID
 
 <ApiParam name="initiative_label_id" type="string" :required="true">
 
-Initiative label ID
+The unique identifier of the initiative label.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="label_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the label.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -93,7 +93,7 @@ Sort order.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/label-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -112,7 +112,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/label-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -128,22 +128,19 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "PATCH",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Example Name",
-      description: "Example description",
-      color: "Example Name",
-      sort_order: 1,
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/initiatives/labels/label-uuid/", {
+  method: "PATCH",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Example Name",
+    description: "Example description",
+    color: "Example Name",
+    sort_order: 1,
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/intake-issue/add-intake-issue.md b/docs/api-reference/intake-issue/add-intake-issue.md
index 9656f9d3..40fc3d32 100644
--- a/docs/api-reference/intake-issue/add-intake-issue.md
+++ b/docs/api-reference/intake-issue/add-intake-issue.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, intake issue, create an i
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/intake-issues/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/intake-issues/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Submit a new work item to the project's intake queue for review and triage. Auto
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -69,7 +69,7 @@ Issue data for the intake issue
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -89,7 +89,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "issue": {
@@ -107,7 +107,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/intake-issue/delete-intake-issue.md b/docs/api-reference/intake-issue/delete-intake-issue.md
index 200f0cb8..808bf809 100644
--- a/docs/api-reference/intake-issue/delete-intake-issue.md
+++ b/docs/api-reference/intake-issue/delete-intake-issue.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, intake issue, delete an i
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/intake-issues/{issue_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/intake-issues/{work_item_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Permanently remove an intake work item from the triage queue. Also deletes the u
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/work-item-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/work-item-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/work-item-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/intake-issue/get-intake-issue-detail.md b/docs/api-reference/intake-issue/get-intake-issue-detail.md
index f16c3073..d5dc317f 100644
--- a/docs/api-reference/intake-issue/get-intake-issue-detail.md
+++ b/docs/api-reference/intake-issue/get-intake-issue-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, intake issue, retrieve an
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/intake-issues/{issue_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/intake-issues/{work_item_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Retrieve details of a specific intake work item.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/work-item-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/work-item-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/work-item-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/intake-issue/list-intake-issues.md b/docs/api-reference/intake-issue/list-intake-issues.md
index b26c02c8..5ebf8b32 100644
--- a/docs/api-reference/intake-issue/list-intake-issues.md
+++ b/docs/api-reference/intake-issue/list-intake-issues.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, intake issue, list all in
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/intake-issues/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/intake-issues/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Retrieve all work items in the project's intake queue. Returns paginated results
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -87,9 +87,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/?cursor=20:1:0&expand=assignees" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -99,7 +99,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/?cursor=20:1:0&expand=assignees",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/?cursor=20:1:0&expand=assignees",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -110,7 +110,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/?cursor=20:1:0&expand=assignees",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/?cursor=20:1:0&expand=assignees",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/intake-issue/update-intake-issue-detail.md b/docs/api-reference/intake-issue/update-intake-issue-detail.md
index 9709ca93..a1fc4d3b 100644
--- a/docs/api-reference/intake-issue/update-intake-issue-detail.md
+++ b/docs/api-reference/intake-issue/update-intake-issue-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, intake issue, update an i
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/intake-issues/{issue_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/intake-issues/{work_item_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Modify an existing intake work item's properties or status for triage processing
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -109,7 +109,7 @@ Issue data to update in the intake issue
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/work-item-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -130,7 +130,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/work-item-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "status": 1,
@@ -149,7 +149,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/intake-issues/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/intake-issues/work-item-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/issue-activity/get-issue-activity-detail.md b/docs/api-reference/issue-activity/get-issue-activity-detail.md
index 45afdaf9..fbeb1fb9 100644
--- a/docs/api-reference/issue-activity/get-issue-activity-detail.md
+++ b/docs/api-reference/issue-activity/get-issue-activity-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue activity, retrieve
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/activities/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/activities/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Retrieve details of a specific activity.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Activity ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -105,9 +105,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/activities/550e8400-e29b-41d4-a716-446655440000/?cursor=20:1:0&expand=assignees" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/activities/resource-id-uuid/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -117,7 +117,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/activities/550e8400-e29b-41d4-a716-446655440000/?cursor=20:1:0&expand=assignees",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/activities/resource-id-uuid/?cursor=20:1:0&expand=assignees",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -128,7 +128,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/activities/550e8400-e29b-41d4-a716-446655440000/?cursor=20:1:0&expand=assignees",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/activities/resource-id-uuid/?cursor=20:1:0&expand=assignees",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-activity/list-issue-activities.md b/docs/api-reference/issue-activity/list-issue-activities.md
index d00477cb..5c699d09 100644
--- a/docs/api-reference/issue-activity/list-issue-activities.md
+++ b/docs/api-reference/issue-activity/list-issue-activities.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue activity, list all
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/activities/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/activities/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Retrieve all activities for a work item. Supports filtering by activity type and
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -99,9 +99,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/activities/?cursor=20:1:0&expand=assignees" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/activities/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -111,7 +111,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/activities/?cursor=20:1:0&expand=assignees",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/activities/?cursor=20:1:0&expand=assignees",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -122,7 +122,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/activities/?cursor=20:1:0&expand=assignees",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/activities/?cursor=20:1:0&expand=assignees",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-attachments/complete-upload.md b/docs/api-reference/issue-attachments/complete-upload.md
index 2da081be..01976d82 100644
--- a/docs/api-reference/issue-attachments/complete-upload.md
+++ b/docs/api-reference/issue-attachments/complete-upload.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue attachments, comple
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/attachments/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/attachments/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Mark an attachment as uploaded after successful file transfer to storage.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue id.
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Attachment ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -81,7 +81,7 @@ Mark attachment as uploaded
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -97,7 +97,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "is_uploaded": true
@@ -111,7 +111,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/resource-id-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/issue-attachments/delete-attachment.md b/docs/api-reference/issue-attachments/delete-attachment.md
index ab49c32b..34943c99 100644
--- a/docs/api-reference/issue-attachments/delete-attachment.md
+++ b/docs/api-reference/issue-attachments/delete-attachment.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue attachments, delete
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/attachments/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/attachments/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Permanently remove an attachment from a work item. Records deletion activity for
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue id.
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Attachment ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -89,7 +89,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/resource-id-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/issue-attachments/get-attachment-detail.md b/docs/api-reference/issue-attachments/get-attachment-detail.md
index d641d69c..d6993ad7 100644
--- a/docs/api-reference/issue-attachments/get-attachment-detail.md
+++ b/docs/api-reference/issue-attachments/get-attachment-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue attachments, retrie
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/attachments/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/attachments/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Download attachment file. Returns a redirect to the presigned download URL.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue id.
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Attachment ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -89,7 +89,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/resource-id-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-attachments/get-attachments.md b/docs/api-reference/issue-attachments/get-attachments.md
index 50fb9ac4..10e06341 100644
--- a/docs/api-reference/issue-attachments/get-attachments.md
+++ b/docs/api-reference/issue-attachments/get-attachments.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue attachments, list a
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/attachments/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/attachments/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Retrieve all attachments for a work item.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-attachments/get-upload-credentials.md b/docs/api-reference/issue-attachments/get-upload-credentials.md
index d63974fe..53e85f41 100644
--- a/docs/api-reference/issue-attachments/get-upload-credentials.md
+++ b/docs/api-reference/issue-attachments/get-upload-credentials.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue attachments, get up
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/attachments/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/attachments/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Generate presigned URL for uploading file attachments to a work item.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -99,7 +99,7 @@ External source system (for integration tracking)
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -119,7 +119,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -137,7 +137,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/issue-attachments/update-attachment.md b/docs/api-reference/issue-attachments/update-attachment.md
index 0018fdb3..5ab8c208 100644
--- a/docs/api-reference/issue-attachments/update-attachment.md
+++ b/docs/api-reference/issue-attachments/update-attachment.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue attachments, update
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/attachments/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/attachments/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Mark an attachment as uploaded after successful file transfer to storage.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue id.
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Attachment ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -81,7 +81,7 @@ Mark attachment as uploaded
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -97,7 +97,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "is_uploaded": true
@@ -111,7 +111,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/attachments/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/attachments/resource-id-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/issue-comment/add-issue-comment.md b/docs/api-reference/issue-comment/add-issue-comment.md
index 8a7f8534..8e86833e 100644
--- a/docs/api-reference/issue-comment/add-issue-comment.md
+++ b/docs/api-reference/issue-comment/add-issue-comment.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue comment, create a w
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/comments/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/comments/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Add a new comment to a work item with HTML content.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -106,7 +106,7 @@ Parent.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -124,7 +124,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "comment_html": "<p>Example content</p>",
@@ -140,7 +140,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/issue-comment/delete-issue-comment.md b/docs/api-reference/issue-comment/delete-issue-comment.md
index b4df58a9..6e35d5eb 100644
--- a/docs/api-reference/issue-comment/delete-issue-comment.md
+++ b/docs/api-reference/issue-comment/delete-issue-comment.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue comment, delete a w
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/comments/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/comments/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Permanently remove a comment from a work item. Records deletion activity for aud
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Comment ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -89,7 +89,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/resource-id-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/issue-comment/get-issue-comment-detail.md b/docs/api-reference/issue-comment/get-issue-comment-detail.md
index 6a31c878..dfa57c01 100644
--- a/docs/api-reference/issue-comment/get-issue-comment-detail.md
+++ b/docs/api-reference/issue-comment/get-issue-comment-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue comment, retrieve a
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/comments/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/comments/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Retrieve details of a specific comment.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Comment ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -89,7 +89,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/resource-id-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-comment/list-issue-comments.md b/docs/api-reference/issue-comment/list-issue-comments.md
index a4c0bc81..b2b37e10 100644
--- a/docs/api-reference/issue-comment/list-issue-comments.md
+++ b/docs/api-reference/issue-comment/list-issue-comments.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue comment, list all w
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/comments/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/comments/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Retrieve all comments for a work item.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -99,9 +99,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/?cursor=20:1:0&expand=assignees" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -111,7 +111,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/?cursor=20:1:0&expand=assignees",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/?cursor=20:1:0&expand=assignees",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -122,7 +122,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/?cursor=20:1:0&expand=assignees",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/?cursor=20:1:0&expand=assignees",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-comment/update-issue-comment-detail.md b/docs/api-reference/issue-comment/update-issue-comment-detail.md
index f55ea727..83fb72bd 100644
--- a/docs/api-reference/issue-comment/update-issue-comment-detail.md
+++ b/docs/api-reference/issue-comment/update-issue-comment-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue comment, update a w
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/comments/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/comments/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Modify the content of an existing comment on a work item.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Comment ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -112,7 +112,7 @@ Parent.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -130,7 +130,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "comment_html": "<p>Example content</p>",
@@ -146,7 +146,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/comments/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/comments/resource-id-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/issue-types/options/add-dropdown-options.md b/docs/api-reference/issue-types/options/add-dropdown-options.md
index fad105ae..e0a529e9 100644
--- a/docs/api-reference/issue-types/options/add-dropdown-options.md
+++ b/docs/api-reference/issue-types/options/add-dropdown-options.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, options, add
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-properties/{property_id}/options/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-properties/{property_id}/options/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Create a new issue property option
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property ID
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -111,7 +111,7 @@ Parent.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -130,7 +130,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -147,7 +147,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/issue-types/options/delete-dropdown-options.md b/docs/api-reference/issue-types/options/delete-dropdown-options.md
index e05819a7..67bb8eec 100644
--- a/docs/api-reference/issue-types/options/delete-dropdown-options.md
+++ b/docs/api-reference/issue-types/options/delete-dropdown-options.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, options, del
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-properties/{property_id}/options/{option_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-properties/{property_id}/options/{option_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Delete an issue property option
 
 <ApiParam name="option_id" type="string" :required="true">
 
-Option id.
+The unique identifier of the option.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property ID
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/550e8400-e29b-41d4-a716-446655440002/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/option-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/550e8400-e29b-41d4-a716-446655440002/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/option-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -89,7 +89,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/550e8400-e29b-41d4-a716-446655440002/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/option-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/issue-types/options/get-option-details.md b/docs/api-reference/issue-types/options/get-option-details.md
index 45427d73..b39e21d9 100644
--- a/docs/api-reference/issue-types/options/get-option-details.md
+++ b/docs/api-reference/issue-types/options/get-option-details.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, options, ret
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-properties/{property_id}/options/{option_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-properties/{property_id}/options/{option_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Get issue property option by id
 
 <ApiParam name="option_id" type="string" :required="true">
 
-Option id.
+The unique identifier of the option.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property ID
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/550e8400-e29b-41d4-a716-446655440002/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/option-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/550e8400-e29b-41d4-a716-446655440002/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/option-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -89,7 +89,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/550e8400-e29b-41d4-a716-446655440002/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/option-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-types/options/list-dropdown-options.md b/docs/api-reference/issue-types/options/list-dropdown-options.md
index c2fba59e..1d6cf572 100644
--- a/docs/api-reference/issue-types/options/list-dropdown-options.md
+++ b/docs/api-reference/issue-types/options/list-dropdown-options.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, options, lis
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-properties/{property_id}/options/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-properties/{property_id}/options/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ List issue property options
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property ID
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-types/options/update-dropdown-options.md b/docs/api-reference/issue-types/options/update-dropdown-options.md
index 316f8c28..573c7b38 100644
--- a/docs/api-reference/issue-types/options/update-dropdown-options.md
+++ b/docs/api-reference/issue-types/options/update-dropdown-options.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, options, upd
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-properties/{property_id}/options/{option_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-properties/{property_id}/options/{option_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Update an issue property option
 
 <ApiParam name="option_id" type="string" :required="true">
 
-Option id.
+The unique identifier of the option.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property ID
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -117,7 +117,7 @@ Parent.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/550e8400-e29b-41d4-a716-446655440002/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/option-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -136,7 +136,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/550e8400-e29b-41d4-a716-446655440002/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/option-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -153,7 +153,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-properties/550e8400-e29b-41d4-a716-446655440001/options/550e8400-e29b-41d4-a716-446655440002/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-properties/property-uuid/options/option-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/issue-types/properties/add-property.md b/docs/api-reference/issue-types/properties/add-property.md
index b61b4cfa..93d5a06b 100644
--- a/docs/api-reference/issue-types/properties/add-property.md
+++ b/docs/api-reference/issue-types/properties/add-property.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, properties,
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-types/{type_id}/work-item-properties/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-types/{type_id}/work-item-properties/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Create a new issue property
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="type_id" type="string" :required="true">
 
-Type ID
+The unique identifier of the work item type.
 
 </ApiParam>
 
@@ -163,7 +163,7 @@ Formula config.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -183,7 +183,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -201,7 +201,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/issue-types/properties/delete-property.md b/docs/api-reference/issue-types/properties/delete-property.md
index 379eab3a..c20b2071 100644
--- a/docs/api-reference/issue-types/properties/delete-property.md
+++ b/docs/api-reference/issue-types/properties/delete-property.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, properties,
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-types/{type_id}/work-item-properties/{property_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-types/{type_id}/work-item-properties/{property_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Delete an issue property
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property id.
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="type_id" type="string" :required="true">
 
-Type ID
+The unique identifier of the work item type.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Type ID
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/property-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/property-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -89,7 +89,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/property-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/issue-types/properties/get-property-details.md b/docs/api-reference/issue-types/properties/get-property-details.md
index 2f141cc2..7f2f418e 100644
--- a/docs/api-reference/issue-types/properties/get-property-details.md
+++ b/docs/api-reference/issue-types/properties/get-property-details.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, properties,
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-types/{type_id}/work-item-properties/{property_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-types/{type_id}/work-item-properties/{property_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Get issue property by id
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property id.
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="type_id" type="string" :required="true">
 
-Type ID
+The unique identifier of the work item type.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Type ID
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/property-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/property-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -89,7 +89,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/property-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-types/properties/list-properties.md b/docs/api-reference/issue-types/properties/list-properties.md
index 4eaf258e..445a0fc2 100644
--- a/docs/api-reference/issue-types/properties/list-properties.md
+++ b/docs/api-reference/issue-types/properties/list-properties.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, properties,
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-types/{type_id}/work-item-properties/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-types/{type_id}/work-item-properties/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ List issue properties
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="type_id" type="string" :required="true">
 
-Type ID
+The unique identifier of the work item type.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Type ID
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-types/properties/update-property.md b/docs/api-reference/issue-types/properties/update-property.md
index 2b786f96..e3cf8702 100644
--- a/docs/api-reference/issue-types/properties/update-property.md
+++ b/docs/api-reference/issue-types/properties/update-property.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, properties,
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-types/{type_id}/work-item-properties/{property_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-types/{type_id}/work-item-properties/{property_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Update an issue property
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property id.
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="type_id" type="string" :required="true">
 
-Type ID
+The unique identifier of the work item type.
 
 </ApiParam>
 
@@ -169,7 +169,7 @@ Formula config.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/property-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -189,7 +189,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/property-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -207,7 +207,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/work-item-properties/property-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/issue-types/types/add-issue-type.md b/docs/api-reference/issue-types/types/add-issue-type.md
index 5f9ce232..6c3644fb 100644
--- a/docs/api-reference/issue-types/types/add-issue-type.md
+++ b/docs/api-reference/issue-types/types/add-issue-type.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, types, creat
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-types/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-types/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Create a new issue type for a project
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -99,7 +99,7 @@ External id.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -118,7 +118,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -135,7 +135,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/issue-types/types/delete-issue-type.md b/docs/api-reference/issue-types/types/delete-issue-type.md
index 5c0a1911..81a5c573 100644
--- a/docs/api-reference/issue-types/types/delete-issue-type.md
+++ b/docs/api-reference/issue-types/types/delete-issue-type.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, types, delet
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-types/{type_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-types/{type_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Delete an issue type
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="type_id" type="string" :required="true">
 
-Type id.
+The unique identifier of the work item type.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Type id.
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/issue-types/types/get-issue-type-details.md b/docs/api-reference/issue-types/types/get-issue-type-details.md
index 159c2b1f..b9f187bb 100644
--- a/docs/api-reference/issue-types/types/get-issue-type-details.md
+++ b/docs/api-reference/issue-types/types/get-issue-type-details.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, types, retri
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-types/{type_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-types/{type_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Retrieve an issue type by id
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="type_id" type="string" :required="true">
 
-Type id.
+The unique identifier of the work item type.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Type id.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-types/types/get-work-item-type-schema.md b/docs/api-reference/issue-types/types/get-work-item-type-schema.md
index a1ba0fc0..1afb9bec 100644
--- a/docs/api-reference/issue-types/types/get-work-item-type-schema.md
+++ b/docs/api-reference/issue-types/types/get-work-item-type-schema.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, types, get w
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-types/schema/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-types/schema/</span>
 </div>
 
 <div class="api-two-column">
@@ -44,13 +44,13 @@ when creating/updating work items.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -95,9 +95,9 @@ Work item type ID. If not provided, returns schema for default type (when types
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/schema/?include=members&type_id=550e8400-e29b-41d4-a716-446655440000" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/schema/?include=members&type_id=type-uuid" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -107,7 +107,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/schema/?include=members&type_id=550e8400-e29b-41d4-a716-446655440000",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/schema/?include=members&type_id=type-uuid",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -118,7 +118,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/schema/?include=members&type_id=550e8400-e29b-41d4-a716-446655440000",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/schema/?include=members&type_id=type-uuid",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-types/types/list-issue-types.md b/docs/api-reference/issue-types/types/list-issue-types.md
index 9ed36dae..b52aefe4 100644
--- a/docs/api-reference/issue-types/types/list-issue-types.md
+++ b/docs/api-reference/issue-types/types/list-issue-types.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, types, list
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-types/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-types/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ List all issue types for a project
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -77,7 +77,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-types/types/update-issue-types.md b/docs/api-reference/issue-types/types/update-issue-types.md
index 3f6d6970..98757912 100644
--- a/docs/api-reference/issue-types/types/update-issue-types.md
+++ b/docs/api-reference/issue-types/types/update-issue-types.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, types, updat
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-item-types/{type_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-item-types/{type_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Update an issue type
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="type_id" type="string" :required="true">
 
-Type id.
+The unique identifier of the work item type.
 
 </ApiParam>
 
@@ -105,7 +105,7 @@ External id.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -124,7 +124,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -141,7 +141,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-item-types/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-item-types/type-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/issue-types/values/add-property-values.md b/docs/api-reference/issue-types/values/add-property-values.md
index ebcd2b93..07607d95 100644
--- a/docs/api-reference/issue-types/values/add-property-values.md
+++ b/docs/api-reference/issue-types/values/add-property-values.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, values, add
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/work-item-properties/{property_id}/values/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/work-item-properties/{property_id}/values/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Create or update the property value for a work item. Acts as an upsert operation
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property ID
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="work_item_id" type="string" :required="true">
 
-Work item id.
+The unique identifier of the work item.
 
 </ApiParam>
 
@@ -93,7 +93,7 @@ Optional external source identifier (e.g., 'github', 'jira')
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -111,7 +111,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "value": "example text value",
@@ -127,7 +127,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/issue-types/values/delete-property-value.md b/docs/api-reference/issue-types/values/delete-property-value.md
index 89ef0897..c8b71bbe 100644
--- a/docs/api-reference/issue-types/values/delete-property-value.md
+++ b/docs/api-reference/issue-types/values/delete-property-value.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, values, dele
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/work-item-properties/{property_id}/values/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/work-item-properties/{property_id}/values/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Delete the property value(s) for a work item. For multi-value properties, delete
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property ID
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="work_item_id" type="string" :required="true">
 
-Work item id.
+The unique identifier of the work item.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Work item id.
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -89,7 +89,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/issue-types/values/get-property-value-detail.md b/docs/api-reference/issue-types/values/get-property-value-detail.md
index 3020813d..a3a405e9 100644
--- a/docs/api-reference/issue-types/values/get-property-value-detail.md
+++ b/docs/api-reference/issue-types/values/get-property-value-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, values, get
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/work-item-properties/{property_id}/values/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/work-item-properties/{property_id}/values/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Retrieve the property value(s) for a specific work item property. Returns a sing
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property ID
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="work_item_id" type="string" :required="true">
 
-Work item id.
+The unique identifier of the work item.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Work item id.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -89,7 +89,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-types/values/list-property-values.md b/docs/api-reference/issue-types/values/list-property-values.md
index df552132..3d3db83b 100644
--- a/docs/api-reference/issue-types/values/list-property-values.md
+++ b/docs/api-reference/issue-types/values/list-property-values.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, values, list
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/work-item-properties/{property_id}/values/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/work-item-properties/{property_id}/values/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Retrieve the property value(s) for a specific work item property. Returns a sing
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property ID
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="work_item_id" type="string" :required="true">
 
-Work item id.
+The unique identifier of the work item.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Work item id.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -89,7 +89,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue-types/values/update-property-value.md b/docs/api-reference/issue-types/values/update-property-value.md
index 9000acce..46c8d4a8 100644
--- a/docs/api-reference/issue-types/values/update-property-value.md
+++ b/docs/api-reference/issue-types/values/update-property-value.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue types, values, upda
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/work-item-properties/{property_id}/values/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/work-item-properties/{property_id}/values/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,25 +24,25 @@ Update an existing property value for a work item (partial update)
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
 <ApiParam name="property_id" type="string" :required="true">
 
-Property ID
+The unique identifier of the property.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="work_item_id" type="string" :required="true">
 
-Work item id.
+The unique identifier of the work item.
 
 </ApiParam>
 
@@ -93,7 +93,7 @@ Optional external source identifier (e.g., 'github', 'jira')
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -109,7 +109,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "value": "updated text value"
@@ -123,7 +123,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/work-item-properties/550e8400-e29b-41d4-a716-446655440001/values/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/work-item-properties/property-uuid/values/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/issue/add-issue.md b/docs/api-reference/issue/add-issue.md
index 1a468b82..9b6cb5be 100644
--- a/docs/api-reference/issue/add-issue.md
+++ b/docs/api-reference/issue/add-issue.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue, create a work item
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Create a new work item in the specified project with the provided details.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -211,7 +211,7 @@ Type.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -238,7 +238,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -262,26 +262,23 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Example Name",
-      description: "Example description",
-      priority: "medium",
-      state: "550e8400-e29b-41d4-a716-446655440000",
-      assignees: ["550e8400-e29b-41d4-a716-446655440000"],
-      labels: ["550e8400-e29b-41d4-a716-446655440000"],
-      external_id: "550e8400-e29b-41d4-a716-446655440000",
-      external_source: "github",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Example Name",
+    description: "Example description",
+    priority: "medium",
+    state: "550e8400-e29b-41d4-a716-446655440000",
+    assignees: ["550e8400-e29b-41d4-a716-446655440000"],
+    labels: ["550e8400-e29b-41d4-a716-446655440000"],
+    external_id: "550e8400-e29b-41d4-a716-446655440000",
+    external_source: "github",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/issue/advanced-search-work-items.md b/docs/api-reference/issue/advanced-search-work-items.md
index 4232deda..8516a195 100644
--- a/docs/api-reference/issue/advanced-search-work-items.md
+++ b/docs/api-reference/issue/advanced-search-work-items.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue, advanced search wo
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/work-items/advanced-search/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/work-items/advanced-search/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Search for work items with advanced filters and search query.
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/issue/delete-issue.md b/docs/api-reference/issue/delete-issue.md
index adeaabc7..74af99cb 100644
--- a/docs/api-reference/issue/delete-issue.md
+++ b/docs/api-reference/issue/delete-issue.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue, delete a work item
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Permanently delete an existing work item from the project. Only admins or the it
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/resource-id-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/issue/get-issue-detail.md b/docs/api-reference/issue/get-issue-detail.md
index 2a7f36fd..437a8d2b 100644
--- a/docs/api-reference/issue/get-issue-detail.md
+++ b/docs/api-reference/issue/get-issue-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue, retrieve a work it
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Retrieve details of a specific work item.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -99,9 +99,9 @@ Field to order results by. Prefix with '-' for descending order
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440000/?expand=assignees&external_id=1234567890" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/resource-id-uuid/?expand=assignees&external_id=1234567890" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -111,7 +111,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440000/?expand=assignees&external_id=1234567890",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/resource-id-uuid/?expand=assignees&external_id=1234567890",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -122,7 +122,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440000/?expand=assignees&external_id=1234567890",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/resource-id-uuid/?expand=assignees&external_id=1234567890",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue/get-issue-sequence-id.md b/docs/api-reference/issue/get-issue-sequence-id.md
index cb51d5f2..3bd935f1 100644
--- a/docs/api-reference/issue/get-issue-sequence-id.md
+++ b/docs/api-reference/issue/get-issue-sequence-id.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue, retrieve a work it
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/work-items/{project_identifier}-{issue_identifier}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/work-items/{project_identifier}-{issue_identifier}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Retrieve a specific work item using workspace slug, project identifier, and issu
 
 <ApiParam name="issue_identifier" type="integer" :required="true">
 
-Issue sequence ID (numeric identifier within project)
+The numeric issue identifier.
 
 </ApiParam>
 
 <ApiParam name="project_identifier" type="string" :required="true">
 
-Project identifier (unique string within workspace)
+The project identifier key.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -62,7 +62,7 @@ Workspace slug
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/work-items/PROJ-123/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/issue/list-issues.md b/docs/api-reference/issue/list-issues.md
index baacd4a3..1a590bb7 100644
--- a/docs/api-reference/issue/list-issues.md
+++ b/docs/api-reference/issue/list-issues.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue, list all work item
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Retrieve a paginated list of all work items in a project. Supports filtering, or
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -105,9 +105,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/?cursor=20:1:0&expand=assignees" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -117,7 +117,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/?cursor=20:1:0&expand=assignees",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/?cursor=20:1:0&expand=assignees",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -128,7 +128,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/?cursor=20:1:0&expand=assignees",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/?cursor=20:1:0&expand=assignees",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue/search-issues.md b/docs/api-reference/issue/search-issues.md
index cba5eb53..65bba30f 100644
--- a/docs/api-reference/issue/search-issues.md
+++ b/docs/api-reference/issue/search-issues.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue, search work items
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/work-items/search/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/work-items/search/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Perform semantic search across issue names, sequence IDs, and project identifier
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -81,9 +81,9 @@ Whether to search across entire workspace or within specific project
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/work-items/search/?limit=10&project_id=550e8400-e29b-41d4-a716-446655440000" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/work-items/search/?limit=10&project_id=project-uuid" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -93,7 +93,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/work-items/search/?limit=10&project_id=550e8400-e29b-41d4-a716-446655440000",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/work-items/search/?limit=10&project_id=project-uuid",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -104,7 +104,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/work-items/search/?limit=10&project_id=550e8400-e29b-41d4-a716-446655440000",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/work-items/search/?limit=10&project_id=project-uuid",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/issue/update-issue-detail.md b/docs/api-reference/issue/update-issue-detail.md
index 2109ea92..02e5b106 100644
--- a/docs/api-reference/issue/update-issue-detail.md
+++ b/docs/api-reference/issue/update-issue-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, issue, update a work item
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Partially update an existing work item with the provided fields. Supports extern
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -217,7 +217,7 @@ Type.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -242,7 +242,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -265,7 +265,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/resource-id-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/label/add-label.md b/docs/api-reference/label/add-label.md
index dcdcb0be..2f4f8cf0 100644
--- a/docs/api-reference/label/add-label.md
+++ b/docs/api-reference/label/add-label.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, label, create a label
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/labels/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/labels/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Create a new label in the specified project with name, color, and description.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -105,7 +105,7 @@ Sort order.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -125,7 +125,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -142,23 +142,20 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Example Name",
-      color: "#ff0000",
-      description: "Example description",
-      external_id: "550e8400-e29b-41d4-a716-446655440000",
-      external_source: "github",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Example Name",
+    color: "#ff0000",
+    description: "Example description",
+    external_id: "550e8400-e29b-41d4-a716-446655440000",
+    external_source: "github",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/label/delete-label.md b/docs/api-reference/label/delete-label.md
index 295ed37c..be77000b 100644
--- a/docs/api-reference/label/delete-label.md
+++ b/docs/api-reference/label/delete-label.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, label, delete a label
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/labels/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/labels/{label_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Permanently remove a label from the project. This action cannot be undone.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="label_id" type="string" :required="true">
 
-Label ID
+The unique identifier of the label.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/label-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/label-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/label-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/label/get-label-detail.md b/docs/api-reference/label/get-label-detail.md
index ebc13ea0..83284f5d 100644
--- a/docs/api-reference/label/get-label-detail.md
+++ b/docs/api-reference/label/get-label-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, label, retrieve a label
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/labels/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/labels/{label_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Retrieve details of a specific label.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="label_id" type="string" :required="true">
 
-Label ID
+The unique identifier of the label.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/label-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/label-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/label-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/label/list-labels.md b/docs/api-reference/label/list-labels.md
index 23231035..202fb755 100644
--- a/docs/api-reference/label/list-labels.md
+++ b/docs/api-reference/label/list-labels.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, label, list all labels
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/labels/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/labels/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Retrieve all labels in a project. Supports filtering by name and color.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -93,9 +93,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/?cursor=20:1:0&expand=assignees" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -105,7 +105,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/?cursor=20:1:0&expand=assignees",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/?cursor=20:1:0&expand=assignees",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -116,7 +116,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/?cursor=20:1:0&expand=assignees",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/?cursor=20:1:0&expand=assignees",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/label/update-label-detail.md b/docs/api-reference/label/update-label-detail.md
index 1a9e9705..73d6ae9a 100644
--- a/docs/api-reference/label/update-label-detail.md
+++ b/docs/api-reference/label/update-label-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, label, update a label
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/labels/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/labels/{label_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Partially update an existing label's properties like name, color, or description
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="label_id" type="string" :required="true">
 
-Label ID
+The unique identifier of the label.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -111,7 +111,7 @@ Sort order.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/label-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -131,7 +131,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/label-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -149,7 +149,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/labels/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/labels/label-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/link/add-link.md b/docs/api-reference/link/add-link.md
index 3f79c4b6..bd37d032 100644
--- a/docs/api-reference/link/add-link.md
+++ b/docs/api-reference/link/add-link.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, link, create a link
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/links/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/links/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Add a new external link to a work item with URL, title, and metadata.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -81,7 +81,7 @@ Url.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -98,7 +98,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "url": "https://example.com/resource",
@@ -113,7 +113,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/link/delete-link.md b/docs/api-reference/link/delete-link.md
index faddad6f..191e5eef 100644
--- a/docs/api-reference/link/delete-link.md
+++ b/docs/api-reference/link/delete-link.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, link, delete a link
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/links/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/links/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Permanently remove an external link from a work item.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Link ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -89,7 +89,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/resource-id-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/link/get-link-detail.md b/docs/api-reference/link/get-link-detail.md
index e9abd0ff..d9b5aa4b 100644
--- a/docs/api-reference/link/get-link-detail.md
+++ b/docs/api-reference/link/get-link-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, link, retrieve a link
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/links/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/links/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Retrieve details of a specific work item link.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Link ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -99,9 +99,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/550e8400-e29b-41d4-a716-446655440000/?cursor=20:1:0&expand=assignees" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/resource-id-uuid/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -111,7 +111,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/550e8400-e29b-41d4-a716-446655440000/?cursor=20:1:0&expand=assignees",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/resource-id-uuid/?cursor=20:1:0&expand=assignees",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -122,7 +122,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/550e8400-e29b-41d4-a716-446655440000/?cursor=20:1:0&expand=assignees",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/resource-id-uuid/?cursor=20:1:0&expand=assignees",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/link/list-links.md b/docs/api-reference/link/list-links.md
index 21c755d5..e0c5d2f9 100644
--- a/docs/api-reference/link/list-links.md
+++ b/docs/api-reference/link/list-links.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, link, list all links
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/links/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/links/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Retrieve all links associated with a work item. Supports filtering by URL, title
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -99,9 +99,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/?cursor=20:1:0&expand=assignees" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -111,7 +111,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/?cursor=20:1:0&expand=assignees",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/?cursor=20:1:0&expand=assignees",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -122,7 +122,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/?cursor=20:1:0&expand=assignees",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/?cursor=20:1:0&expand=assignees",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/link/update-link-detail.md b/docs/api-reference/link/update-link-detail.md
index bd5073e1..fb05ab29 100644
--- a/docs/api-reference/link/update-link-detail.md
+++ b/docs/api-reference/link/update-link-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, link, update a link
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/links/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/links/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Modify the URL, title, or metadata of an existing issue link.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Link ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -87,7 +87,7 @@ Url.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -104,7 +104,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "url": "https://example.com/resource",
@@ -119,7 +119,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/links/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/links/resource-id-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/members/add-project-member.md b/docs/api-reference/members/add-project-member.md
index 9f7cad05..7e733539 100644
--- a/docs/api-reference/members/add-project-member.md
+++ b/docs/api-reference/members/add-project-member.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, members, create project m
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/project-members/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/project-members/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Create a new project member
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -77,7 +77,7 @@ Member.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -94,7 +94,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "member": "550e8400-e29b-41d4-a716-446655440000",
@@ -109,7 +109,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/members/delete-project-member.md b/docs/api-reference/members/delete-project-member.md
index ab0e8a8e..cb98b4bf 100644
--- a/docs/api-reference/members/delete-project-member.md
+++ b/docs/api-reference/members/delete-project-member.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, members, delete project m
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/project-members/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/project-members/{member_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Delete a project member
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="member_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the member.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/member-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/member-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/member-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/members/get-project-member-detail.md b/docs/api-reference/members/get-project-member-detail.md
index 50dee43e..238085f1 100644
--- a/docs/api-reference/members/get-project-member-detail.md
+++ b/docs/api-reference/members/get-project-member-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, members, get project memb
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/project-members/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/project-members/{member_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Retrieve a project member by ID.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="member_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the member.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/member-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/member-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/member-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/members/get-project-members.md b/docs/api-reference/members/get-project-members.md
index 456dda3e..e777e919 100644
--- a/docs/api-reference/members/get-project-members.md
+++ b/docs/api-reference/members/get-project-members.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, members, list all project
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/project-members/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/project-members/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Retrieve all users who are members of the specified project.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -77,7 +77,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/members/get-workspace-members.md b/docs/api-reference/members/get-workspace-members.md
index 7029db04..d1063221 100644
--- a/docs/api-reference/members/get-workspace-members.md
+++ b/docs/api-reference/members/get-workspace-members.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, members, get all workspac
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/members/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/members/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Retrieve all users who are members of the specified workspace.
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -50,7 +50,7 @@ Workspace slug
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/members/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/members/remove-workspace-member.md b/docs/api-reference/members/remove-workspace-member.md
index 5de4a9a3..06a458f2 100644
--- a/docs/api-reference/members/remove-workspace-member.md
+++ b/docs/api-reference/members/remove-workspace-member.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, members, remove workspace
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/members/remove/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/members/remove/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Remove a member from the workspace, deactivate them from all projects, and reduc
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -50,7 +50,7 @@ Workspace slug
 curl -X POST \
   "https://api.plane.so/api/v1/workspaces/my-workspace/members/remove/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/members/update-project-member.md b/docs/api-reference/members/update-project-member.md
index bfff7c96..e4d39436 100644
--- a/docs/api-reference/members/update-project-member.md
+++ b/docs/api-reference/members/update-project-member.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, members, update project m
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/project-members/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/project-members/{member_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Update a project member
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="member_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the member.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -83,7 +83,7 @@ Member.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/member-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -100,7 +100,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/member-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "member": "550e8400-e29b-41d4-a716-446655440000",
@@ -115,7 +115,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/project-members/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/project-members/member-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/milestones/add-milestone.md b/docs/api-reference/milestones/add-milestone.md
index dc42cec5..fb13cef4 100644
--- a/docs/api-reference/milestones/add-milestone.md
+++ b/docs/api-reference/milestones/add-milestone.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, milestones, create milest
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/milestones/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/milestones/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Create a new milestone in a project.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project id.
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -87,7 +87,7 @@ API key authentication or an OAuth token with equivalent access.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -106,7 +106,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "title": "Example Name",
@@ -122,22 +122,19 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      title: "Example Name",
-      target_date: "2024-01-01",
-      external_id: "550e8400-e29b-41d4-a716-446655440000",
-      external_source: "github",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    title: "Example Name",
+    target_date: "2024-01-01",
+    external_id: "550e8400-e29b-41d4-a716-446655440000",
+    external_source: "github",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/milestones/delete-milestone.md b/docs/api-reference/milestones/delete-milestone.md
index f7cbb731..1a9b1bd0 100644
--- a/docs/api-reference/milestones/delete-milestone.md
+++ b/docs/api-reference/milestones/delete-milestone.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, milestones, delete milest
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/milestones/{milestone_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/milestones/{milestone_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Delete a specific milestone by its ID.
 
 <ApiParam name="milestone_id" type="string" :required="true">
 
-Milestone id.
+The unique identifier of the milestone.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project id.
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ API key authentication or an OAuth token with equivalent access.
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/milestone-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/milestone-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/milestone-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/milestones/get-milestone-detail.md b/docs/api-reference/milestones/get-milestone-detail.md
index b13d653e..7ec8ad94 100644
--- a/docs/api-reference/milestones/get-milestone-detail.md
+++ b/docs/api-reference/milestones/get-milestone-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, milestones, get milestone
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/milestones/{milestone_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/milestones/{milestone_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Retrieve a specific milestone by its ID.
 
 <ApiParam name="milestone_id" type="string" :required="true">
 
-Milestone id.
+The unique identifier of the milestone.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project id.
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ API key authentication or an OAuth token with equivalent access.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/milestone-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/milestone-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/milestone-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/milestones/list-milestone-work-items.md b/docs/api-reference/milestones/list-milestone-work-items.md
index f7a20941..5bd87c2e 100644
--- a/docs/api-reference/milestones/list-milestone-work-items.md
+++ b/docs/api-reference/milestones/list-milestone-work-items.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, milestones, list mileston
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/milestones/{milestone_id}/work-items/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/milestones/{milestone_id}/work-items/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ List all work items for a milestone.
 
 <ApiParam name="milestone_id" type="string" :required="true">
 
-Milestone id.
+The unique identifier of the milestone.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project id.
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ API key authentication or an OAuth token with equivalent access.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/550e8400-e29b-41d4-a716-446655440001/work-items/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/milestone-uuid/work-items/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/550e8400-e29b-41d4-a716-446655440001/work-items/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/milestone-uuid/work-items/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/550e8400-e29b-41d4-a716-446655440001/work-items/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/milestone-uuid/work-items/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/milestones/list-milestones.md b/docs/api-reference/milestones/list-milestones.md
index 6e4b3185..c4ecea31 100644
--- a/docs/api-reference/milestones/list-milestones.md
+++ b/docs/api-reference/milestones/list-milestones.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, milestones, list mileston
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/milestones/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/milestones/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ List all milestones in a project.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project id.
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ API key authentication or an OAuth token with equivalent access.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/milestones/update-milestone-detail.md b/docs/api-reference/milestones/update-milestone-detail.md
index 97dbb00d..90be86d0 100644
--- a/docs/api-reference/milestones/update-milestone-detail.md
+++ b/docs/api-reference/milestones/update-milestone-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, milestones, update milest
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/milestones/{milestone_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/milestones/{milestone_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Update a specific milestone by its ID.
 
 <ApiParam name="milestone_id" type="string" :required="true">
 
-Milestone id.
+The unique identifier of the milestone.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project id.
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Slug.
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -93,7 +93,7 @@ API key authentication or an OAuth token with equivalent access.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/milestone-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -112,7 +112,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/milestone-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "title": "Example Name",
@@ -129,7 +129,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/milestones/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/milestones/milestone-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/module/add-module-work-items.md b/docs/api-reference/module/add-module-work-items.md
index b9ec3892..9d987c95 100644
--- a/docs/api-reference/module/add-module-work-items.md
+++ b/docs/api-reference/module/add-module-work-items.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, module, add work items to
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/modules/{module_id}/module-issues/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/modules/{module_id}/module-issues/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Assign multiple work items to a module or move them from another module. Automat
 
 <ApiParam name="module_id" type="string" :required="true">
 
-Module ID
+The unique identifier of the module.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -75,7 +75,7 @@ List of issue IDs to add to the module
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440001/module-issues/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/module-uuid/module-issues/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -94,7 +94,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440001/module-issues/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/module-uuid/module-issues/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "issues": [
@@ -111,7 +111,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440001/module-issues/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/module-uuid/module-issues/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/module/add-module.md b/docs/api-reference/module/add-module.md
index b876cc3c..f8dbd71e 100644
--- a/docs/api-reference/module/add-module.md
+++ b/docs/api-reference/module/add-module.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, module, create a module
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/modules/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/modules/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Create a new project module with specified name, description, and timeline.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -122,7 +122,7 @@ External id.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -143,7 +143,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -161,24 +161,21 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Example Name",
-      description: "Example description",
-      start_date: "2024-01-01",
-      end_date: "2024-01-01",
-      external_id: "550e8400-e29b-41d4-a716-446655440000",
-      external_source: "github",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Example Name",
+    description: "Example description",
+    start_date: "2024-01-01",
+    end_date: "2024-01-01",
+    external_id: "550e8400-e29b-41d4-a716-446655440000",
+    external_source: "github",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/module/archive-module.md b/docs/api-reference/module/archive-module.md
index 343e69ab..cd188aad 100644
--- a/docs/api-reference/module/archive-module.md
+++ b/docs/api-reference/module/archive-module.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, module, archive a module
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/modules/{pk}/archive/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/modules/{resource_id}/archive/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Move a module to archived status for historical tracking.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Module ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440000/archive/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/resource-id-uuid/archive/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440000/archive/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/resource-id-uuid/archive/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440000/archive/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/resource-id-uuid/archive/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/module/delete-module.md b/docs/api-reference/module/delete-module.md
index aec8791b..6ee5610d 100644
--- a/docs/api-reference/module/delete-module.md
+++ b/docs/api-reference/module/delete-module.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, module, delete a module
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/modules/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/modules/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Permanently remove a module and all its associated issue relationships.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Module ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/resource-id-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/module/get-module-detail.md b/docs/api-reference/module/get-module-detail.md
index 2741d170..cac9cf73 100644
--- a/docs/api-reference/module/get-module-detail.md
+++ b/docs/api-reference/module/get-module-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, module, retrieve a module
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/modules/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/modules/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Retrieve details of a specific module.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Module ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/resource-id-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/module/list-archived-modules.md b/docs/api-reference/module/list-archived-modules.md
index 616c34f5..98fed234 100644
--- a/docs/api-reference/module/list-archived-modules.md
+++ b/docs/api-reference/module/list-archived-modules.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, module, list all archived
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/archived-modules/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/archived-modules/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Retrieve all modules that have been archived in the project.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -93,9 +93,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archived-modules/?cursor=20:1:0&expand=assignees" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archived-modules/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -105,7 +105,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archived-modules/?cursor=20:1:0&expand=assignees",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archived-modules/?cursor=20:1:0&expand=assignees",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -116,7 +116,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archived-modules/?cursor=20:1:0&expand=assignees",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archived-modules/?cursor=20:1:0&expand=assignees",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/module/list-module-work-items.md b/docs/api-reference/module/list-module-work-items.md
index 389c309e..aa8d53f8 100644
--- a/docs/api-reference/module/list-module-work-items.md
+++ b/docs/api-reference/module/list-module-work-items.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, module, list all work ite
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/modules/{module_id}/module-issues/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/modules/{module_id}/module-issues/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Retrieve all work items assigned to a module with detailed information.
 
 <ApiParam name="module_id" type="string" :required="true">
 
-Module ID
+The unique identifier of the module.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -99,9 +99,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440001/module-issues/?cursor=20:1:0&expand=assignees" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/module-uuid/module-issues/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -111,7 +111,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440001/module-issues/?cursor=20:1:0&expand=assignees",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/module-uuid/module-issues/?cursor=20:1:0&expand=assignees",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -122,7 +122,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440001/module-issues/?cursor=20:1:0&expand=assignees",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/module-uuid/module-issues/?cursor=20:1:0&expand=assignees",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/module/list-modules.md b/docs/api-reference/module/list-modules.md
index cd49051a..fd63d625 100644
--- a/docs/api-reference/module/list-modules.md
+++ b/docs/api-reference/module/list-modules.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, module, list all modules
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/modules/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/modules/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Retrieve all modules in a project.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -93,9 +93,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/?cursor=20:1:0&expand=assignees" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -105,7 +105,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/?cursor=20:1:0&expand=assignees",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/?cursor=20:1:0&expand=assignees",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -116,7 +116,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/?cursor=20:1:0&expand=assignees",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/?cursor=20:1:0&expand=assignees",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/module/remove-module-work-item.md b/docs/api-reference/module/remove-module-work-item.md
index 9de2c0e9..ad787209 100644
--- a/docs/api-reference/module/remove-module-work-item.md
+++ b/docs/api-reference/module/remove-module-work-item.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, module, remove work item
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/modules/{module_id}/module-issues/{issue_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/modules/{module_id}/module-issues/{work_item_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Remove a work item from a module while keeping the work item in the project.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="module_id" type="string" :required="true">
 
-Module ID
+The unique identifier of the module.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440001/module-issues/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/module-uuid/module-issues/work-item-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440001/module-issues/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/module-uuid/module-issues/work-item-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -89,7 +89,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440001/module-issues/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/module-uuid/module-issues/work-item-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/module/unarchive-module.md b/docs/api-reference/module/unarchive-module.md
index 82b83acd..04294115 100644
--- a/docs/api-reference/module/unarchive-module.md
+++ b/docs/api-reference/module/unarchive-module.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, module, restore a module
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/archived-modules/{pk}/unarchive/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/archived-modules/{resource_id}/unarchive/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Restore an archived module to active status, making it available for regular use
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Module ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archived-modules/550e8400-e29b-41d4-a716-446655440000/unarchive/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archived-modules/resource-id-uuid/unarchive/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archived-modules/550e8400-e29b-41d4-a716-446655440000/unarchive/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archived-modules/resource-id-uuid/unarchive/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archived-modules/550e8400-e29b-41d4-a716-446655440000/unarchive/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archived-modules/resource-id-uuid/unarchive/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/module/update-module-detail.md b/docs/api-reference/module/update-module-detail.md
index 64ea24db..ae014dab 100644
--- a/docs/api-reference/module/update-module-detail.md
+++ b/docs/api-reference/module/update-module-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, module, update module det
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/modules/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/modules/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Modify an existing module's properties like name, description, status, or timeli
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Module ID
+The unique identifier of the resource.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -128,7 +128,7 @@ External id.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -149,7 +149,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -168,7 +168,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/modules/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/modules/resource-id-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/page/add-project-page.md b/docs/api-reference/page/add-project-page.md
index 1b69ea4d..c66762f5 100644
--- a/docs/api-reference/page/add-project-page.md
+++ b/docs/api-reference/page/add-project-page.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, page, create a project pa
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/pages/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/pages/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Create a project page
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -124,7 +124,7 @@ Description html.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/pages/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/pages/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -149,7 +149,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/pages/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/pages/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -171,28 +171,25 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/pages/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Example Name",
-      access: 0,
-      color: "Example Name",
-      is_locked: true,
-      archived_at: "2024-01-01",
-      view_props: "example-value",
-      logo_props: "example-value",
-      external_id: "550e8400-e29b-41d4-a716-446655440000",
-      external_source: "github",
-      description_html: "<p>Example content</p>",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/pages/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Example Name",
+    access: 0,
+    color: "Example Name",
+    is_locked: true,
+    archived_at: "2024-01-01",
+    view_props: "example-value",
+    logo_props: "example-value",
+    external_id: "550e8400-e29b-41d4-a716-446655440000",
+    external_source: "github",
+    description_html: "<p>Example content</p>",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/page/add-workspace-page.md b/docs/api-reference/page/add-workspace-page.md
index 50404bfb..eb258fa3 100644
--- a/docs/api-reference/page/add-workspace-page.md
+++ b/docs/api-reference/page/add-workspace-page.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, page, create a wiki page
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/pages/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/pages/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Create a workspace page
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/page/get-project-page.md b/docs/api-reference/page/get-project-page.md
index 968c2358..f7575df8 100644
--- a/docs/api-reference/page/get-project-page.md
+++ b/docs/api-reference/page/get-project-page.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, page, retrieve a project
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/pages/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/pages/{page_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Get a project page by ID
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="page_id" type="string" :required="true">
 
-Page ID
+The unique identifier of the page.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/pages/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/pages/page-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/pages/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/pages/page-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/pages/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/pages/page-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/page/get-workspace-page.md b/docs/api-reference/page/get-workspace-page.md
index 6725cf6e..9a6de60d 100644
--- a/docs/api-reference/page/get-workspace-page.md
+++ b/docs/api-reference/page/get-workspace-page.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, page, retrieve a wiki pag
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/pages/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/pages/{page_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Get a workspace page by ID
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="page_id" type="string" :required="true">
 
-Page ID
+The unique identifier of the page.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/pages/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/pages/page-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/pages/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/pages/page-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/pages/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/pages/page-uuid/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/project-features/get-project-features.md b/docs/api-reference/project-features/get-project-features.md
index 1283e3f0..24561335 100644
--- a/docs/api-reference/project-features/get-project-features.md
+++ b/docs/api-reference/project-features/get-project-features.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project features, get pro
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/features/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/features/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Get the features of a project
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/features/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/features/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/features/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/features/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/features/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/features/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/project-features/update-project-features.md b/docs/api-reference/project-features/update-project-features.md
index 96e91a3f..a86a00f3 100644
--- a/docs/api-reference/project-features/update-project-features.md
+++ b/docs/api-reference/project-features/update-project-features.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project features, update
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/features/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/features/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Update the features of a project
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -105,7 +105,7 @@ Work item types.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/features/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/features/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -127,7 +127,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/features/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/features/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "epics": true,
@@ -146,25 +146,22 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/features/",
-  {
-    method: "PATCH",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      epics: true,
-      modules: true,
-      cycles: true,
-      views: true,
-      pages: true,
-      intakes: true,
-      work_item_types: true,
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/features/", {
+  method: "PATCH",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    epics: true,
+    modules: true,
+    cycles: true,
+    views: true,
+    pages: true,
+    intakes: true,
+    work_item_types: true,
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/project-labels/add-project-label.md b/docs/api-reference/project-labels/add-project-label.md
index 7a77b928..3497d37b 100644
--- a/docs/api-reference/project-labels/add-project-label.md
+++ b/docs/api-reference/project-labels/add-project-label.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project labels, create pr
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/project-labels/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/project-labels/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Create a new project label in the workspace with name, color, and description.
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/project-labels/delete-project-label.md b/docs/api-reference/project-labels/delete-project-label.md
index 0c35686f..d601979f 100644
--- a/docs/api-reference/project-labels/delete-project-label.md
+++ b/docs/api-reference/project-labels/delete-project-label.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project labels, delete pr
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/project-labels/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/project-labels/{label_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Permanently delete an existing project label from the workspace.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="label_id" type="string" :required="true">
 
-Project Label ID
+The unique identifier of the label.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/label-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/label-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -76,15 +76,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/label-uuid/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/project-labels/get-project-label-detail.md b/docs/api-reference/project-labels/get-project-label-detail.md
index 61f424f5..e099a936 100644
--- a/docs/api-reference/project-labels/get-project-label-detail.md
+++ b/docs/api-reference/project-labels/get-project-label-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project labels, get proje
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/project-labels/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/project-labels/{label_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Retrieve details of a specific project label.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="label_id" type="string" :required="true">
 
-Project Label ID
+The unique identifier of the label.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/label-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/label-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/label-uuid/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/project-labels/list-project-labels.md b/docs/api-reference/project-labels/list-project-labels.md
index 032c1559..769884ef 100644
--- a/docs/api-reference/project-labels/list-project-labels.md
+++ b/docs/api-reference/project-labels/list-project-labels.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project labels, list proj
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/project-labels/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/project-labels/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Retrieve all project labels in a workspace.
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -89,7 +89,7 @@ Number of results per page (default: 20, max: 100)
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/project-labels/update-project-label-detail.md b/docs/api-reference/project-labels/update-project-label-detail.md
index d10d2416..f059de70 100644
--- a/docs/api-reference/project-labels/update-project-label-detail.md
+++ b/docs/api-reference/project-labels/update-project-label-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project labels, update pr
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/project-labels/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/project-labels/{label_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Partially update an existing project label's properties like name, color, or des
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="label_id" type="string" :required="true">
 
-Project Label ID
+The unique identifier of the label.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -87,7 +87,7 @@ Sort order.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/label-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -105,7 +105,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/label-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -120,21 +120,18 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "PATCH",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Example Name",
-      color: "#00ff00",
-      description: "Example description",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/project-labels/label-uuid/", {
+  method: "PATCH",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Example Name",
+    color: "#00ff00",
+    description: "Example description",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/project/add-project.md b/docs/api-reference/project/add-project.md
index 34c97aae..278f45a3 100644
--- a/docs/api-reference/project/add-project.md
+++ b/docs/api-reference/project/add-project.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project, create a project
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Create a new project in the workspace with default states and member assignments
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/project/archive-project.md b/docs/api-reference/project/archive-project.md
index 04fdf32c..c225c0ed 100644
--- a/docs/api-reference/project/archive-project.md
+++ b/docs/api-reference/project/archive-project.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project, archive project
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/archive/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/archive/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Move a project to archived status, hiding it from active project lists.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archive/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archive/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archive/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archive/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -76,15 +76,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archive/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archive/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/project/delete-project.md b/docs/api-reference/project/delete-project.md
index 6a406693..9d74890a 100644
--- a/docs/api-reference/project/delete-project.md
+++ b/docs/api-reference/project/delete-project.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project, delete a project
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Permanently remove a project and all its associated data from the workspace.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -76,15 +76,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/resource-id-uuid/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/project/get-project-detail.md b/docs/api-reference/project/get-project-detail.md
index 03a2f9de..0def5de9 100644
--- a/docs/api-reference/project/get-project-detail.md
+++ b/docs/api-reference/project/get-project-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project, retrieve a proje
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Retrieve details of a specific project.
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/resource-id-uuid/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/project/list-projects.md b/docs/api-reference/project/list-projects.md
index 45315bb9..45a37ac1 100644
--- a/docs/api-reference/project/list-projects.md
+++ b/docs/api-reference/project/list-projects.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project, list all project
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Retrieve all projects in a workspace or get details of a specific project.
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -89,7 +89,7 @@ Number of results per page (default: 20, max: 100)
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/projects/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/project/unarchive-project.md b/docs/api-reference/project/unarchive-project.md
index 7c6efd89..d0f91c4f 100644
--- a/docs/api-reference/project/unarchive-project.md
+++ b/docs/api-reference/project/unarchive-project.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project, unarchive projec
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/archive/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/archive/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Restore an archived project to active status, making it available in regular wor
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archive/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archive/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archive/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archive/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -76,15 +76,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/archive/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/archive/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/project/update-project-detail.md b/docs/api-reference/project/update-project-detail.md
index bca81e05..7988946a 100644
--- a/docs/api-reference/project/update-project-detail.md
+++ b/docs/api-reference/project/update-project-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, project, update a project
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Partially update an existing project's properties like name, description, or set
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -633,7 +633,7 @@ Estimate.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -652,7 +652,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -668,22 +668,19 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "PATCH",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Example Name",
-      description: "Example description",
-      identifier: "PROJ-123",
-      project_lead: "550e8400-e29b-41d4-a716-446655440000",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/resource-id-uuid/", {
+  method: "PATCH",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Example Name",
+    description: "Example description",
+    identifier: "PROJ-123",
+    project_lead: "550e8400-e29b-41d4-a716-446655440000",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/state/add-state.md b/docs/api-reference/state/add-state.md
index fb66d211..bd7c7593 100644
--- a/docs/api-reference/state/add-state.md
+++ b/docs/api-reference/state/add-state.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, state, create a state
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/states/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/states/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Create a new workflow state for a project with specified name, color, and group.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -122,7 +122,7 @@ External id.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -142,7 +142,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -159,23 +159,20 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      name: "Example Name",
-      color: "#ff0000",
-      group: "backlog",
-      external_id: "550e8400-e29b-41d4-a716-446655440000",
-      external_source: "github",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "Example Name",
+    color: "#ff0000",
+    group: "backlog",
+    external_id: "550e8400-e29b-41d4-a716-446655440000",
+    external_source: "github",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/state/delete-state.md b/docs/api-reference/state/delete-state.md
index 51f61598..6df57225 100644
--- a/docs/api-reference/state/delete-state.md
+++ b/docs/api-reference/state/delete-state.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, state, delete a state
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/states/{state_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/states/{state_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Permanently remove a workflow state from a project. Default states and states wi
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="state_id" type="string" :required="true">
 
-State ID
+The unique identifier of the state.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ State ID
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/state-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/state-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -83,7 +83,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/state-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/state/get-state-detail.md b/docs/api-reference/state/get-state-detail.md
index d0295b1e..c77c8451 100644
--- a/docs/api-reference/state/get-state-detail.md
+++ b/docs/api-reference/state/get-state-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, state, retrieve a state
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/states/{state_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/states/{state_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Retrieve details of a specific state.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="state_id" type="string" :required="true">
 
-State ID
+The unique identifier of the state.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ State ID
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/state-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/state-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/state-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/state/list-states.md b/docs/api-reference/state/list-states.md
index 47bd03e2..d410f651 100644
--- a/docs/api-reference/state/list-states.md
+++ b/docs/api-reference/state/list-states.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, state, list all states
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/states/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/states/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Retrieve all workflow states for a project.
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -87,9 +87,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/?cursor=20:1:0&expand=assignees" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/?cursor=20:1:0&expand=assignees" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -99,7 +99,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/?cursor=20:1:0&expand=assignees",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/?cursor=20:1:0&expand=assignees",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -110,7 +110,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/?cursor=20:1:0&expand=assignees",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/?cursor=20:1:0&expand=assignees",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/state/update-state-detail.md b/docs/api-reference/state/update-state-detail.md
index db2819c2..f199260e 100644
--- a/docs/api-reference/state/update-state-detail.md
+++ b/docs/api-reference/state/update-state-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, state, update a state
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/states/{state_id}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/states/{state_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,19 +24,19 @@ Partially update an existing workflow state's properties like name, color, or gr
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="state_id" type="string" :required="true">
 
-State ID
+The unique identifier of the state.
 
 </ApiParam>
 
@@ -128,7 +128,7 @@ External id.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/550e8400-e29b-41d4-a716-446655440001/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/state-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -148,7 +148,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/550e8400-e29b-41d4-a716-446655440001/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/state-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "name": "Example Name",
@@ -166,7 +166,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/states/550e8400-e29b-41d4-a716-446655440001/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/states/state-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/sticky/add-sticky.md b/docs/api-reference/sticky/add-sticky.md
index 87922f27..a0ef0463 100644
--- a/docs/api-reference/sticky/add-sticky.md
+++ b/docs/api-reference/sticky/add-sticky.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, sticky, create a sticky
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/stickies/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/stickies/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Create a new sticky in the workspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/sticky/delete-sticky.md b/docs/api-reference/sticky/delete-sticky.md
index 871a8bab..f8b68975 100644
--- a/docs/api-reference/sticky/delete-sticky.md
+++ b/docs/api-reference/sticky/delete-sticky.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, sticky, delete a sticky
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/stickies/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/stickies/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Delete a sticky by its ID
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-A UUID string identifying this Sticky.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -76,15 +76,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/stickies/resource-id-uuid/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/sticky/get-sticky-detail.md b/docs/api-reference/sticky/get-sticky-detail.md
index f4af6ef8..204d90f0 100644
--- a/docs/api-reference/sticky/get-sticky-detail.md
+++ b/docs/api-reference/sticky/get-sticky-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, sticky, retrieve a sticky
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/stickies/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/stickies/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Retrieve a sticky by its ID
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-A UUID string identifying this Sticky.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/stickies/resource-id-uuid/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/sticky/list-stickies.md b/docs/api-reference/sticky/list-stickies.md
index 5b083cfb..3336343e 100644
--- a/docs/api-reference/sticky/list-stickies.md
+++ b/docs/api-reference/sticky/list-stickies.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, sticky, list all stickies
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/stickies/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/stickies/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ List all stickies in the workspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -50,7 +50,7 @@ Workspace slug
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/sticky/update-sticky-detail.md b/docs/api-reference/sticky/update-sticky-detail.md
index ed1763e7..f557918e 100644
--- a/docs/api-reference/sticky/update-sticky-detail.md
+++ b/docs/api-reference/sticky/update-sticky-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, sticky, update a sticky
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/stickies/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/stickies/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Update a sticky by its ID
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-A UUID string identifying this Sticky.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -129,7 +129,7 @@ Updated by.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -155,7 +155,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "deleted_at": "2024-01-01T00:00:00Z",
@@ -178,29 +178,26 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/stickies/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "PATCH",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      deleted_at: "2024-01-01T00:00:00Z",
-      name: "Example Name",
-      description: "example-value",
-      description_html: "<p>Example content</p>",
-      description_stripped: "Example description",
-      logo_props: "example-value",
-      color: "Example Name",
-      background_color: "Example Name",
-      sort_order: 1,
-      created_by: "550e8400-e29b-41d4-a716-446655440000",
-      updated_by: "550e8400-e29b-41d4-a716-446655440000",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/stickies/resource-id-uuid/", {
+  method: "PATCH",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    deleted_at: "2024-01-01T00:00:00Z",
+    name: "Example Name",
+    description: "example-value",
+    description_html: "<p>Example content</p>",
+    description_stripped: "Example description",
+    logo_props: "example-value",
+    color: "Example Name",
+    background_color: "Example Name",
+    sort_order: 1,
+    created_by: "550e8400-e29b-41d4-a716-446655440000",
+    updated_by: "550e8400-e29b-41d4-a716-446655440000",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/teamspace/add-projects-to-teamspace.md b/docs/api-reference/teamspace/add-projects-to-teamspace.md
index 52300089..41b7190c 100644
--- a/docs/api-reference/teamspace/add-projects-to-teamspace.md
+++ b/docs/api-reference/teamspace/add-projects-to-teamspace.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, teamspace, add projects t
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/teamspaces/{teamspace_id}/projects/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/teamspaces/{teamspace_id}/projects/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Add projects to a teamspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="teamspace_id" type="string" :required="true">
 
-Teamspace ID
+The unique identifier of the teamspace.
 
 </ApiParam>
 
@@ -69,7 +69,7 @@ Project ids.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/projects/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/projects/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -87,7 +87,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/projects/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/projects/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "project_ids": [
@@ -103,7 +103,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/projects/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/projects/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/teamspace/add-teamspace-members.md b/docs/api-reference/teamspace/add-teamspace-members.md
index 05c7c14a..f0700fea 100644
--- a/docs/api-reference/teamspace/add-teamspace-members.md
+++ b/docs/api-reference/teamspace/add-teamspace-members.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, teamspace, add members to
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/teamspaces/{teamspace_id}/members/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/teamspaces/{teamspace_id}/members/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Add members to a teamspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="teamspace_id" type="string" :required="true">
 
-Teamspace ID
+The unique identifier of the teamspace.
 
 </ApiParam>
 
@@ -69,7 +69,7 @@ Member ids.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/members/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/members/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -87,7 +87,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/members/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/members/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "member_ids": [
@@ -102,19 +102,16 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/members/",
-  {
-    method: "POST",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      member_ids: ["550e8400-e29b-41d4-a716-446655440000"],
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/members/", {
+  method: "POST",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    member_ids: ["550e8400-e29b-41d4-a716-446655440000"],
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/teamspace/add-teamspace.md b/docs/api-reference/teamspace/add-teamspace.md
index 8c9bea6a..27e25445 100644
--- a/docs/api-reference/teamspace/add-teamspace.md
+++ b/docs/api-reference/teamspace/add-teamspace.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, teamspace, create a teams
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/teamspaces/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/teamspaces/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Create a new teamspace in the workspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/teamspace/delete-teamspace.md b/docs/api-reference/teamspace/delete-teamspace.md
index 411349cf..6d3cb503 100644
--- a/docs/api-reference/teamspace/delete-teamspace.md
+++ b/docs/api-reference/teamspace/delete-teamspace.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, teamspace, delete a teams
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/teamspaces/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/teamspaces/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Delete a teamspace by its ID
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="teamspace_id" type="string" :required="true">
 
-Teamspace ID
+The unique identifier of the teamspace.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Teamspace ID
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -82,15 +82,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/resource-id-uuid/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/teamspace/get-teamspace-detail.md b/docs/api-reference/teamspace/get-teamspace-detail.md
index 22798349..a49fdef7 100644
--- a/docs/api-reference/teamspace/get-teamspace-detail.md
+++ b/docs/api-reference/teamspace/get-teamspace-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, teamspace, retrieve a tea
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/teamspaces/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/teamspaces/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Retrieve a teamspace by its ID
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="teamspace_id" type="string" :required="true">
 
-Teamspace ID
+The unique identifier of the teamspace.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Teamspace ID
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -82,15 +82,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/resource-id-uuid/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/teamspace/list-teamspace-members.md b/docs/api-reference/teamspace/list-teamspace-members.md
index 898c4164..55ebd452 100644
--- a/docs/api-reference/teamspace/list-teamspace-members.md
+++ b/docs/api-reference/teamspace/list-teamspace-members.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, teamspace, list all teams
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/teamspaces/{teamspace_id}/members/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/teamspaces/{teamspace_id}/members/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ List all members in a teamspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="teamspace_id" type="string" :required="true">
 
-Teamspace ID
+The unique identifier of the teamspace.
 
 </ApiParam>
 
@@ -75,9 +75,9 @@ Number of results per page (default: 20, max: 100)
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/members/?cursor=20:1:0&per_page=20" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/members/?cursor=20:1:0&per_page=20" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -87,7 +87,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/members/?cursor=20:1:0&per_page=20",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/members/?cursor=20:1:0&per_page=20",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -98,7 +98,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/members/?cursor=20:1:0&per_page=20",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/members/?cursor=20:1:0&per_page=20",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/teamspace/list-teamspace-projects.md b/docs/api-reference/teamspace/list-teamspace-projects.md
index 673d638b..87a935ca 100644
--- a/docs/api-reference/teamspace/list-teamspace-projects.md
+++ b/docs/api-reference/teamspace/list-teamspace-projects.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, teamspace, list teamspace
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/teamspaces/{teamspace_id}/projects/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/teamspaces/{teamspace_id}/projects/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ List all projects in a teamspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="teamspace_id" type="string" :required="true">
 
-Teamspace ID
+The unique identifier of the teamspace.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Teamspace ID
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/projects/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/projects/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/projects/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/projects/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -77,7 +77,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/projects/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/projects/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/teamspace/list-teamspaces.md b/docs/api-reference/teamspace/list-teamspaces.md
index dda2866b..7f17138b 100644
--- a/docs/api-reference/teamspace/list-teamspaces.md
+++ b/docs/api-reference/teamspace/list-teamspaces.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, teamspace, list all teams
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/teamspaces/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/teamspaces/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ List all teamspaces in the workspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -71,7 +71,7 @@ Number of results per page (default: 20, max: 100)
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/?cursor=20:1:0&per_page=20" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/teamspace/remove-projects-from-teamspace.md b/docs/api-reference/teamspace/remove-projects-from-teamspace.md
index be751e0f..d03cfbae 100644
--- a/docs/api-reference/teamspace/remove-projects-from-teamspace.md
+++ b/docs/api-reference/teamspace/remove-projects-from-teamspace.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, teamspace, remove project
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/teamspaces/{teamspace_id}/projects/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/teamspaces/{teamspace_id}/projects/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Remove projects from a teamspace by its ID
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="teamspace_id" type="string" :required="true">
 
-Teamspace ID
+The unique identifier of the teamspace.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Teamspace ID
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/projects/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/projects/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/projects/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/projects/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -77,7 +77,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/projects/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/projects/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/teamspace/remove-teamspace-members.md b/docs/api-reference/teamspace/remove-teamspace-members.md
index 9df05a21..53c6a81c 100644
--- a/docs/api-reference/teamspace/remove-teamspace-members.md
+++ b/docs/api-reference/teamspace/remove-teamspace-members.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, teamspace, remove members
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/teamspaces/{teamspace_id}/members/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/teamspaces/{teamspace_id}/members/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Delete members from a teamspace by its ID
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="teamspace_id" type="string" :required="true">
 
-Teamspace ID
+The unique identifier of the teamspace.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Teamspace ID
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/members/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/members/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/members/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/members/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -76,15 +76,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440001/members/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/teamspace-uuid/members/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/teamspace/update-teamspace-detail.md b/docs/api-reference/teamspace/update-teamspace-detail.md
index 89534785..37d85130 100644
--- a/docs/api-reference/teamspace/update-teamspace-detail.md
+++ b/docs/api-reference/teamspace/update-teamspace-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, teamspace, update a teams
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/teamspaces/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/teamspaces/{resource_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Update a teamspace by its ID
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="resource_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the resource.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="teamspace_id" type="string" :required="true">
 
-Teamspace ID
+The unique identifier of the teamspace.
 
 </ApiParam>
 
@@ -117,7 +117,7 @@ Lead.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/resource-id-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -140,7 +140,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/resource-id-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "logo_props": "example-value",
@@ -160,26 +160,23 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "PATCH",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      logo_props: "example-value",
-      name: "Example Name",
-      description_json: "example-value",
-      description_html: "<p>Example content</p>",
-      description_stripped: "Example description",
-      created_by: "550e8400-e29b-41d4-a716-446655440000",
-      updated_by: "550e8400-e29b-41d4-a716-446655440000",
-      lead: "550e8400-e29b-41d4-a716-446655440000",
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/teamspaces/resource-id-uuid/", {
+  method: "PATCH",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    logo_props: "example-value",
+    name: "Example Name",
+    description_json: "example-value",
+    description_html: "<p>Example content</p>",
+    description_stripped: "Example description",
+    created_by: "550e8400-e29b-41d4-a716-446655440000",
+    updated_by: "550e8400-e29b-41d4-a716-446655440000",
+    lead: "550e8400-e29b-41d4-a716-446655440000",
+  }),
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/work-item-pages/add-work-item-page.md b/docs/api-reference/work-item-pages/add-work-item-page.md
index 3ca70a0b..21b5e28f 100644
--- a/docs/api-reference/work-item-pages/add-work-item-page.md
+++ b/docs/api-reference/work-item-pages/add-work-item-page.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, work item pages, create w
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/pages/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/pages/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Link a page to a work item.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="work_item_id" type="string" :required="true">
 
-Work item id.
+The unique identifier of the work item.
 
 </ApiParam>
 
@@ -81,7 +81,7 @@ API key authentication or an OAuth token with equivalent access.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/pages/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/pages/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -97,7 +97,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/pages/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/pages/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "page_id": "550e8400-e29b-41d4-a716-446655440000"
@@ -111,7 +111,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/pages/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/pages/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/work-item-pages/delete-work-item-page.md b/docs/api-reference/work-item-pages/delete-work-item-page.md
index b267f25b..82500456 100644
--- a/docs/api-reference/work-item-pages/delete-work-item-page.md
+++ b/docs/api-reference/work-item-pages/delete-work-item-page.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, work item pages, delete w
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/pages/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/pages/{page_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,33 +22,33 @@ Remove a page link from a work item.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="page_id" type="string" :required="true">
 
-Page ID
+The unique identifier of the page.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="work_item_id" type="string" :required="true">
 
-Work item id.
+The unique identifier of the work item.
 
 </ApiParam>
 
@@ -72,9 +72,9 @@ API key authentication or an OAuth token with equivalent access.
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/pages/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/pages/page-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -84,7 +84,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/pages/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/pages/page-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -95,7 +95,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/pages/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/pages/page-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/work-item-pages/get-work-item-page-detail.md b/docs/api-reference/work-item-pages/get-work-item-page-detail.md
index c2898221..20d13a52 100644
--- a/docs/api-reference/work-item-pages/get-work-item-page-detail.md
+++ b/docs/api-reference/work-item-pages/get-work-item-page-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, work item pages, get work
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/pages/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/pages/{page_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,33 +22,33 @@ Retrieve details of a specific page link for a work item.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="page_id" type="string" :required="true">
 
-Page ID
+The unique identifier of the page.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="work_item_id" type="string" :required="true">
 
-Work item id.
+The unique identifier of the work item.
 
 </ApiParam>
 
@@ -72,9 +72,9 @@ API key authentication or an OAuth token with equivalent access.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/pages/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/pages/page-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -84,7 +84,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/pages/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/pages/page-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -95,7 +95,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/pages/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/pages/page-uuid/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/work-item-pages/list-work-item-pages.md b/docs/api-reference/work-item-pages/list-work-item-pages.md
index dbd31c91..c615f61e 100644
--- a/docs/api-reference/work-item-pages/list-work-item-pages.md
+++ b/docs/api-reference/work-item-pages/list-work-item-pages.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, work item pages, list wor
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/pages/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/pages/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Retrieve all page links associated with a work item.
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue ID
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
 <ApiParam name="work_item_id" type="string" :required="true">
 
-Work item id.
+The unique identifier of the work item.
 
 </ApiParam>
 
@@ -93,9 +93,9 @@ API key authentication or an OAuth token with equivalent access.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/pages/?cursor=20:1:0&order_by=-created_at" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/pages/?cursor=20:1:0&order_by=-created_at" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -105,7 +105,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/pages/?cursor=20:1:0&order_by=-created_at",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/pages/?cursor=20:1:0&order_by=-created_at",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -116,7 +116,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/pages/?cursor=20:1:0&order_by=-created_at",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/pages/?cursor=20:1:0&order_by=-created_at",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/work-item-relations/create-work-item-relation.md b/docs/api-reference/work-item-relations/create-work-item-relation.md
new file mode 100644
index 00000000..691eacfa
--- /dev/null
+++ b/docs/api-reference/work-item-relations/create-work-item-relation.md
@@ -0,0 +1,178 @@
+---
+title: Create work item relation
+description: Create work item relation via Plane API. HTTP request format, parameters, scopes, and example responses for create work item relation.
+keywords: plane, plane api, rest api, api integration, work item relations, create work item relation
+---
+
+# Create work item relation
+
+<div class="api-endpoint-badge">
+  <span class="method post">POST</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/relations/</span>
+</div>
+
+<div class="api-two-column">
+<div class="api-left">
+
+Create relationships between work items. Supports various relation types including blocking, blocked_by, duplicate, relates_to, start_before, start_after, finish_before, and finish_after.
+
+<div class="params-section">
+
+### Path Parameters
+
+<div class="params-list">
+
+<ApiParam name="work_item_id" type="string" :required="true">
+
+The unique identifier of the work item.
+
+</ApiParam>
+
+<ApiParam name="project_id" type="string" :required="true">
+
+The unique identifier of the project.
+
+</ApiParam>
+
+<ApiParam name="workspace_slug" type="string" :required="true">
+
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
+
+</ApiParam>
+
+</div>
+</div>
+
+<div class="params-section">
+
+### Body Parameters
+
+<div class="params-list">
+
+<ApiParam name="relation_type" type="string" :required="true">
+
+Type of relationship between work items
+
+- `blocking` - Blocking
+- `blocked_by` - Blocked By
+- `duplicate` - Duplicate
+- `relates_to` - Relates To
+- `start_before` - Start Before
+- `start_after` - Start After
+- `finish_before` - Finish Before
+- `finish_after` - Finish After
+
+</ApiParam>
+
+<ApiParam name="issues" type="array" :required="true">
+
+Array of work item IDs to create relations with
+
+</ApiParam>
+
+</div>
+</div>
+
+<div class="params-section">
+
+### Scopes
+
+`projects.work_items:write`
+
+</div>
+
+</div>
+
+<div class="api-right">
+
+<CodePanel title="Create work item relation" :languages="['cURL', 'Python', 'JavaScript']">
+<template #curl>
+
+```bash
+curl -X POST \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/relations/" \
+  -H "X-API-Key: $PLANE_API_KEY" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+  "relation_type": "blocking",
+  "issues": [
+    "550e8400-e29b-41d4-a716-446655440000",
+    "550e8400-e29b-41d4-a716-446655440000"
+  ]
+}'
+```
+
+</template>
+<template #python>
+
+```python
+import requests
+
+response = requests.post(
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/relations/",
+    headers={"X-API-Key": "your-api-key"},
+    json={
+      "relation_type": "blocking",
+      "issues": [
+"550e8400-e29b-41d4-a716-446655440000",
+"550e8400-e29b-41d4-a716-446655440000"
+      ]
+    }
+)
+print(response.json())
+```
+
+</template>
+<template #javascript>
+
+```javascript
+const response = await fetch(
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/relations/",
+  {
+    method: "POST",
+    headers: {
+      "X-API-Key": "your-api-key",
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      relation_type: "blocking",
+      issues: ["550e8400-e29b-41d4-a716-446655440000", "550e8400-e29b-41d4-a716-446655440000"],
+    }),
+  }
+);
+const data = await response.json();
+```
+
+</template>
+</CodePanel>
+
+<ResponsePanel status="201">
+
+```json
+[
+  [
+    {
+      "id": "550e8400-e29b-41d4-a716-446655440000",
+      "name": "Example Name",
+      "sequence_id": 42,
+      "project_id": "550e8400-e29b-41d4-a716-446655440000",
+      "relation_type": "blocked_by",
+      "state_id": "550e8400-e29b-41d4-a716-446655440000",
+      "priority": "high",
+      "type_id": "550e8400-e29b-41d4-a716-446655440000",
+      "is_epic": false,
+      "created_at": "2024-01-01T00:00:00Z",
+      "updated_at": "2024-01-01T00:00:00Z",
+      "created_by": "550e8400-e29b-41d4-a716-446655440000",
+      "updated_by": "550e8400-e29b-41d4-a716-446655440000"
+    }
+  ]
+]
+```
+
+</ResponsePanel>
+
+</div>
+
+</div>
diff --git a/docs/api-reference/work-item-relations/list-work-item-relations.md b/docs/api-reference/work-item-relations/list-work-item-relations.md
new file mode 100644
index 00000000..d60c640b
--- /dev/null
+++ b/docs/api-reference/work-item-relations/list-work-item-relations.md
@@ -0,0 +1,158 @@
+---
+title: List work item relations
+description: List work item relations via Plane API. HTTP request format, parameters, scopes, and example responses for list work item relations.
+keywords: plane, plane api, rest api, api integration, work item relations, list work item relations
+---
+
+# List work item relations
+
+<div class="api-endpoint-badge">
+  <span class="method get">GET</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/relations/</span>
+</div>
+
+<div class="api-two-column">
+<div class="api-left">
+
+Retrieve all relationships for a work item including blocking, blocked_by, duplicate, relates_to, start_before, start_after, finish_before, and finish_after relations.
+
+<div class="params-section">
+
+### Path Parameters
+
+<div class="params-list">
+
+<ApiParam name="work_item_id" type="string" :required="true">
+
+The unique identifier of the work item.
+
+</ApiParam>
+
+<ApiParam name="project_id" type="string" :required="true">
+
+The unique identifier of the project.
+
+</ApiParam>
+
+<ApiParam name="workspace_slug" type="string" :required="true">
+
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
+
+</ApiParam>
+
+</div>
+</div>
+
+<div class="params-section">
+
+### Query Parameters
+
+<div class="params-list">
+
+<ApiParam name="cursor" type="string" :required="false">
+
+Pagination cursor for getting next set of results
+
+</ApiParam>
+
+<ApiParam name="expand" type="string" :required="false">
+
+Comma-separated list of related fields to expand in response
+
+</ApiParam>
+
+<ApiParam name="fields" type="string" :required="false">
+
+Comma-separated list of fields to include in response
+
+</ApiParam>
+
+<ApiParam name="order_by" type="string" :required="false">
+
+Field to order results by. Prefix with '-' for descending order
+
+</ApiParam>
+
+<ApiParam name="per_page" type="integer" :required="false">
+
+Number of results per page (default: 20, max: 100)
+
+</ApiParam>
+
+</div>
+</div>
+
+<div class="params-section">
+
+### Scopes
+
+`projects.work_items:read`
+
+</div>
+
+</div>
+
+<div class="api-right">
+
+<CodePanel title="List work item relations" :languages="['cURL', 'Python', 'JavaScript']">
+<template #curl>
+
+```bash
+curl -X GET \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/relations/?cursor=20:1:0&expand=assignees" \
+  -H "X-API-Key: $PLANE_API_KEY" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
+```
+
+</template>
+<template #python>
+
+```python
+import requests
+
+response = requests.get(
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/relations/?cursor=20:1:0&expand=assignees",
+    headers={"X-API-Key": "your-api-key"}
+)
+print(response.json())
+```
+
+</template>
+<template #javascript>
+
+```javascript
+const response = await fetch(
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/relations/?cursor=20:1:0&expand=assignees",
+  {
+    method: "GET",
+    headers: {
+      "X-API-Key": "your-api-key",
+    },
+  }
+);
+const data = await response.json();
+```
+
+</template>
+</CodePanel>
+
+<ResponsePanel status="200">
+
+```json
+{
+  "blocking": ["550e8400-e29b-41d4-a716-446655440000", "550e8400-e29b-41d4-a716-446655440000"],
+  "blocked_by": ["550e8400-e29b-41d4-a716-446655440000"],
+  "duplicate": [],
+  "relates_to": ["550e8400-e29b-41d4-a716-446655440000"],
+  "start_after": [],
+  "start_before": ["550e8400-e29b-41d4-a716-446655440000"],
+  "finish_after": [],
+  "finish_before": []
+}
+```
+
+</ResponsePanel>
+
+</div>
+
+</div>
diff --git a/docs/api-reference/work-item-relations/overview.md b/docs/api-reference/work-item-relations/overview.md
new file mode 100644
index 00000000..e1c88421
--- /dev/null
+++ b/docs/api-reference/work-item-relations/overview.md
@@ -0,0 +1,73 @@
+---
+title: Overview
+description: Plane Work Item Relations API overview. Learn how to list, create, and remove work item relationships using the Plane API.
+keywords: plane, plane api, rest api, api integration, work item relations, dependencies, blocking relationships
+---
+
+# Overview
+
+Work item relations let you model dependencies and planning constraints between work items, including blocking, duplicate, relates-to, and scheduling relationships.
+
+[Learn more about Work Items](https://docs.plane.so/core-concepts/issues)
+
+<div class="api-two-column">
+<div class="api-left">
+
+## The Work Item Relations Response
+
+### Attributes
+
+- `blocking` _array_
+
+  List of issue IDs that are blocking this issue
+
+- `blocked_by` _array_
+
+  List of issue IDs that this issue is blocked by
+
+- `duplicate` _array_
+
+  List of issue IDs that are duplicates of this issue
+
+- `relates_to` _array_
+
+  List of issue IDs that relate to this issue
+
+- `start_after` _array_
+
+  List of issue IDs that start after this issue
+
+- `start_before` _array_
+
+  List of issue IDs that start before this issue
+
+- `finish_after` _array_
+
+  List of issue IDs that finish after this issue
+
+- `finish_before` _array_
+
+  List of issue IDs that finish before this issue
+
+</div>
+<div class="api-right">
+
+<ResponsePanel status="200" title="THE WORK ITEM RELATIONS RESPONSE">
+
+```json
+{
+  "blocking": ["550e8400-e29b-41d4-a716-446655440000", "550e8400-e29b-41d4-a716-446655440000"],
+  "blocked_by": ["550e8400-e29b-41d4-a716-446655440000"],
+  "duplicate": [],
+  "relates_to": ["550e8400-e29b-41d4-a716-446655440000"],
+  "start_after": [],
+  "start_before": ["550e8400-e29b-41d4-a716-446655440000"],
+  "finish_after": [],
+  "finish_before": []
+}
+```
+
+</ResponsePanel>
+
+</div>
+</div>
diff --git a/docs/api-reference/work-item-relations/remove-work-item-relation.md b/docs/api-reference/work-item-relations/remove-work-item-relation.md
new file mode 100644
index 00000000..602b196c
--- /dev/null
+++ b/docs/api-reference/work-item-relations/remove-work-item-relation.md
@@ -0,0 +1,134 @@
+---
+title: Remove work item relation
+description: Remove work item relation via Plane API. HTTP request format, parameters, scopes, and example responses for remove work item relation.
+keywords: plane, plane api, rest api, api integration, work item relations, remove work item relation
+---
+
+# Remove work item relation
+
+<div class="api-endpoint-badge">
+  <span class="method post">POST</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/relations/remove/</span>
+</div>
+
+<div class="api-two-column">
+<div class="api-left">
+
+Remove a relationship between work items by specifying the related work item ID.
+
+<div class="params-section">
+
+### Path Parameters
+
+<div class="params-list">
+
+<ApiParam name="work_item_id" type="string" :required="true">
+
+The unique identifier of the work item.
+
+</ApiParam>
+
+<ApiParam name="project_id" type="string" :required="true">
+
+The unique identifier of the project.
+
+</ApiParam>
+
+<ApiParam name="workspace_slug" type="string" :required="true">
+
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
+
+</ApiParam>
+
+</div>
+</div>
+
+<div class="params-section">
+
+### Body Parameters
+
+<div class="params-list">
+
+<ApiParam name="related_issue" type="string" :required="true">
+
+ID of the related work item to remove relation with
+
+</ApiParam>
+
+</div>
+</div>
+
+<div class="params-section">
+
+### Scopes
+
+`projects.work_items:write`
+
+</div>
+
+</div>
+
+<div class="api-right">
+
+<CodePanel title="Remove work item relation" :languages="['cURL', 'Python', 'JavaScript']">
+<template #curl>
+
+```bash
+curl -X POST \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/relations/remove/" \
+  -H "X-API-Key: $PLANE_API_KEY" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+  "related_issue": "550e8400-e29b-41d4-a716-446655440000"
+}'
+```
+
+</template>
+<template #python>
+
+```python
+import requests
+
+response = requests.post(
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/relations/remove/",
+    headers={"X-API-Key": "your-api-key"},
+    json={
+      "related_issue": "550e8400-e29b-41d4-a716-446655440000"
+    }
+)
+print(response.status_code)
+```
+
+</template>
+<template #javascript>
+
+```javascript
+const response = await fetch(
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/relations/remove/",
+  {
+    method: "POST",
+    headers: {
+      "X-API-Key": "your-api-key",
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      related_issue: "550e8400-e29b-41d4-a716-446655440000",
+    }),
+  }
+);
+console.log(response.status);
+```
+
+</template>
+</CodePanel>
+
+<ResponsePanel status="204">
+
+No response body.
+
+</ResponsePanel>
+
+</div>
+
+</div>
diff --git a/docs/api-reference/worklogs/create-worklog.md b/docs/api-reference/worklogs/create-worklog.md
index d827c10c..78bd6576 100644
--- a/docs/api-reference/worklogs/create-worklog.md
+++ b/docs/api-reference/worklogs/create-worklog.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, worklogs, create a worklo
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/worklogs/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/worklogs/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ Create a new worklog entry
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue id.
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -93,7 +93,7 @@ Updated by.
 
 ```bash
 curl -X POST \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/worklogs/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/worklogs/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -112,7 +112,7 @@ curl -X POST \
 import requests
 
 response = requests.post(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/worklogs/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/worklogs/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "description": "Example description",
@@ -129,7 +129,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/worklogs/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/worklogs/",
   {
     method: "POST",
     headers: {
diff --git a/docs/api-reference/worklogs/delete-worklog.md b/docs/api-reference/worklogs/delete-worklog.md
index 8b4fca46..4b981633 100644
--- a/docs/api-reference/worklogs/delete-worklog.md
+++ b/docs/api-reference/worklogs/delete-worklog.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, worklogs, delete a worklo
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/worklogs/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/worklogs/{worklog_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Delete a worklog entry
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue id.
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="worklog_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the worklog.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -66,9 +66,9 @@ Workspace slug
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/worklogs/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/worklogs/worklog-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -78,7 +78,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/worklogs/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/worklogs/worklog-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -89,7 +89,7 @@ print(response.status_code)
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/worklogs/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/worklogs/worklog-uuid/",
   {
     method: "DELETE",
     headers: {
diff --git a/docs/api-reference/worklogs/get-total-time.md b/docs/api-reference/worklogs/get-total-time.md
index d84acea8..f420305c 100644
--- a/docs/api-reference/worklogs/get-total-time.md
+++ b/docs/api-reference/worklogs/get-total-time.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, worklogs, get total time
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/total-worklogs/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/total-worklogs/</span>
 </div>
 
 <div class="api-two-column">
@@ -24,13 +24,13 @@ Get project worklog summary
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/total-worklogs/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/total-worklogs/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/total-worklogs/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/total-worklogs/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -77,7 +77,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/total-worklogs/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/total-worklogs/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/worklogs/get-worklogs-for-issue.md b/docs/api-reference/worklogs/get-worklogs-for-issue.md
index e6e4d92a..ce50a178 100644
--- a/docs/api-reference/worklogs/get-worklogs-for-issue.md
+++ b/docs/api-reference/worklogs/get-worklogs-for-issue.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, worklogs, list all worklo
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/worklogs/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/worklogs/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,21 +22,21 @@ List worklog entries
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue id.
+The unique identifier of the work item.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -60,9 +60,9 @@ Workspace slug
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/worklogs/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/worklogs/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -72,7 +72,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/worklogs/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/worklogs/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -83,7 +83,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/worklogs/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/worklogs/",
   {
     method: "GET",
     headers: {
diff --git a/docs/api-reference/worklogs/update-worklog.md b/docs/api-reference/worklogs/update-worklog.md
index a53773fb..2fbfd614 100644
--- a/docs/api-reference/worklogs/update-worklog.md
+++ b/docs/api-reference/worklogs/update-worklog.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, worklogs, update a worklo
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/projects/{project_id}/work-items/{issue_id}/worklogs/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/worklogs/{worklog_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,27 +22,27 @@ Update a worklog entry
 
 <div class="params-list">
 
-<ApiParam name="issue_id" type="string" :required="true">
+<ApiParam name="work_item_id" type="string" :required="true">
 
-Issue id.
+The unique identifier of the work item.
 
 </ApiParam>
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="worklog_id" type="string" :required="true">
 
-Pk.
+The unique identifier of the worklog.
 
 </ApiParam>
 
 <ApiParam name="project_id" type="string" :required="true">
 
-Project ID
+The unique identifier of the project.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -99,7 +99,7 @@ Updated by.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/worklogs/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/worklogs/worklog-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -118,7 +118,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/worklogs/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/worklogs/worklog-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "description": "Example description",
@@ -135,7 +135,7 @@ print(response.json())
 
 ```javascript
 const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/550e8400-e29b-41d4-a716-446655440000/work-items/550e8400-e29b-41d4-a716-446655440001/worklogs/550e8400-e29b-41d4-a716-446655440000/",
+  "https://api.plane.so/api/v1/workspaces/my-workspace/projects/project-uuid/work-items/work-item-uuid/worklogs/worklog-uuid/",
   {
     method: "PATCH",
     headers: {
diff --git a/docs/api-reference/workspace-features/get-workspace-features.md b/docs/api-reference/workspace-features/get-workspace-features.md
index a469a4b9..86fa942c 100644
--- a/docs/api-reference/workspace-features/get-workspace-features.md
+++ b/docs/api-reference/workspace-features/get-workspace-features.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, workspace features, get w
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/features/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/features/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Get the features of a workspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -50,7 +50,7 @@ Workspace slug
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/features/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/workspace-features/update-workspace-features.md b/docs/api-reference/workspace-features/update-workspace-features.md
index 61d1fbce..d1446d34 100644
--- a/docs/api-reference/workspace-features/update-workspace-features.md
+++ b/docs/api-reference/workspace-features/update-workspace-features.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, workspace features, updat
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/features/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/features/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Update the features of a workspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/workspace-invitations/add-workspace-invitation.md b/docs/api-reference/workspace-invitations/add-workspace-invitation.md
index 8b29887a..e79c69d3 100644
--- a/docs/api-reference/workspace-invitations/add-workspace-invitation.md
+++ b/docs/api-reference/workspace-invitations/add-workspace-invitation.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, workspace invitations, cr
 
 <div class="api-endpoint-badge">
   <span class="method post">POST</span>
-  <span class="path">/api/v1/workspaces/{slug}/invitations/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/invitations/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ Create a workspace invite
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
diff --git a/docs/api-reference/workspace-invitations/delete-workspace-invitation.md b/docs/api-reference/workspace-invitations/delete-workspace-invitation.md
index 556fa283..13bf7392 100644
--- a/docs/api-reference/workspace-invitations/delete-workspace-invitation.md
+++ b/docs/api-reference/workspace-invitations/delete-workspace-invitation.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, workspace invitations, de
 
 <div class="api-endpoint-badge">
   <span class="method delete">DELETE</span>
-  <span class="path">/api/v1/workspaces/{slug}/invitations/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/invitations/{invitation_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Delete a workspace invite
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="invitation_id" type="string" :required="true">
 
-Workspace invite ID
+The unique identifier of the invitation.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace admin or owner permission required.
 
 ```bash
 curl -X DELETE \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/invitation-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X DELETE \
 import requests
 
 response = requests.delete(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/invitation-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.status_code)
@@ -76,15 +76,12 @@ print(response.status_code)
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "DELETE",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/invitations/invitation-uuid/", {
+  method: "DELETE",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 console.log(response.status);
 ```
 
diff --git a/docs/api-reference/workspace-invitations/get-workspace-invitation-detail.md b/docs/api-reference/workspace-invitations/get-workspace-invitation-detail.md
index 08cdd46d..b7b3532b 100644
--- a/docs/api-reference/workspace-invitations/get-workspace-invitation-detail.md
+++ b/docs/api-reference/workspace-invitations/get-workspace-invitation-detail.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, workspace invitations, ge
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/invitations/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/invitations/{invitation_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Get a workspace invite by ID
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="invitation_id" type="string" :required="true">
 
-Workspace invite ID
+The unique identifier of the invitation.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -54,9 +54,9 @@ Workspace admin or owner permission required.
 
 ```bash
 curl -X GET \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/invitation-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
@@ -66,7 +66,7 @@ curl -X GET \
 import requests
 
 response = requests.get(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/invitation-uuid/",
     headers={"X-API-Key": "your-api-key"}
 )
 print(response.json())
@@ -76,15 +76,12 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "GET",
-    headers: {
-      "X-API-Key": "your-api-key",
-    },
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/invitations/invitation-uuid/", {
+  method: "GET",
+  headers: {
+    "X-API-Key": "your-api-key",
+  },
+});
 const data = await response.json();
 ```
 
diff --git a/docs/api-reference/workspace-invitations/list-workspace-invitations.md b/docs/api-reference/workspace-invitations/list-workspace-invitations.md
index 169c95a5..a1444a9d 100644
--- a/docs/api-reference/workspace-invitations/list-workspace-invitations.md
+++ b/docs/api-reference/workspace-invitations/list-workspace-invitations.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, workspace invitations, li
 
 <div class="api-endpoint-badge">
   <span class="method get">GET</span>
-  <span class="path">/api/v1/workspaces/{slug}/invitations/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/invitations/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,9 +22,9 @@ List all workspace invites for a workspace
 
 <div class="params-list">
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -50,7 +50,7 @@ Workspace admin or owner permission required.
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/" \
   -H "X-API-Key: $PLANE_API_KEY" \
-  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"
 ```
 
 </template>
diff --git a/docs/api-reference/workspace-invitations/update-workspace-invitation.md b/docs/api-reference/workspace-invitations/update-workspace-invitation.md
index 85aeb5b3..ba1f435a 100644
--- a/docs/api-reference/workspace-invitations/update-workspace-invitation.md
+++ b/docs/api-reference/workspace-invitations/update-workspace-invitation.md
@@ -8,7 +8,7 @@ keywords: plane, plane api, rest api, api integration, workspace invitations, up
 
 <div class="api-endpoint-badge">
   <span class="method patch">PATCH</span>
-  <span class="path">/api/v1/workspaces/{slug}/invitations/{pk}/</span>
+  <span class="path">/api/v1/workspaces/{workspace_slug}/invitations/{invitation_id}/</span>
 </div>
 
 <div class="api-two-column">
@@ -22,15 +22,15 @@ Update a workspace invite
 
 <div class="params-list">
 
-<ApiParam name="pk" type="string" :required="true">
+<ApiParam name="invitation_id" type="string" :required="true">
 
-Workspace invite ID
+The unique identifier of the invitation.
 
 </ApiParam>
 
-<ApiParam name="slug" type="string" :required="true">
+<ApiParam name="workspace_slug" type="string" :required="true">
 
-Workspace slug
+The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`.
 
 </ApiParam>
 
@@ -77,7 +77,7 @@ Workspace admin or owner permission required.
 
 ```bash
 curl -X PATCH \
-  "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/550e8400-e29b-41d4-a716-446655440000/" \
+  "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/invitation-uuid/" \
   -H "X-API-Key: $PLANE_API_KEY" \
   # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
@@ -94,7 +94,7 @@ curl -X PATCH \
 import requests
 
 response = requests.patch(
-    "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/550e8400-e29b-41d4-a716-446655440000/",
+    "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/invitation-uuid/",
     headers={"X-API-Key": "your-api-key"},
     json={
       "email": "Example Name",
@@ -108,20 +108,17 @@ print(response.json())
 <template #javascript>
 
 ```javascript
-const response = await fetch(
-  "https://api.plane.so/api/v1/workspaces/my-workspace/invitations/550e8400-e29b-41d4-a716-446655440000/",
-  {
-    method: "PATCH",
-    headers: {
-      "X-API-Key": "your-api-key",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      email: "Example Name",
-      role: 20,
-    }),
-  }
-);
+const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/invitations/invitation-uuid/", {
+  method: "PATCH",
+  headers: {
+    "X-API-Key": "your-api-key",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    email: "Example Name",
+    role: 20,
+  }),
+});
 const data = await response.json();
 ```