[Ready][Many toolkits] Adding Who Am I tool documentation (#426)

* updating documentation

* Remove unwanted example files, keep only who_am_i and generate_google_file_picker_url files

* fixing some docs

* adding for notion

* adding Jira who am i tool info

* updating docs for slack and google slides

---------

Co-authored-by: Francisco Liberal <[email protected]>

Author: jottakka

pages/toolkits/customer-support/zendesk.mdx

@@ -11,7 +11,7 @@ import ToolFooter from "@/components/ToolFooter";
   author="Arcade"
   codeLink="https://github.com/ArcadeAI/arcade-ai/tree/main/toolkits/zendesk"
   authType="OAuth2"
-  versions={["0.1.0"]}
+  versions={["1.0.0"]}
 />
 
 <Badges repo="arcadeai/arcade_zendesk" />
@@ -37,6 +37,7 @@ This toolkit streamlines the process of handling customer inquiries and accessin
       ["Zendesk.AddTicketComment", "Add a comment to an existing Zendesk ticket."],
       ["Zendesk.MarkTicketSolved", "Mark a Zendesk ticket as solved, optionally with a final comment."],
       ["Zendesk.SearchArticles", "Search for Help Center articles in your Zendesk knowledge base."],
+      ["Zendesk.WhoAmI", "Get comprehensive user profile and Zendesk account information."],
     ]
   }
 />
@@ -189,6 +190,31 @@ Search for Help Center articles in your Zendesk knowledge base.
 
 This tool requires the following secrets: `zendesk_subdomain` (learn how to [configure secrets](/home/build-tools/create-a-tool-with-secrets#supplying-the-secret))
 
+## Zendesk.WhoAmI
+
+<br />
+<TabbedCodeBlock
+  tabs={[
+    {
+      label: "Call the Tool Directly",
+      content: {
+        Python: ["/examples/integrations/toolkits/zendesk/who_am_i_example_call_tool.py"],
+        JavaScript: ["/examples/integrations/toolkits/zendesk/who_am_i_example_call_tool.js"],
+      },
+    },
+  ]}
+/>
+
+Get comprehensive user profile and Zendesk account information.
+
+**Parameters**
+
+This tool does not take any parameters.
+
+**Secrets**
+
+This tool requires the following secrets: `zendesk_subdomain` (learn how to [configure secrets](/home/build-tools/create-a-tool-with-secrets#supplying-the-secret))
+
 
 
 <ToolFooter pipPackageName="arcade_zendesk" />

pages/toolkits/customer-support/zendesk/reference.mdx

@@ -19,3 +19,5 @@ Below is a reference of enumerations used by some tools in the Zendesk toolkit:
 
 - **CREATED_AT**: `created_at`
 - **RELEVANCE**: `relevance`
+
+

pages/toolkits/productivity/gmail.mdx

@@ -11,7 +11,7 @@ import ToolFooter from "@/components/ToolFooter";
   author="Arcade"
   authType="oauth2"
   authProviderName="Google"
-  versions={["0.1.0"]}
+  versions={["3.1.0"]}
 />
 
 <Badges repo="arcadeai/arcade_gmail" />
@@ -43,6 +43,7 @@ These tools are currently available in the Arcade Gmail toolkit.
     ["Gmail.SearchThreads", "Search for threads in the user's mailbox."],
     ["Gmail.ListThreads", "List threads in the user's mailbox."],
     ["Gmail.GetThread", "Get the specified thread by ID."],
+    ["Gmail.WhoAmI", "Get comprehensive user profile and Gmail account information."],
   ]}
 />
 
@@ -385,6 +386,27 @@ Get the specified thread by ID.
 
 - **`thread_id`** _(string, required)_ The ID of the thread to retrieve.
 
+## Gmail.WhoAmI
+
+<br />
+<TabbedCodeBlock
+  tabs={[
+    {
+      label: "Call the Tool Directly",
+      content: {
+        Python: ["/examples/integrations/toolkits/gmail/who_am_i_example_call_tool.py"],
+        JavaScript: ["/examples/integrations/toolkits/gmail/who_am_i_example_call_tool.js"],
+      },
+    },
+  ]}
+/>
+
+Get comprehensive user profile and Gmail account information.
+
+**Parameters**
+
+This tool does not take any parameters.
+
 ## Auth
 
 The Arcade Gmail toolkit uses the [Google auth provider](/home/auth-providers/google) to connect to users' Google accounts.

pages/toolkits/productivity/gmail/reference.mdx

@@ -0,0 +1,20 @@
+# Gmail Reference
+
+Below is a reference of enumerations used by some tools in the Gmail toolkit:
+
+## GmailReplyToWhom
+
+- **EVERY_RECIPIENT**: `every_recipient`
+- **ONLY_THE_SENDER**: `only_the_sender`
+
+## DateRange
+
+- **TODAY**: `today`
+- **YESTERDAY**: `yesterday`
+- **LAST_7_DAYS**: `last_7_days`
+- **LAST_30_DAYS**: `last_30_days`
+- **THIS_MONTH**: `this_month`
+- **LAST_MONTH**: `last_month`
+- **THIS_YEAR**: `this_year`
+
+

pages/toolkits/productivity/google_calendar.mdx

@@ -11,7 +11,7 @@ import ToolFooter from "@/components/ToolFooter";
   author="Arcade"
   authType="oauth2"
   authProviderName="Google"
-  versions={["0.1.0"]}
+  versions={["3.1.0"]}
 />
 
 <Badges repo="arcadeai/arcade_google_calendar" />
@@ -33,6 +33,7 @@ These tools are currently available in the Arcade Google Calendar toolkit.
     ["GoogleCalendar.UpdateEvent", "Update an existing event in Google Calendar."],
     ["GoogleCalendar.DeleteEvent", "Delete an event from Google Calendar."],
     ["GoogleCalendar.FindTimeSlotsWhenEveryoneIsFree", "Provides time slots when everyone is free within a given date range and time boundaries."],
+    ["GoogleCalendar.WhoAmI", "Get comprehensive user profile and Google Calendar environment information."],
   ]}
 />
 
@@ -229,6 +230,29 @@ Provides time slots when everyone is free within a given date range and time bou
 
 ---
 
+## GoogleCalendar.WhoAmI
+
+<br />
+<TabbedCodeBlock
+  tabs={[
+    {
+      label: "Call the Tool Directly",
+      content: {
+        Python: ["/examples/integrations/toolkits/google_calendar/who_am_i_example_call_tool.py"],
+        JavaScript: ["/examples/integrations/toolkits/google_calendar/who_am_i_example_call_tool.js"],
+      },
+    },
+  ]}
+/>
+
+Get comprehensive user profile and Google Calendar environment information.
+
+**Parameters**
+
+This tool does not take any parameters.
+
+---
+
 ## Auth
 
 The Arcade Google Calendar toolkit uses the [Google auth provider](/home/auth-providers/google) to connect to users' Google accounts.

pages/toolkits/productivity/google_calendar/reference.mdx

@@ -0,0 +1,18 @@
+# GoogleCalendar Reference
+
+Below is a reference of enumerations used by some tools in the GoogleCalendar toolkit:
+
+## EventVisibility
+
+- **DEFAULT**: `default`
+- **PUBLIC**: `public`
+- **PRIVATE**: `private`
+- **CONFIDENTIAL**: `confidential`
+
+## SendUpdatesOptions
+
+- **NONE**: `none`
+- **ALL**: `all`
+- **EXTERNAL_ONLY**: `externalOnly`
+
+

pages/toolkits/productivity/google_contacts.mdx

@@ -11,7 +11,7 @@ import ToolFooter from "@/components/ToolFooter";
   author="Arcade"
   authType="oauth2"
   authProviderName="Google"
-  versions={["0.1.0"]}
+  versions={["3.1.0"]}
 />
 
 <Badges repo="arcadeai/arcade_google_contacts" />
@@ -31,6 +31,7 @@ These tools are currently available in the Arcade Google Contacts toolkit.
     ["GoogleContacts.SearchContactsByEmail", "Search the user's contacts in Google Contacts by email address."],
     ["GoogleContacts.SearchContactsByName", "Search the user's contacts in Google Contacts by name."],
     ["GoogleContacts.CreateContact", "Create a new contact record in Google Contacts."],
+    ["GoogleContacts.WhoAmI", "Get comprehensive user profile and Google Contacts environment information."],
   ]}
 />
 
@@ -121,6 +122,28 @@ Create a new contact record in Google Contacts.
 - **`family_name`** _(string, optional)_: The optional family name of the contact.
 - **`email`** _(string, optional)_: The optional email address of the contact.
 
+---
+
+## GoogleContacts.WhoAmI
+
+<br />
+<TabbedCodeBlock
+  tabs={[
+    {
+      label: "Call the Tool with User Authorization",
+      content: {
+        Python: ["/examples/integrations/toolkits/google_contacts/who_am_i_example_call_tool.py"],
+        JavaScript: ["/examples/integrations/toolkits/google_contacts/who_am_i_example_call_tool.js"],
+      },
+    },
+  ]}
+/>
+
+Get comprehensive user profile and Google Contacts environment information.
+
+**Parameters**
+
+This tool does not take any parameters.
 
 ---
 

pages/toolkits/productivity/google_docs.mdx

@@ -11,7 +11,7 @@ import ToolFooter from "@/components/ToolFooter";
   author="Arcade"
   authType="oauth2"
   authProviderName="Google"
-  versions={["0.1.0"]}
+  versions={["4.1.0"]}
 />
 
 <Warning>
@@ -31,6 +31,7 @@ These tools are currently available in the Arcade Google Docs toolkit.
 <TableOfContents
   headers={["Tool Name", "Description"]}
   data={[
+    ["GoogleDocs.WhoAmI", "Get comprehensive user profile and Google Docs environment information."],
     ["GoogleDocs.GetDocumentById", "Retrieve a Google Docs document by ID.", ],
     ["GoogleDocs.GetDocumentAsDocMD", "Retrieve a Google Docs document by ID in DocMD format with metadata tags.", ],
     ["GoogleDocs.EditDocument", "Edit a Google Docs document using natural language edit requests.", ],
@@ -51,6 +52,29 @@ These tools are currently available in the Arcade Google Docs toolkit.
   provider](/home/auth-providers/google#using-google-auth-in-custom-tools).
 </Tip>
 
+## GoogleDocs.WhoAmI
+
+<br />
+<TabbedCodeBlock
+  tabs={[
+    {
+      label: "Call the Tool with User Authorization",
+      content: {
+        Python: ["/examples/integrations/toolkits/google_docs/who_am_i_example_call_tool.py"],
+        JavaScript: ["/examples/integrations/toolkits/google_docs/who_am_i_example_call_tool.js"],
+      },
+    },
+  ]}
+/>
+
+Get comprehensive user profile and Google Docs environment information.
+
+**Parameters**
+
+This tool does not take any parameters.
+
+---
+
 ## GoogleDocs.GetDocumentById
 
 <br />

pages/toolkits/productivity/google_docs/reference.mdx

@@ -0,0 +1,36 @@
+# GoogleDocs Reference
+
+Below is a reference of enumerations used by some tools in the GoogleDocs toolkit:
+
+## OrderBy
+
+- **CREATED_TIME**: `createdTime`
+- **CREATED_TIME_DESC**: `createdTime desc`
+- **FOLDER**: `folder`
+- **FOLDER_DESC**: `folder desc`
+- **MODIFIED_BY_ME_TIME**: `modifiedByMeTime`
+- **MODIFIED_BY_ME_TIME_DESC**: `modifiedByMeTime desc`
+- **MODIFIED_TIME**: `modifiedTime`
+- **MODIFIED_TIME_DESC**: `modifiedTime desc`
+- **NAME**: `name`
+- **NAME_DESC**: `name desc`
+- **NAME_NATURAL**: `name_natural`
+- **NAME_NATURAL_DESC**: `name_natural desc`
+- **QUOTA_BYTES_USED**: `quotaBytesUsed`
+- **QUOTA_BYTES_USED_DESC**: `quotaBytesUsed desc`
+- **RECENCY**: `recency`
+- **RECENCY_DESC**: `recency desc`
+- **SHARED_WITH_ME_TIME**: `sharedWithMeTime`
+- **SHARED_WITH_ME_TIME_DESC**: `sharedWithMeTime desc`
+- **STARRED**: `starred`
+- **STARRED_DESC**: `starred desc`
+- **VIEWED_BY_ME_TIME**: `viewedByMeTime`
+- **VIEWED_BY_ME_TIME_DESC**: `viewedByMeTime desc`
+
+## DocumentFormat
+
+- **MARKDOWN**: `markdown`
+- **HTML**: `html`
+- **GOOGLE_API_JSON**: `google_api_json`
+
+

pages/toolkits/productivity/google_drive.mdx

@@ -10,7 +10,7 @@ import ToolFooter from "@/components/ToolFooter";
   description="Enable agents to interact with GoogleDrive"
   author="Arcade"
   authType="OAuth2"
-  versions={["3.0.0"]}
+  versions={["4.1.0"]}
 />
 
 <Badges repo="arcadeai/arcade_google_drive" />
@@ -27,6 +27,7 @@ The GoogleDrive toolkit provides a set of tools for interacting with Google Driv
   headers={["Tool Name", "Description"]}
   data={
     [
+      ["GoogleDrive.WhoAmI", "Get comprehensive user profile and Google Drive environment information."],
       ["GoogleDrive.GetFileTreeStructure", "Get the file/folder tree structure of the user's Google Drive."],
       ["GoogleDrive.GenerateGoogleFilePickerUrl", "Generate a Google File Picker URL for user-driven file selection and authorization."],
       ["GoogleDrive.SearchFiles", "Search for files in Google Drive"],
@@ -40,6 +41,29 @@ The GoogleDrive toolkit provides a set of tools for interacting with Google Driv
   own tools](/home/build-tools/create-a-toolkit).
 </Tip>
 
+## GoogleDrive.WhoAmI
+
+<br />
+<TabbedCodeBlock
+  tabs={[
+    {
+      label: "Call the Tool with User Authorization",
+      content: {
+        Python: ["/examples/integrations/toolkits/google_drive/who_am_i_example_call_tool.py"],
+        JavaScript: ["/examples/integrations/toolkits/google_drive/who_am_i_example_call_tool.js"],
+      },
+    },
+  ]}
+/>
+
+Get comprehensive user profile and Google Drive environment information.
+
+**Parameters**
+
+This tool does not take any parameters.
+
+---
+
 ## GoogleDrive.GetFileTreeStructure
 
 <br />