Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

22.1 MB
Raw Blame
[
  {
    "slug": "gmail",
    "name": "Gmail",
    "logo": "https://logos.composio.dev/api/gmail",
    "description": "Gmail is Google’s email service, featuring spam protection, search functions, and seamless integration with other G Suite apps for productivity",
    "category": "email",
    "authSchemes": [
      "OAUTH2"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 63,
    "triggerCount": 2,
    "version": "20260903_00",
    "tools": [
      {
        "slug": "GMAIL_ADD_LABEL_TO_EMAIL",
        "name": "Modify email labels",
        "description": "Adds and/or removes specified Gmail labels for a message; ensure `message_id` and all `label_ids` are valid (use 'listLabels' for custom label IDs)."
      },
      {
        "slug": "GMAIL_BATCH_DELETE_MESSAGES",
        "name": "Batch delete Gmail messages",
        "description": "Tool to permanently delete multiple Gmail messages in bulk, bypassing Trash with no recovery possible. Use when you need to efficiently remove large numbers of emails (e.g., retention enforcement, mailbox hygiene). Use GMAIL_MOVE_TO_TRASH instead when reversibility may be needed. Always obtain explicit user confirmation and verify a sample of message IDs before executing. High-volume calls may trigger 429 rateLimitExceeded or 403 userRateLimitExceeded errors; apply exponential backoff."
      },
      {
        "slug": "GMAIL_BATCH_MODIFY_MESSAGES",
        "name": "Batch modify Gmail messages",
        "description": "Modify labels on multiple Gmail messages in one efficient API call. Supports up to 1,000 messages per request for bulk operations like archiving, marking as read/unread, or applying custom labels. High-volume calls may return 429 rateLimitExceeded or 403 userRateLimitExceeded; apply exponential backoff."
      },
      {
        "slug": "GMAIL_CREATE_EMAIL_DRAFT",
        "name": "Create email draft",
        "description": "Creates a Gmail email draft. While all fields are optional per the Gmail API, practical validation requires at least one of recipient_email, cc, or bcc and at least one of subject or body. Supports To/Cc/Bcc recipients, subject, plain/HTML body (ensure `is_html=True` for HTML), attachments, and threading. Returns a draft_id that must be used as-is with GMAIL_SEND_DRAFT — synthetic or stale IDs will fail. When creating a draft reply to an existing thread (thread_id provided), leave subject empty to stay in the same thread; setting a subject will create a NEW thread instead. HTTP 429 may occur on rapid creation/send sequences; apply exponential backoff."
      },
      {
        "slug": "GMAIL_CREATE_FILTER",
        "name": "Create Gmail filter",
        "description": "Tool to create a new Gmail filter with specified criteria and actions. Use when the user wants to automatically organize incoming messages based on sender, subject, size, or other criteria. Note: you can only create a maximum of 1,000 filters per account."
      },
      {
        "slug": "GMAIL_CREATE_LABEL",
        "name": "Create label",
        "description": "Creates a new label with a unique name in the specified user's Gmail account. Returns a labelId (e.g., 'Label_123') required for downstream tools like GMAIL_ADD_LABEL_TO_EMAIL, GMAIL_BATCH_MODIFY_MESSAGES, and GMAIL_MODIFY_THREAD_LABELS — those tools do not accept display names."
      },
      {
        "slug": "GMAIL_CREATE_PROMPT_POST",
        "name": "Create Prompt Post",
        "description": "Send a one-shot prompt to the Sanity Content Agent. Stateless one-shot prompt endpoint. No thread management or message persistence. Ideal for simple, single-turn interactions. Use when you need to send a single prompt and receive a response without maintaining conversation context."
      },
      {
        "slug": "GMAIL_DELETE_DRAFT",
        "name": "Delete Draft",
        "description": "Permanently deletes a specific Gmail draft using its ID with no recovery possible; verify the correct `draft_id` and obtain explicit user confirmation before calling. Ensure the draft exists and the user has necessary permissions for the given `user_id`."
      },
      {
        "slug": "GMAIL_DELETE_FILTER",
        "name": "Delete Gmail filter",
        "description": "Tool to permanently delete a Gmail filter by its ID. Use when you need to remove an existing email filtering rule."
      },
      {
        "slug": "GMAIL_DELETE_LABEL",
        "name": "Delete label from account (permanent)",
        "description": "Permanently DELETES a user-created Gmail label from the account (not from a message). WARNING: This action DELETES the label definition itself, removing it from all messages. System labels (INBOX, SENT, UNREAD, etc.) cannot be deleted. To add/remove labels from specific messages, use GMAIL_ADD_LABEL_TO_EMAIL action instead."
      },
      {
        "slug": "GMAIL_DELETE_MESSAGE",
        "name": "Delete message",
        "description": "Permanently deletes a specific email message by its ID from a Gmail mailbox; for `user_id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated access."
      },
      {
        "slug": "GMAIL_DELETE_THREAD",
        "name": "Delete thread",
        "description": "Tool to immediately and permanently delete a specified thread and all its messages. This operation cannot be undone. Use threads.trash instead for reversible deletion."
      },
      {
        "slug": "GMAIL_FETCH_EMAILS",
        "name": "Fetch emails",
        "description": "Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval. Results are NOT sorted by recency; sort by internalDate client-side. The messages field may be absent or empty (valid no-results state); always null-check before accessing messageId or threadId. Null-check subject and header fields before string operations. For large result sets, prefer ids_only=true or metadata-only listing, then hydrate via GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID."
      },
      {
        "slug": "GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID",
        "name": "Fetch message by message ID",
        "description": "Fetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id`. Spam/trash messages are excluded unless upstream list/search calls used `include_spam_trash=true`. Use `internalDate` (milliseconds since epoch) rather than header `Date` for recency checks."
      },
      {
        "slug": "GMAIL_FETCH_MESSAGE_BY_THREAD_ID",
        "name": "Fetch Message by Thread ID",
        "description": "Retrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`. Returns a `messages` array; `thread_id` is not echoed in the response. Message order is not guaranteed — sort by `internalDate` to find oldest/newest. Check `labelIds` per message to filter drafts. Concurrent bulk calls may trigger 403 `userRateLimitExceeded` or 429; cap concurrency ~10 and use exponential backoff."
      },
      {
        "slug": "GMAIL_FORWARD_MESSAGE",
        "name": "Forward email message",
        "description": "Forward an existing Gmail message to specified recipients, preserving original body and attachments. Verify recipients and content before forwarding to avoid unintended exposure. Bulk forwarding may trigger 429/5xx rate limits; keep concurrency to 5–10 and apply backoff. Messages near Gmail's size limits may fail; reconstruct a smaller draft if needed."
      },
      {
        "slug": "GMAIL_GET_ATTACHMENT",
        "name": "Get Gmail attachment",
        "description": "Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs. Returns the downloaded file with its MIME type and filename. Attachments exceeding ~25 MB may be exposed as Google Drive links — use GOOGLEDRIVE_DOWNLOAD_FILE when a Drive file_id is present instead."
      },
      {
        "slug": "GMAIL_GET_AUTO_FORWARDING",
        "name": "Get Auto-Forwarding Settings",
        "description": "Tool to get the auto-forwarding setting for the specified account. Use when you need to retrieve the current auto-forwarding configuration including enabled status, forwarding email address, and message disposition."
      },
      {
        "slug": "GMAIL_GET_CONTACTS",
        "name": "Get contacts",
        "description": "Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination. Only covers saved contacts and 'Other Contacts'; email-header-only senders are out of scope. Contact records may have sparse data — handle missing fields gracefully. People API shares a per-user QPS quota; HTTP 429 requires exponential backoff (1s, 2s, 4s)."
      },
      {
        "slug": "GMAIL_GET_DRAFT",
        "name": "Get Draft",
        "description": "Retrieves a single Gmail draft by its ID. Use this to fetch and inspect draft content before sending via GMAIL_SEND_DRAFT. The format parameter controls the level of detail returned."
      },
      {
        "slug": "GMAIL_GET_FILTER",
        "name": "Get Gmail filter",
        "description": "Tool to retrieve a specific Gmail filter by its ID. Use when you need to inspect the criteria and actions of an existing filter."
      },
      {
        "slug": "GMAIL_GET_LABEL",
        "name": "Get label details",
        "description": "Gets details for a specified Gmail label. Use this to retrieve label information including name, type, visibility settings, message/thread counts, and color."
      },
      {
        "slug": "GMAIL_GET_LANGUAGE_SETTINGS",
        "name": "Get Language Settings",
        "description": "Tool to retrieve the language settings for a Gmail user. Use when you need to determine the display language preference for the authenticated user or a specific Gmail account."
      },
      {
        "slug": "GMAIL_GET_PEOPLE",
        "name": "Get People",
        "description": "Retrieves either a specific person's details (using `resource_name`) or lists 'Other Contacts' (if `other_contacts` is true), with `person_fields` specifying the data to return. Scope is limited to the authenticated user's own contacts and 'Other Contacts' history only."
      },
      {
        "slug": "GMAIL_GET_PROFILE",
        "name": "Get Profile",
        "description": "Retrieves Gmail profile information (email address, aggregate messagesTotal/threadsTotal, historyId) for a user. messagesTotal counts individual emails; threadsTotal counts conversations; neither is per-label — use GMAIL_FETCH_EMAILS with label filters for label-specific counts. The returned historyId seeds incremental sync via GMAIL_LIST_HISTORY; if historyIdTooOld is returned, rescan with GMAIL_FETCH_EMAILS before resuming. Response may be wrapped under a top-level data field; unwrap before reading fields. A successful call confirms mailbox connectivity but not full mailbox access if granted scopes are narrow. Use the returned email address to dynamically identify the authenticated account rather than hard-coding it."
      },
      {
        "slug": "GMAIL_GET_VACATION_SETTINGS",
        "name": "Get Vacation Settings",
        "description": "Tool to retrieve vacation responder settings for a Gmail user. Use when you need to check if out-of-office auto-replies are configured and view their content."
      },
      {
        "slug": "GMAIL_IMPORT_MESSAGE",
        "name": "Import message",
        "description": "Tool to import a message into the user's mailbox with standard email delivery scanning and classification. Use when you need to add an existing email to a Gmail account without sending it through SMTP. This method doesn't perform SPF checks, so it might not work for some spam messages."
      },
      {
        "slug": "GMAIL_INSERT_MESSAGE",
        "name": "Insert message into mailbox",
        "description": "Tool to insert a message into the user's mailbox similar to IMAP APPEND. Use when you need to add an email directly to a mailbox bypassing most scanning and classification. This does not send a message."
      },
      {
        "slug": "GMAIL_LIST_CSE_IDENTITIES",
        "name": "List CSE identities",
        "description": "Tool to list client-side encrypted identities for an authenticated user. Use when you need to retrieve CSE identity configurations including key pair associations."
      },
      {
        "slug": "GMAIL_LIST_CSE_KEYPAIRS",
        "name": "List CSE key pairs",
        "description": "Tool to list client-side encryption key pairs for an authenticated user. Use when you need to retrieve CSE keypair configurations including public keys and enablement states. Supports pagination for large result sets."
      },
      {
        "slug": "GMAIL_LIST_DRAFTS",
        "name": "List Drafts",
        "description": "Retrieves a paginated list of email drafts from a user's Gmail account. Use verbose=true to get full draft details including subject, body, sender, and timestamp. Draft ordering is non-guaranteed; iterate using page_token until it is absent to retrieve all drafts. Newly created drafts may not appear immediately. Rapid calls may trigger 403 userRateLimitExceeded or 429 errors; apply exponential backoff (1s, 2s, 4s) before retrying."
      },
      {
        "slug": "GMAIL_LIST_FILTERS",
        "name": "List Gmail filters",
        "description": "Tool to list all Gmail filters (rules) in the mailbox. Use for security audits to detect malicious filter rules or before creating new filters to avoid duplicates."
      },
      {
        "slug": "GMAIL_LIST_FORWARDING_ADDRESSES",
        "name": "List forwarding addresses",
        "description": "Tool to list all forwarding addresses for the specified Gmail account. Use when you need to retrieve the email addresses that are allowed to be used for forwarding messages."
      },
      {
        "slug": "GMAIL_LIST_HISTORY",
        "name": "List Gmail history",
        "description": "Tool to list Gmail mailbox change history since a known startHistoryId. Use for incremental mailbox syncs. Persist the latest historyId as a checkpoint across sessions; without it, incremental sync is unreliable. An empty history list in the response is valid and means no new changes occurred."
      },
      {
        "slug": "GMAIL_LIST_LABELS",
        "name": "List Gmail labels",
        "description": "Retrieves all system and user-created labels for a Gmail account in a single unpaginated response. Primary use: obtain internal label IDs (e.g., 'Label_123') required by other Gmail tools — display names cannot be used as label identifiers and cause silent failures or errors. System labels (INBOX, UNREAD, SPAM, TRASH, etc.) are case-sensitive and must be used exactly as returned; INBOX, SPAM, and TRASH are read-only and cannot be added/removed via label modification tools. The Gmail search 'label:' operator accepts display names, but label_ids parameters in tools like GMAIL_FETCH_EMAILS require internal IDs from this tool — mixing conventions yields zero results silently. Do not hardcode label IDs across sessions; refresh via this tool on conflict errors."
      },
      {
        "slug": "GMAIL_LIST_MESSAGES",
        "name": "List Gmail messages (Deprecated)",
        "description": "DEPRECATED: Use GMAIL_FETCH_EMAILS instead. Lists the messages in the user's mailbox. Use when you need to retrieve a list of email messages with optional filtering by labels or search query."
      },
      {
        "slug": "GMAIL_LIST_SEND_AS",
        "name": "List send-as aliases",
        "description": "Lists the send-as aliases for a Gmail account, including the primary address and custom 'from' aliases. Use when you need to retrieve available sending addresses for composing emails."
      },
      {
        "slug": "GMAIL_LIST_SMIME_INFO",
        "name": "List S/MIME configs",
        "description": "Lists S/MIME configs for the specified send-as alias. Use when you need to retrieve all S/MIME certificate configurations associated with a specific send-as email address."
      },
      {
        "slug": "GMAIL_LIST_THREADS",
        "name": "List threads",
        "description": "Retrieves a list of email threads from a Gmail account, identified by `user_id` (email address or 'me'), supporting filtering and pagination. Spam and trash are excluded by default unless explicitly targeted via `label:spam` or `label:trash` in the query."
      },
      {
        "slug": "GMAIL_MODIFY_THREAD_LABELS",
        "name": "Modify thread labels",
        "description": "Adds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid. To modify a single message only, use a message-level tool instead."
      },
      {
        "slug": "GMAIL_MOVE_THREAD_TO_TRASH",
        "name": "Trash thread",
        "description": "Moves the specified thread to the trash. Any messages that belong to the thread are also moved to the trash."
      },
      {
        "slug": "GMAIL_MOVE_TO_TRASH",
        "name": "Move to Trash",
        "description": "Moves an existing, non-deleted email message to the trash for the specified user. Trashed messages are recoverable and still count toward storage quota until purged. Prefer this over GMAIL_BATCH_DELETE_MESSAGES when recovery may be needed. For bulk operations, use GMAIL_BATCH_MODIFY_MESSAGES or GMAIL_BATCH_DELETE_MESSAGES instead of repeated calls to this tool."
      },
      {
        "slug": "GMAIL_PATCH_LABEL",
        "name": "Patch Label",
        "description": "Patches the specified user-created label. System labels (e.g., INBOX, SENT, SPAM) cannot be modified and will be rejected."
      },
      {
        "slug": "GMAIL_PATCH_SEND_AS",
        "name": "Patch send-as alias",
        "description": "Tool to patch the specified send-as alias for a Gmail user. Use when you need to update properties of an existing send-as email address such as display name, reply-to address, signature, default status, or SMTP configuration."
      },
      {
        "slug": "GMAIL_REMOVE_LABEL",
        "name": "Remove label (Deprecated)",
        "description": "DEPRECATED: Use GMAIL_DELETE_LABEL instead. Permanently deletes a specific, existing user-created Gmail label by its ID for a user; cannot delete system labels."
      },
      {
        "slug": "GMAIL_REPLY_TO_THREAD",
        "name": "Reply to email thread",
        "description": "Sends a reply within a specific Gmail thread using the original thread's subject; do not provide a custom subject as it will start a new conversation instead of replying in-thread. Requires a valid `thread_id` and at least one of `recipient_email`, `cc`, or `bcc`. Supports optional file attachments."
      },
      {
        "slug": "GMAIL_SEARCH_PEOPLE",
        "name": "Search People",
        "description": "Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'Other Contacts'. Only searches the authenticated user's contact directory — people existing solely in message headers won't appear; use GMAIL_FETCH_EMAILS for those. Results may be zero or multiple; never auto-select from ambiguous results. Results paginate via next_page_token; follow until empty and deduplicate by email. Many records lack emailAddresses or names even when requested — handle missing keys. Directory/organization policies may suppress entries."
      },
      {
        "slug": "GMAIL_SEND_DRAFT",
        "name": "Send Draft",
        "description": "Sends an existing draft email AS-IS to recipients already defined within the draft. IMPORTANT: This action does NOT accept recipient parameters (to, cc, bcc). The Gmail API's drafts/send endpoint sends drafts to whatever recipients are already set in the draft's To, Cc, and Bcc headers - it cannot add or override recipients. If the draft has no recipients, you must either: 1. Create a new draft with recipients using GMAIL_CREATE_EMAIL_DRAFT, then send it 2. Use GMAIL_SEND_EMAIL to send a new email directly with recipients. Send is immediate and irreversible — confirm recipients and content before calling. No scheduling support; trigger at the desired UTC time externally. Gmail enforces ~25 MB message size limit and daily send caps (~500 recipients/day personal, ~2,000/day Workspace)."
      },
      {
        "slug": "GMAIL_SEND_EMAIL",
        "name": "Send Email",
        "description": "Sends an email via Gmail API using the authenticated user's Google profile display name. Sends immediately and is irreversible — confirm recipients, subject, body, and attachments before calling. At least one of 'to' (or 'recipient_email'), 'cc', or 'bcc' must be provided. At least one of subject or body must be provided. Requires `is_html=True` if the body contains HTML. All common file types including PNG, JPG, PDF, MP4, etc. are supported as attachments. Gmail API limits total message size to ~25 MB after base64 encoding. To reply in an existing thread, use GMAIL_REPLY_TO_THREAD instead. No scheduled send support; enforce timing externally."
      },
      {
        "slug": "GMAIL_SETTINGS_GET_IMAP",
        "name": "Get IMAP Settings",
        "description": "Retrieves the IMAP settings for a Gmail user account, including whether IMAP is enabled, auto-expunge behavior, expunge behavior, and maximum folder size."
      },
      {
        "slug": "GMAIL_SETTINGS_GET_POP",
        "name": "Get POP settings",
        "description": "Tool to retrieve POP settings for a Gmail account. Use when you need to check the current POP configuration including access window and message disposition."
      },
      {
        "slug": "GMAIL_SETTINGS_SEND_AS_GET",
        "name": "Get send-as alias",
        "description": "Tool to retrieve a specific send-as alias configuration for a Gmail user. Use when you need to get details about a send-as email address including display name, signature, SMTP settings, and verification status. Fails with HTTP 404 if the specified address is not a member of the send-as collection."
      },
      {
        "slug": "GMAIL_STOP_WATCH",
        "name": "Stop watch notifications",
        "description": "Tool to stop receiving push notifications for a Gmail mailbox. Use when you need to disable watch notifications previously set up via the watch endpoint."
      },
      {
        "slug": "GMAIL_UNTRASH_MESSAGE",
        "name": "Untrash Message",
        "description": "Tool to remove a message from trash in Gmail. Use when you need to restore a previously trashed email message."
      },
      {
        "slug": "GMAIL_UNTRASH_THREAD",
        "name": "Untrash thread",
        "description": "Tool to remove a thread from trash in Gmail. Use when you need to restore a deleted thread and its messages."
      },
      {
        "slug": "GMAIL_UPDATE_DRAFT",
        "name": "Update draft",
        "description": "Updates (replaces) an existing Gmail draft's content in-place by draft ID. This action replaces the entire draft content with the new message - it does not patch individual fields. All fields are optional; if not provided, you should provide complete draft content to avoid data loss."
      },
      {
        "slug": "GMAIL_UPDATE_IMAP_SETTINGS",
        "name": "Update IMAP settings",
        "description": "Tool to update IMAP settings for a Gmail account. Use when you need to modify IMAP configuration such as enabling/disabling IMAP, setting auto-expunge behavior, or configuring folder size limits."
      },
      {
        "slug": "GMAIL_UPDATE_LABEL",
        "name": "Update Label",
        "description": "Tool to update the properties of an existing Gmail label. Use when you need to modify label name, visibility settings, or color."
      },
      {
        "slug": "GMAIL_UPDATE_LANGUAGE_SETTINGS",
        "name": "Update Language Settings",
        "description": "Tool to update the language settings for a Gmail user. Use when you need to change the display language preference for the authenticated user or a specific Gmail account. The returned displayLanguage may differ from the requested value if Gmail selects a close variant."
      },
      {
        "slug": "GMAIL_UPDATE_POP_SETTINGS",
        "name": "Update POP settings",
        "description": "Tool to update POP settings for a Gmail account. Use when you need to configure POP access window or message disposition behavior."
      },
      {
        "slug": "GMAIL_UPDATE_SEND_AS",
        "name": "Update send-as alias",
        "description": "Tool to update a send-as alias for a Gmail user. Use when you need to modify display name, signature, reply-to address, or SMTP settings for a send-as email address. Gmail sanitizes HTML signatures before saving. Addresses other than the primary can only be updated by service accounts with domain-wide authority."
      },
      {
        "slug": "GMAIL_UPDATE_USER_ATTRIBUTES_VALUES",
        "name": "Update User Attributes Values",
        "description": "Update user attribute values for a resource. Use this action to set or update custom attributes for a user within an organization or project. When setting a value for an attribute key that also exists in SAML, the Sanity value will take precedence and shadow the SAML value."
      },
      {
        "slug": "GMAIL_UPDATE_VACATION_SETTINGS",
        "name": "Update Vacation Settings",
        "description": "Tool to update vacation responder settings for a Gmail user. Use when you need to configure out-of-office auto-replies."
      }
    ],
    "triggers": [
      {
        "slug": "GMAIL_EMAIL_SENT_TRIGGER",
        "name": "Email Sent",
        "description": "Triggers when a Gmail message is sent by the authenticated user. It polls the\n'SENT' label and emits metadata including sender, recipients, subject, timestamp,\nand thread ID."
      },
      {
        "slug": "GMAIL_NEW_GMAIL_MESSAGE",
        "name": "New Gmail Message Received Trigger",
        "description": "Triggers when a new message is received in Gmail."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "gmail_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "https://www.googleapis.com/auth/userinfo.profile,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/contacts.readonly,https://www.googleapis.com/auth/contacts.other.readonly,https://www.googleapis.com/auth/profile.language.read,https://www.googleapis.com/auth/user.addresses.read,https://www.googleapis.com/auth/user.birthday.read,https://www.googleapis.com/auth/user.emails.read,https://www.googleapis.com/auth/user.phonenumbers.read,https://www.googleapis.com/auth/profile.emails.read,https://mail.google.com/"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "composio",
    "name": "Composio",
    "logo": "https://logos.composio.dev/api/composio",
    "description": "Composio enables AI Agents and LLMs to authenticate and integrate with various tools via function calling.",
    "category": "ai agents",
    "authSchemes": [
      "NO_AUTH"
    ],
    "toolCount": 19,
    "triggerCount": 0,
    "version": "20260813_00",
    "tools": [
      {
        "slug": "COMPOSIO_CHECK_ACTIVE_CONNECTION",
        "name": "Check active connection (deprecated)",
        "description": "Deprecated: use check active connections instead for bulk operations. check active connection status for a toolkit or specific connected account id. returns connection details if active, or required parameters for establishing connection if none exists. active connections enable agent actions on the toolkit."
      },
      {
        "slug": "COMPOSIO_CHECK_ACTIVE_CONNECTIONS",
        "name": "Check multiple active connections",
        "description": "Check active connection status for multiple toolkits or specific connected account ids. returns connection details if active, or required parameters for establishing connection if none exists. active connections enable agent actions on toolkits."
      },
      {
        "slug": "COMPOSIO_CREATE_PLAN",
        "name": "Create Plan",
        "description": "\nThis is a workflow builder that ensures the LLM produces a complete, step-by-step plan for any use case.\nWHEN TO CALL:\n- Call this tool based on COMPOSIO_SEARCH_TOOLS output. If search tools response indicates create_plan should be called and the usecase is not easy, call it.\n- Use this tool after COMPOSIO_SEARCH_TOOLS or COMPOSIO_MANAGE_CONNECTIONS to generate an execution plan for the user's use case.\n- USE for medium or hard tasks — skip it for easy ones.\n- If the user switches to a new use case in the same chat and COMPOSIO_SEARCH_TOOLS again instructs you to call the planner, you MUST call this tool again for that new use case.\n\nMemory Integration:\n- You can choose to add the memory received from the search tool into the known_fields parameter of the plan function to enhance planning with discovered relationships and information.\n\nOutputs a complete plan with sections such as \"workflow_steps\", \"complexity_assessment\", \"decision_matrix\", \"failure_handling\" \"output_format\", and more as needed.\n\nIf you skip this step for non-easy tasks, workflows will likely be incomplete, or fail during execution for complex tasks.\nCalling it guarantees reliable, accurate, and end-to-end workflows aligned with the available tools and connections.\n    "
      },
      {
        "slug": "COMPOSIO_ENABLE_TRIGGER",
        "name": "Enable trigger",
        "description": "Enable a specific trigger for the authenticated user."
      },
      {
        "slug": "COMPOSIO_EXECUTE_TOOL",
        "name": "Execute Composio Tool",
        "description": "Execute a tool using the composio api."
      },
      {
        "slug": "COMPOSIO_GET_DEPENDENCY_GRAPH",
        "name": "Get Tool Dependency Graph",
        "description": "Get the dependency graph for a given tool, showing related parent tools that might be useful. this action calls the composio labs dependency graph api to retrieve tools that are commonly used together with or before the specified tool. this helps discover related tools and understand common workflows."
      },
      {
        "slug": "COMPOSIO_GET_REQUIRED_PARAMETERS",
        "name": "Get required parameters for connection",
        "description": "Gets the required parameters for connecting to a toolkit via initiate connection. returns the exact parameter names and types needed for initiate connection's parameters field. supports api keys, oauth credentials, connection fields, and hybrid authentication scenarios. if has default credentials is true, you can call initiate connection with empty parameters for seamless oauth flow."
      },
      {
        "slug": "COMPOSIO_GET_RESPONSE_SCHEMA",
        "name": "Get response schema",
        "description": "Retrieves the response schema for a specified composio tool. this action fetches the complete response schema definition for any valid composio tool, returning it as a dictionary that describes the expected response structure."
      },
      {
        "slug": "COMPOSIO_INITIATE_CONNECTION",
        "name": "Initiate connection",
        "description": "Initiate a connection to a toolkit with comprehensive authentication support. supports all authentication scenarios: 1. composio default oauth (no parameters needed) 2. custom oauth (user's client id/client secret) 3. api key/bearer token authentication 4. basic auth (username/password) 5. hybrid scenarios (oauth + connection fields like site name) 6. connection-only fields (subdomain, api key at connection level) 7. no authentication required automatically detects and validates auth config vs connection fields, provides helpful error messages for missing parameters."
      },
      {
        "slug": "COMPOSIO_LIST_TOOLKITS",
        "name": "List toolkits",
        "description": "List all the available toolkits on composio with filtering options."
      },
      {
        "slug": "COMPOSIO_LIST_TRIGGERS",
        "name": "List triggers",
        "description": "List available triggers and their configuration schemas."
      },
      {
        "slug": "COMPOSIO_MANAGE_CONNECTIONS",
        "name": "Manage connections",
        "description": "\nCreate or manage connections to user's apps. Returns a branded authentication link that works for OAuth, API keys, and all other auth types.\n\nCall policy:\n- First call COMPOSIO_SEARCH_TOOLS for the user's query.\n- If COMPOSIO_SEARCH_TOOLS indicates there is no active connection for a toolkit, call COMPOSIO_MANAGE_CONNECTIONS with the exact toolkit name(s) returned.\n- Use exact toolkit slugs returned by COMPOSIO_SEARCH_TOOLS; never invent toolkit names.\n- NEVER execute any toolkit tool without an ACTIVE connection.\n\nTool Behavior:\n- If a connection is Active, the tool returns the connection details. Always use this to verify connection status and fetch metadata.\n- If a connection is not Active, returns a authentication link (redirect_url) to create new connection.\n- If reinitiate_all is true, the tool forces reconnections for all toolkits, even if they already have active connections.\n\nWorkflow after initiating connection:\n- Always show the returned redirect_url as a FORMATTED MARKDOWN LINK to the user, and ask them to click on the link to finish authentication.\n- Begin executing tools only after the connection for that toolkit is confirmed Active.\n    "
      },
      {
        "slug": "COMPOSIO_MULTI_EXECUTE_TOOL",
        "name": "Multi Execute Composio Tools",
        "description": "\n  Fast and parallel tool executor for tools discovered through COMPOSIO_SEARCH_TOOLS. Use this tool to execute up to 50 tools in parallel across apps only when they're logically independent (no ordering/output dependencies). Response contains structured outputs ready for immediate analysis - avoid reprocessing them via remote bash/workbench tools.\n\nPrerequisites:\n- Always use valid tool slugs and their arguments. NEVER invent tool slugs or argument fields. ALWAYS pass STRICTLY schema-compliant arguments with each tool execution.\n- Ensure an ACTIVE connection exists for the toolkits that are going to be executed. If none exists, MUST initiate one via COMPOSIO_MANAGE_CONNECTIONS before execution.\n- Only batch tools that are logically independent - no ordering, no output-to-input dependencies, and no intra-call chaining (tools in one call can't use each other's outputs). DO NOT pass dummy or placeholder inputs; always resolve required inputs using appropriate tools first.\n\nUsage guidelines:\n- If COMPOSIO_SEARCH_TOOLS returns a tool that can perform the task, prefer calling it via this executor. Do not write custom API calls or ad-hoc scripts for tasks that can be completed by available Composio tools.\n- Prefer parallel execution: group independent tools into a single multi-execute call where possible.\n- Predictively set sync_response_to_workbench=true if the response may be large or needed for later scripting. It still shows response inline; if the actual response data turns out small and easy to handle, keep everything inline and SKIP workbench usage.\n- Responses contain structured outputs for each tool. RULE: Small data - process yourself inline; large data - process in the workbench.\n- ALWAYS include inline references/links to sources in MARKDOWN format directly next to the relevant text. Eg provide slack thread links alongside with summary, render document links instead of raw IDs.\n\nRestrictions: Some tools or toolkits may be disabled in this environment. If the response indicates a restriction, inform the user and STOP execution immediately. Do NOT attempt workarounds or speculative actions.\n\n\n- CRITICAL: You MUST always include the 'memory' parameter - never omit it. Even if you think there's nothing to remember, include an empty object {} for memory.\n\nMemory Storage:\n- CRITICAL FORMAT: Memory must be a dictionary where keys are app names (strings) and values are arrays of strings. NEVER pass nested objects or dictionaries as values.\n- CORRECT format: {\"slack\": [\"Channel general has ID C1234567\"], \"gmail\": [\"John's email is [email protected]\"]}\n- Write memory entries in natural, descriptive language - NOT as key-value pairs. Use full sentences that clearly describe the relationship or information.\n- ONLY store information that will be valuable for future tool executions - focus on persistent data that saves API calls.\n- STORE: ID mappings, entity relationships, configs, stable identifiers.\n- DO NOT STORE: Action descriptions, temporary status updates, logs, or \"sent/fetched\" confirmations.\n- Examples of GOOD memory (store these):\n  * \"The important channel in Slack has ID C1234567 and is called #general\"\n  * \"The team's main repository is owned by user 'teamlead' with ID 98765\"\n  * \"The user prefers markdown docs with professional writing, no emojis\" (user_preference)\n- Examples of BAD memory (DON'T store these):\n  * \"Successfully sent email to [email protected] with message hi\"\n  * \"Fetching emails from last day (Sep 6, 2025) for analysis\"\n- Do not repeat the memories stored or found previously.\n"
      },
      {
        "slug": "COMPOSIO_REMOTE_BASH_TOOL",
        "name": "Run bash commands",
        "description": "\n  Execute bash commands in a REMOTE sandbox for file operations, data processing, and system tasks. Essential for handling large tool responses saved to remote files. **Hard 3-minute (180s) execution limit** — break large tasks into smaller commands.\n  PRIMARY USE CASES:\n- Process large tool responses saved by COMPOSIO_MULTI_EXECUTE_TOOL to remote sandbox\n- File system operations, extract specific information from JSON with shell tools like jq, awk, sed, grep, etc.\n- Commands run from /home/user directory by default\n    "
      },
      {
        "slug": "COMPOSIO_REMOTE_WORKBENCH",
        "name": "Execute Code remotely in work bench",
        "description": "\n  Process **REMOTE FILES** or script BULK TOOL EXECUTIONS using Python code IN A REMOTE SANDBOX. If you can see the data in chat, DON'T USE THIS TOOL.\n**ONLY** use this when processing **data stored in a remote file** or when scripting bulk tool executions.\n\nDO NOT USE\n- When the complete response is already inline/in-memory, or you only need quick parsing, summarization, or basic math.\n\nUSE IF\n- To parse/analyze tool outputs saved by COMPOSIO_MULTI_EXECUTE_TOOL to a remote file in the sandbox or to script multi-tool chains there.\n- For bulk or repeated executions of known Composio tools (e.g., add a label to 100 emails).\n- To call APIs via proxy_execute when no Composio tool exists for that API.\n\n\nOUTPUTS\n- Returns a compact result or, if too long, artifacts under `/mnt/files/.composio/output` (cloud-backed FUSE mount, persisted across sandbox restarts).\n\nIMPORTANT CODING RULES:\n  1. Stepwise Execution: Split work into small steps. Save intermediate outputs to `/mnt/files/` (cloud-backed, persisted across failures/timeouts) or variables. Call COMPOSIO_REMOTE_WORKBENCH again for the next step.\n  2. Notebook Persistence: This is a persistent Jupyter notebook cell: variables, functions, imports, and in-memory state persist across executions. Helper functions are preloaded.\n  3. Top-level cells: Do not use `return`; Jupyter only allows it inside functions. For final values, end with `output` or `print(output)`, not `return output`.\n  4. Parallelism & Timeout (CRITICAL): There is a **hard 3-minute (180s) execution limit** per cell. Always prioritize PARALLEL execution using ThreadPoolExecutor for bulk operations - e.g., call run_composio_tool or invoke_llm across rows. If data is large, split it into smaller batches across cells.\n  5. Checkpoints: Save checkpoints to `/mnt/files/` so that long runs can be resumed from the last completed step, even after a timeout or sandbox restart.\n  6. Schema Safety: Never assume the response schema for run_composio_tool if not known already from previous tools. To inspect schema, either run a simple request **outside** the workbench or use invoke_llm helper.\n  7. LLM Helpers: Always use invoke_llm helper for summary, analysis, or field extraction on results; prefer it for much better results over ad hoc filtering.\n  8. Avoid Meta Loops: Do not use run_composio_tool to call COMPOSIO_* meta tools. Only use it for app tools.\n  9. Pagination: Use when data spans multiple pages. Continue fetching pages with the returned next_page_token or cursor until none remains. Parallelize page fetches when the tool supports page_number.\n  10. No Hardcoding: Never hardcode data. Load it from files or tool responses, iterating to construct intermediate or final inputs/outputs.\n  11. If the final output is in a workbench file, use upload_local_file to download it - never expose the raw workbench file path to the user. Prefer to download useful artifacts after task is complete.\n\n\nENV & HELPERS:\n- Home directory: `/home/user`.\n- NOTE: Helper functions already initialized in the workbench - DO NOT import or redeclare them:\n    - \n`run_composio_tool(tool_slug: str, arguments: dict) -> tuple[Dict[str, Any], str]`: Execute a known Composio **app** tool. Do not invent names; match the tool input schema. Use for loops/parallel/bulk calls.\n      i) run_composio_tool returns JSON with top-level \"data\". Parse carefully—structure may be nested.\n    \n    - \n`invoke_llm(query: str) -> tuple[str, str]`: Invoke an LLM for semantic tasks. Pass MAX 200k characters.\n      i) NOTE Prompting guidance: When building prompts for invoke_llm, prefer f-strings (or concatenation) so literal braces stay intact. If using str.format, escape braces by doubling them ({{ }}).\n      ii) Define the exact JSON schema you want and batch items into smaller groups to stay within token limit.\n\n    - `upload_local_file(*file_paths) -> tuple[Dict[str, Any], str]`: Upload sandbox files to Composio S3/R2 storage for user-downloadable artifacts.\n    - `proxy_execute(method, endpoint, toolkit, query_params=None, body=None, headers=None) -> tuple[Any, str]`: Call a toolkit API directly when no Composio tool exists. Only one toolkit can be invoked with proxy_execute per workbench call\n    - `web_search(query: str) -> tuple[str, str]`: Search the web for information.\n    - `smart_file_extract(sandbox_file_path: str, show_preview: bool = True) -> tuple[str, str]`: Extracts text from files in the sandbox (e.g., PDF, image).\n  All helper functions return a tuple (result, error). Always check error before using result.\n\n## Python Helper Functions for LLM Scripting\n\n\n### run_composio_tool\nExecutes a known Composio tool via backend API. Do NOT call COMPOSIO_* meta tools to avoid cycles.\n\n    def run_composio_tool(tool_slug: str, arguments: Dict[str, Any]) -> tuple[Dict[str, Any], str]\n    # Returns: (tool_response_dict, error_message)\n    #   Success: ({\"data\": {actual_data}}, \"\") - Note the top-level data\n    #   Error:   ({}, \"error_message\") or (response_data, \"error_message\")\n\n    result, error = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 1, \"user_id\": \"me\"})\n    if error:\n        print(\"GMAIL_FETCH_EMAILS error:\", error)\n    else:\n        email_data = result.get(\"data\", {})\n        print(\"Fetched:\", email_data)\n    \n\n\n### invoke_llm\nCalls LLM for reasoning, analysis, and semantic tasks. Pass MAX 200k characters.\n\n    # Returns: (llm_response, error_message)\n\n    # Example: analyze tool response with LLM\n    tool_resp, err = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 5, \"user_id\": \"me\"})\n    if not err:\n      parsed = tool_resp.get(\"data\", {})\n      resp, err2 = invoke_llm(f\"Summarize these emails: {parsed}\")\n      if not err2:\n        print(resp)\n    # TIP: batch prompts to reduce LLM calls.\n    \n\n\n### upload_local_file\nUploads sandbox files to Composio S3/R2 storage for upload/download requests involving generated sandbox artifacts. Single files upload directly; multiple files are auto-zipped.\n\n    # Returns: (result_dict, error_string)\n    # Success: ({\"s3_url\": str, \"uploaded_file\": str, \"type\": str, \"id\": str, \"s3key\": str, \"message\": str}, \"\")\n    # Error: ({}, \"error_message\")\n\n    # Single file\n    result, error = upload_local_file(\"/path/to/report.pdf\")\n\n    # Multiple files are auto-zipped\n    result, error = upload_local_file(\"/home/user/doc1.txt\", \"/home/user/doc2.txt\")\n\n    if not error:\n      print(\"Uploaded:\", result[\"s3_url\"])\n\n\n### proxy_execute\nDirect API call to a connected toolkit service.\n\n    def proxy_execute(\n        method: Literal[\"GET\",\"POST\",\"PUT\",\"DELETE\",\"PATCH\"],\n        endpoint: str,\n        toolkit: str,\n        query_params: Optional[Dict[str, str]] = None,\n        body: Optional[object] = None,\n        headers: Optional[Dict[str, str]] = None,\n    ) -> tuple[Any, str]\n    # Returns: (response_data, error_message)\n\n    # Example: GET request with query parameters\n    query_params = {\"q\": \"is:unread\", \"maxResults\": \"10\"}\n    data, error = proxy_execute(\"GET\", \"/gmail/v1/users/me/messages\", \"gmail\", query_params=query_params)\n    if not error:\n      print(\"Success:\", data)\n\n\n### web_search\nSearches the web via Exa AI.\n\n    # Returns: (search_results_text, error_message)\n\n    results, error = web_search(\"latest developments in AI\")\n    if not error:\n        print(\"Results:\", results)\n\n## Best Practices\n\n\n### Error-first pattern and Defensive parsing (print keys while narrowing)\n    res, err = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 5})\n    if err:\n        print(\"error:\", err)\n    elif isinstance(res, dict):\n        print(\"res keys:\", list(res.keys()))\n        data = res.get(\"data\") or {}\n        print(\"data keys:\", list(data.keys()))\n        msgs = data.get(\"messages\") or []\n        print(\"messages count:\", len(msgs))\n        for m in msgs:\n            print(\"subject:\", m.get(\"subject\", \"<missing>\"))\n\n### Parallelize within the 3-minute cell timeout\nAdjust concurrency so all tasks finish within 3 minutes.\n\n    import concurrent.futures\n\n    MAX_CONCURRENCY = 10 # Adjust as needed\n\n    def process_one(item):\n        result, error = run_composio_tool(\"GMAIL_SEND_EMAIL\", item)\n        if error:\n            return {\"status\": \"failed\", \"error\": error}\n        return {\"status\": \"ok\", \"data\": result}\n\n    with concurrent.futures.ThreadPoolExecutor(max_workers=MAX_CONCURRENCY) as ex:\n        results = list(ex.map(process_one, items))\n    \n\n    "
      },
      {
        "slug": "COMPOSIO_SEARCH_TOOLS",
        "name": "Search Composio Tools",
        "description": "\n  Tool Server Info: Composio connects 500+ apps—Slack, GitHub, Notion, Google Workspace (Gmail, Sheets, Drive, Calendar), Microsoft (Outlook, Teams), X/Twitter, Figma, Web Search / Deep research, Browser tool (scrape URLs, browser automation), Meta apps (Instagram, Meta Ads), TikTok, and more—for seamless cross-app automation.\n  Use this tool to discover relevant tools plus the recommended plan and common pitfalls for reliable execution.\n  Always call this tool first whenever a user mentions or implies an external app, service, or workflow—never say \"I don't have access to X/Y app\" before calling it.\n\nUsage guidelines:\n  - Use this tool whenever kicking off a task. Re-run it when you need additional tools/plans due to missing details, errors, or a changed use case.\n  - Use search_strategy: \"auto\" normally. If the returned plan does not match the current request or an expected tool is missing, retry the same queries with search_strategy: \"tool_search\" to bypass cached plans and run direct tool search.\n  - If the user pivots to a different use case in same chat, you MUST call this tool again with the new use case and generate a new session_id.\n  - Specify the use_case with a normalized description of the problem, query, or task. Be clear and precise. Queries can be simple single-app actions or multiple linked queries for complex cross-app workflows.\n  - Pass known_fields along with use_case as a string of key–value hints (for example, \"channel_name: general\") to help the search resolve missing details such as IDs.\n  \n\nSplitting guidelines (Important):\n  1. Atomic queries: 1 query = 1 tool call. Include hidden prerequisites (e.g., add \"get Linear issue\" before \"update Linear issue\").\n  2. Include app names: If user names a toolkit, include it in every sub query so intent stays scoped (e.g., \"fetch Gmail emails\", \"reply to Gmail email\").\n  3. English input: Translate non-English prompts while preserving intent and identifiers.\n\n  Example:\n  User query: \"send an email to John welcoming him and create a meeting invite for tomorrow\"\n  Search call: queries: [\n    {use_case: \"send an email to someone\", known_fields: \"recipient_name: John\"},\n    {use_case: \"create a meeting invite\", known_fields: \"meeting_date: tomorrow\"}\n  ]\n\nPlan review checklist (Important):\n  - The response includes a detailed execution plan and common pitfalls. You MUST review this plan carefully, adapt it to your current context, and generate your own final step-by-step plan before execution. Execute the steps in order to ensure reliable and accurate execution. Skipping or ignoring required steps can lead to unexpected failures.\n  - Check the plan and pitfalls for input parameter nuances (required fields, IDs, formats, limits). Before executing any tool, you MUST review its COMPLETE input schema and provide STRICTLY schema-compliant arguments to avoid invalid-input errors.\n  - Determine whether pagination is needed; if a response returns a pagination token and completeness is implied, paginate until exhaustion and do not return partial results.\n\nResponse:\n  - Tools & Input Schemas: The response lists toolkits (apps) and tools suitable for the task, along with their tool_slug, description, input schema / schemaRef, and related tools for prerequisites, alternatives, or next steps.\n    - NOTE: Tools with schemaRef instead of input_schema require you to call COMPOSIO_GET_TOOL_SCHEMAS first to load their full input_schema before use.\n  - Connection Info: If a toolkit has an active connection, the response includes it along with any available current user information. If no active connection exists, you MUST initiate a new connection via COMPOSIO_MANAGE_CONNECTIONS with the correct toolkit name. DO NOT execute any toolkit tool without an ACTIVE connection.\n  - Time Info: The response includes the current UTC time for reference. You can reference UTC time from the response if needed.\n  \n  - The tools returned to you through this are to be called via COMPOSIO_MULTI_EXECUTE_TOOL. Ensure each tool execution specifies the correct tool_slug and arguments exactly as defined by the tool's input schema.\n    - The response includes a memory parameter containing relevant information about the use case and the known fields that can be used to determine the flow of execution. Any user preferences in memory must be adhered to.\n\nSESSION: ALWAYS set this parameter, first for any workflow. Pass session: {generate_id: true} for new workflows OR session: {id: \"EXISTING_ID\"} to continue. ALWAYS use the returned session_id in ALL subsequent meta tool calls.\n    "
      },
      {
        "slug": "COMPOSIO_WAIT_FOR_CONNECTION",
        "name": "Wait for connection",
        "description": "Wait for connections to be established for given toolkits."
      },
      {
        "slug": "COMPOSIO_WAIT_FOR_CONNECTIONS",
        "name": "Wait for connection",
        "description": "\nWait for user auth to finish. Call ONLY after you have shown the Auth link from COMPOSIO_MANAGE_CONNECTIONS.\nWait until mode=any/all toolkits reach a terminal state (ACTIVE/FAILED) or timeout.\n\nExample Input: { toolkits: [\"gmail\",\"outlook\"], mode: \"any\" }\n    "
      },
      {
        "slug": "COMPOSIO_GET_TOOL_SCHEMAS",
        "name": "Get Tool Schemas",
        "description": "Retrieve input schemas for tools by slug. Returns complete parameter definitions required to execute each tool. Only pass tool slugs returned by COMPOSIO_SEARCH_TOOLS — never guess or fabricate slugs. If unsure of the exact slug, call COMPOSIO_SEARCH_TOOLS first."
      }
    ],
    "triggers": [],
    "authConfigDetails": [
      {
        "mode": "NO_AUTH",
        "name": "Composio",
        "fields": {
          "auth_config_creation": {
            "required": [],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "github",
    "name": "GitHub",
    "logo": "https://logos.composio.dev/api/github",
    "description": "GitHub is a code hosting platform for version control and collaboration, offering Git-based repository management, issue tracking, and continuous integration features",
    "category": "developer tools",
    "authSchemes": [
      "OAUTH2"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 893,
    "triggerCount": 46,
    "version": "20260902_00",
    "tools": [
      {
        "slug": "GITHUB_ABORT_REPOSITORY_MIGRATION",
        "name": "Abort Repository Migration",
        "description": "Tool to abort a repository migration that is queued or in progress. Use when you need to cancel an ongoing migration operation."
      },
      {
        "slug": "GITHUB_ACCEPT_REPOSITORY_INVITATION",
        "name": "Accept a repository invitation",
        "description": "Accepts a PENDING repository invitation that has been issued to the authenticated user."
      },
      {
        "slug": "GITHUB_ADD_APP_ACCESS_RESTRICTIONS",
        "name": "Add app access restrictions",
        "description": "Adds GitHub Apps to the list of apps allowed to push to a protected branch. The branch must already have protection rules with restrictions enabled. This endpoint only works for organization repositories, not personal repositories. Apps must be installed on the repository with 'contents' write permissions."
      },
      {
        "slug": "GITHUB_ADD_A_REPOSITORY_COLLABORATOR",
        "name": "Add a repository collaborator",
        "description": "Adds a GitHub user as a repository collaborator, or updates their permission if already a collaborator; `permission` applies to organization-owned repositories (personal ones default to 'push' and ignore this field), and an invitation may be created or permissions updated directly."
      },
      {
        "slug": "GITHUB_ADD_ASSIGNEES_TO_AN_ISSUE",
        "name": "Add assignees to an issue",
        "description": "Adds assignees to a GitHub issue. This action only adds users - it does not remove existing assignees. Changes are silently ignored if the authenticated user lacks push access to the repository."
      },
      {
        "slug": "GITHUB_ADD_EMAIL_ADDRESS_FOR_AUTHENTICATED_USER",
        "name": "Add email for auth user",
        "description": "Adds one or more email addresses (which will be initially unverified) to the authenticated user's GitHub account; use this to associate new emails, noting an email verified for another account will error, while an existing email for the current user is accepted."
      },
      {
        "slug": "GITHUB_ADD_FIELD_TO_USER_PROJECT",
        "name": "Add field to user project",
        "description": "Tool to add a custom field to a user-owned GitHub Projects V2 project. Use when you need to add fields like status, priority, or custom data to organize project items."
      },
      {
        "slug": "GITHUB_ADD_ITEM_TO_USER_PROJECT",
        "name": "Add item to user project",
        "description": "Tool to add an issue or pull request to a user-owned GitHub project. Use when you need to add existing repository items to a project board."
      },
      {
        "slug": "GITHUB_ADD_LABELS_TO_AN_ISSUE",
        "name": "Add labels to an issue",
        "description": "Adds labels (provided in the request body) to a repository issue; labels that do not already exist are created."
      },
      {
        "slug": "GITHUB_ADD_ORG_RUNNER_LABELS",
        "name": "Add org runner labels",
        "description": "Adds new custom labels to an existing self-hosted runner for an organization; existing labels are not removed, and duplicates are not added."
      },
      {
        "slug": "GITHUB_ADD_OR_UPDATE_TEAM_MEMBERSHIP_FOR_USER",
        "name": "Add or update team membership for a user",
        "description": "Adds a GitHub user to a team or updates their role (member or maintainer), inviting them to the organization if not already a member; idempotent, returning current details if no change is made."
      },
      {
        "slug": "GITHUB_ADD_OR_UPDATE_TEAM_PROJECT_PERMISSIONS",
        "name": "Add or update team project permissions",
        "description": "Adds a classic project to a team or updates the team's permission on it. This endpoint grants or updates permissions for a team on a specific classic project (not Projects V2). The authenticated user must have admin permissions for the project. Both the team and project must belong to the same organization. Requirements: - The project must be a classic project (not GitHub Projects V2) - The authenticated user must have admin permissions on the project - The team and project must be in the same organization - Requires 'admin:org' scope for the authentication token Returns HTTP 204 No Content on success, 403 if project is not an org project, or 404 if the organization, team, or project is not found."
      },
      {
        "slug": "GITHUB_ADD_OR_UPDATE_TEAM_REPOSITORY_PERMISSIONS",
        "name": "Add or update team repository permissions",
        "description": "Sets or updates a team's permission level for a repository within an organization; the team must be a member of the organization."
      },
      {
        "slug": "GITHUB_ADD_PROJECT_COLLABORATOR",
        "name": "Add project collaborator",
        "description": "Adds a specified GitHub user as a collaborator to an existing organization project with a given permission level. Note: This endpoint is for organization projects (classic). You must be an organization owner or a project admin to add a collaborator. Classic projects are being deprecated in favor of the new Projects experience."
      },
      {
        "slug": "GITHUB_ADD_REPOSITORY_TO_APP_INSTALLATION",
        "name": "Add a repository to an app installation",
        "description": "Adds a repository to a GitHub App installation, granting the app access; requires authenticated user to have admin rights for the repository and access to the installation."
      },
      {
        "slug": "GITHUB_ADD_REPO_TO_ORG_SECRET_WITH_SELECTED_ACCESS",
        "name": "Add repo to org secret with selected access",
        "description": "Adds a repository to an existing organization-level GitHub Actions secret that is configured for 'selected' repository access."
      },
      {
        "slug": "GITHUB_ADD_REPO_TO_ORG_SECRET_WITH_SELECTED_VISIBILITY",
        "name": "Add selected repo to org secret",
        "description": "Grants an existing repository access to an existing organization-level Dependabot secret when the secret's visibility is set to 'selected'; the repository must belong to the organization, and the call succeeds without change if access already exists."
      },
      {
        "slug": "GITHUB_ADD_RUNNER_LABELS",
        "name": "Add runner labels",
        "description": "Adds and appends custom labels to a self-hosted repository runner, which must be registered and active."
      },
      {
        "slug": "GITHUB_ADD_SELECTED_REPOSITORY_TO_ORGANIZATION_SECRET",
        "name": "Add selected repository to an organization secret",
        "description": "Adds a repository to an organization secret's access list when the secret's visibility is 'selected'; this operation is idempotent."
      },
      {
        "slug": "GITHUB_ADD_SELECTED_REPOSITORY_TO_ORGANIZATION_VARIABLE",
        "name": "Add selected repository to an organization variable",
        "description": "Grants a repository access to an organization-level GitHub Actions variable, if that variable's visibility is set to 'selected_repositories'."
      },
      {
        "slug": "GITHUB_ADD_SELECTED_REPOSITORY_TO_USER_SECRET",
        "name": "Add a selected repository to a user secret",
        "description": "Grants a specified repository access to an authenticated user's existing Codespaces secret, enabling Codespaces created for that repository to use the secret."
      },
      {
        "slug": "GITHUB_ADD_SOCIAL_ACCOUNTS_FOR_AUTHENTICATED_USER",
        "name": "Add social accounts for the authenticated user",
        "description": "Adds one or more social media links (which must be valid, full URLs for platforms supported by GitHub) to the authenticated user's public GitHub profile."
      },
      {
        "slug": "GITHUB_ADD_STATUS_CHECK_CONTEXTS",
        "name": "Add status check contexts",
        "description": "Adds status check contexts to a protected branch's required status checks. This action appends new status check contexts to the existing list of required status checks for a protected branch. The branch must already have branch protection enabled with status checks configured. Note: The 'contexts' parameter is deprecated by GitHub in favor of 'checks' array. For new implementations, consider using update_status_check_protection with the 'checks' parameter instead."
      },
      {
        "slug": "GITHUB_ADD_SUB_ISSUE",
        "name": "Add sub-issue to an issue",
        "description": "Tool to add a sub-issue to a parent GitHub issue using GraphQL. Use when you need to establish a parent-child relationship between issues. Requires the 'sub_issues' GraphQL feature to be enabled."
      },
      {
        "slug": "GITHUB_ADD_TEAM_ACCESS_RESTRICTIONS",
        "name": "Add team access restrictions",
        "description": "Adds teams to the list of teams with push access to a protected branch. This action grants additional teams push access to a protected branch. Unlike 'Set team access restrictions' (PUT), this action adds to the existing list rather than replacing it entirely. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository access"
      },
      {
        "slug": "GITHUB_ADD_USER_ACCESS_RESTRICTIONS",
        "name": "Add user access restrictions",
        "description": "Adds users to the list of people allowed to push to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 items"
      },
      {
        "slug": "GITHUB_ADD_USERS_TO_CODESPACES_ACCESS_FOR_ORGANIZATION",
        "name": "Add users to codespaces access for an organization",
        "description": "Adds organization members to the list of users granted Codespaces access billed to the organization. IMPORTANT: This endpoint requires the organization's Codespaces billing access to be set to 'selected_members' mode. If not already configured, use the GITHUB_MANAGE_ACCESS_CONTROL_FOR_ORGANIZATION_CODESPACES action first to set visibility to 'selected_members'."
      },
      {
        "slug": "GITHUB_API_ROOT",
        "name": "Get GitHub API root",
        "description": "Retrieves a map of all top-level GitHub REST API resource URLs and their templates."
      },
      {
        "slug": "GITHUB_APPROVE_WORKFLOW_RUN_FOR_FORK_PULL_REQUEST",
        "name": "Approve a workflow run for a fork pull request",
        "description": "Approves a workflow run from a forked repository's pull request; call this when such a run requires manual approval due to workflow configuration."
      },
      {
        "slug": "GITHUB_ASSIGN_ORGANIZATION_ROLE_TO_TEAM",
        "name": "Assign an organization role to a team",
        "description": "Assigns an existing organization-level role (identified by `role_id`) to a team (identified by `team_slug`) within a GitHub organization (`org`), provided the organization, team, and role already exist."
      },
      {
        "slug": "GITHUB_ASSIGN_ORGANIZATION_ROLE_TO_USER",
        "name": "Assign an organization role to a user",
        "description": "Assigns a specific organization role to a user who is a member or an outside collaborator in a GitHub organization, using a valid role ID."
      },
      {
        "slug": "GITHUB_AUTH_USER_DOCKER_CONFLICT_PACKAGES_LIST",
        "name": "List Docker Migration Conflicting Packages",
        "description": "List Docker packages with migration conflicts for the authenticated user. This endpoint lists all Docker packages owned by the authenticated user that encountered namespace conflicts during the Docker-to-GitHub Container Registry (GHCR) migration. Conflicts occur when a package with the same name exists in both the legacy Docker registry and GHCR. IMPORTANT: The Docker registry for GitHub Packages was deprecated on Feb 24, 2025. This endpoint may return a 400 error with message 'Package migration for docker is no longer supported' as the migration period has ended. In this case, the action returns an informative response instead of failing. Use case: Identifying packages that require manual migration to GHCR. Required scope: read:packages (for OAuth and personal access tokens)."
      },
      {
        "slug": "GITHUB_BLOCK_USER",
        "name": "Block a user",
        "description": "Blocks an existing individual GitHub user (not an organization or your own account), preventing them from interacting with your account and repositories."
      },
      {
        "slug": "GITHUB_BLOCK_USER_FROM_ORGANIZATION",
        "name": "Block a user from an organization",
        "description": "Blocks a GitHub user from an organization, preventing their contributions, collaboration, and forking of the organization's repositories. Requires admin or 'Blocking users' organization permission (write access)."
      },
      {
        "slug": "GITHUB_CANCEL_GITHUB_PAGES_DEPLOYMENT",
        "name": "Cancel a GitHub Pages deployment",
        "description": "Cancels an existing, ongoing or queued GitHub Pages deployment for a repository using its `pages_deployment_id`."
      },
      {
        "slug": "GITHUB_CANCEL_SPONSORSHIP",
        "name": "Cancel sponsorship",
        "description": "Tool to cancel an active GitHub sponsorship using GraphQL. Use when you need to terminate a sponsorship relationship between a sponsor and a sponsorable entity. Either sponsor ID/login and sponsorable ID/login must be provided."
      },
      {
        "slug": "GITHUB_CANCEL_WORKFLOW_RUN",
        "name": "Cancel a workflow run",
        "description": "Cancels a workflow run in a GitHub repository if it is in a cancellable state (e.g., 'in_progress' or 'queued'). Returns 202 Accepted on success."
      },
      {
        "slug": "GITHUB_CHECK_FOLLOWING",
        "name": "Check if following user",
        "description": "Check if the authenticated user is following a specified person on GitHub. Use this action when you need to verify whether the currently authenticated user follows another GitHub user. The action returns a boolean status and descriptive message."
      },
      {
        "slug": "GITHUB_CHECK_IF_GIST_IS_STARRED",
        "name": "Check if a gist is starred",
        "description": "Checks if a gist is starred by the authenticated user. Returns `is_starred: true` if the gist is starred (HTTP 204), or `is_starred: false` if not starred (HTTP 404). Use this to verify star status before starring/unstarring a gist."
      },
      {
        "slug": "GITHUB_CHECK_IF_PULL_REQUEST_HAS_BEEN_MERGED",
        "name": "Check if pull request merged",
        "description": "Checks if a specified GitHub pull request has been merged, indicated by a 204 HTTP status (merged) or 404 (not merged/found)."
      },
      {
        "slug": "GITHUB_CHECK_IF_PULL_REQUEST_MERGED",
        "name": "Check if pull request merged",
        "description": "Checks if a pull request has been merged by querying the GitHub API. Use this action when you need to verify whether a specific pull request has been successfully merged into its target branch. The API returns a 204 status for merged PRs and 404 for unmerged PRs."
      },
      {
        "slug": "GITHUB_CHECK_IF_REPO_STARRED_BY_AUTH_USER",
        "name": "Check if repo starred by auth user",
        "description": "DEPRECATED: Use `GITHUB_CHECK_IF_A_REPOSITORY_IS_STARRED_BY_THE_USER` instead."
      },
      {
        "slug": "GITHUB_CHECK_IF_USER_CAN_BE_ASSIGNED",
        "name": "Check if a user can be assigned",
        "description": "Verifies if a GitHub user can be assigned to issues in a repository; assignability is confirmed by an HTTP 204 (No Content) response, resulting in an empty 'data' field in the response."
      },
      {
        "slug": "GITHUB_CHECK_IF_USER_CAN_BE_ASSIGNED_TO_ISSUE",
        "name": "Check if a user can be assigned to an issue",
        "description": "Checks if a specified GitHub user can be assigned to a given issue within a repository."
      },
      {
        "slug": "GITHUB_CHECK_IF_USER_FOLLOWS_ANOTHER_USER",
        "name": "Check if a user follows another user",
        "description": "Checks if a GitHub user `username` follows `target_user`; returns a 204 HTTP status if true, 404 if not or if users are invalid."
      },
      {
        "slug": "GITHUB_CHECK_IF_USER_IS_BLOCKED_BY_AUTHENTICATED_USER",
        "name": "Check if a user is blocked by the authenticated user",
        "description": "Checks if the specified GitHub user is blocked by the authenticated user; a 204 No Content response indicates the user is blocked, while a 404 Not Found indicates they are not."
      },
      {
        "slug": "GITHUB_CHECK_IF_USER_IS_BLOCKED_BY_ORGANIZATION",
        "name": "Check if a user is blocked by an organization",
        "description": "Checks if a GitHub user is blocked by an organization. Returns is_blocked=True if the user is blocked (HTTP 204), or is_blocked=False if not blocked (HTTP 404). Requires 'Blocking users' organization permission (read access)."
      },
      {
        "slug": "GITHUB_CHECK_IF_USER_IS_REPOSITORY_COLLABORATOR",
        "name": "Check if a user is a repository collaborator",
        "description": "Checks if a user is a collaborator on a specified GitHub repository, returning a 204 status if they are, or a 404 status if they are not or if the repository/user does not exist."
      },
      {
        "slug": "GITHUB_CHECK_PERSON_FOLLOWED_BY_AUTH_USER",
        "name": "Check if person is followed by authenticated user",
        "description": "Checks if the authenticated GitHub user follows a target GitHub user. Returns a structured response with is_following=True when following (HTTP 204), or is_following=False when not following (HTTP 404)."
      },
      {
        "slug": "GITHUB_CHECK_PRIVATE_VULNERABILITY_REPORTING_STATUS",
        "name": "Check private vulnerability reporting status",
        "description": "Checks if private vulnerability reporting is enabled for the specified repository."
      },
      {
        "slug": "GITHUB_CHECK_PUBLIC_ORGANIZATION_MEMBERSHIP_FOR_USER",
        "name": "Check public organization membership",
        "description": "Tool to check if a user is a public member of an organization. Use when you need to verify public organization membership status."
      },
      {
        "slug": "GITHUB_CHECK_REPOSITORY_STARRED",
        "name": "Check if repository is starred",
        "description": "Check if a repository is starred by the authenticated user. Use this action when you need to verify whether the authenticated user has starred a specific repository. This is useful for confirming star status before performing star/unstar operations or displaying repository status."
      },
      {
        "slug": "GITHUB_CHECK_TEAM_PERMISSIONS_FOR_A_PROJECT",
        "name": "Check team permissions for a project",
        "description": "Checks if a team has 'read', 'write', or 'admin' permissions for an organization's specific classic project, returning the project's details if access is confirmed."
      },
      {
        "slug": "GITHUB_CHECK_TEAM_PERMISSIONS_FOR_A_REPOSITORY",
        "name": "Check team permissions for a repository",
        "description": "Checks a team's permissions for a specific repository within an organization, including permissions inherited from parent teams."
      },
      {
        "slug": "GITHUB_CHECK_TOKEN",
        "name": "Check a token",
        "description": "Checks if a GitHub App or OAuth access_token is valid for the specified client_id and retrieves its details, typically to verify its active status and grants. NOTE: This endpoint requires Basic Authentication using the OAuth App's client_id as username and client_secret as password. The access_token parameter must be an OAuth token issued by the specified OAuth App."
      },
      {
        "slug": "GITHUB_CLEAR_PROJECT_V2_ITEM_FIELD_VALUE",
        "name": "Clear Project V2 Item Field Value",
        "description": "Tool to clear the value of a field for an item in a GitHub Project V2. Use when you need to remove or reset a field value (text, number, date, assignees, labels, single-select, iteration, or milestone fields)."
      },
      {
        "slug": "GITHUB_CLEAR_REPOSITORY_CACHE_BY_KEY",
        "name": "Clear repository cache by key",
        "description": "Deletes GitHub Actions caches from a repository matching a specific `key` and an optional Git `ref`, used to manage storage or clear outdated/corrupted caches; the action succeeds even if no matching caches are found to delete."
      },
      {
        "slug": "GITHUB_CLEAR_SELF_HOSTED_RUNNER_ORG_LABELS",
        "name": "Clear self-hosted runner org labels",
        "description": "Removes all custom labels from a self-hosted runner for an organization; default labels (e.g., 'self-hosted', 'linux', 'x64') will remain."
      },
      {
        "slug": "GITHUB_CLOSE_ISSUE",
        "name": "Close an issue",
        "description": "Close a GitHub issue by setting its state to closed. Use this action when you need to mark an issue as resolved or no longer relevant. Optionally specify a reason for closing (completed or not_planned) to provide context."
      },
      {
        "slug": "GITHUB_CLOSE_PULL_REQUEST",
        "name": "Close a pull request",
        "description": "Closes an open pull request without merging it. The pull request state is set to \"closed\" and it can be reopened later if needed. Use this action when you want to reject or abandon a pull request without merging the proposed changes into the base branch. You must have write access to the repository to close pull requests."
      },
      {
        "slug": "GITHUB_COMMIT_MULTIPLE_FILES",
        "name": "Commit Multiple Files",
        "description": "Tool to atomically create, update, or delete multiple files in a GitHub repository as a single commit. Uses Git Data APIs to avoid SHA mismatch conflicts that occur with the Contents API when multiple files are modified in parallel. Use when you need to make multi-file changes reliably. BRANCH CREATION: When committing to a new branch (e.g., 'fix/my-fix' or 'feature/new-feature'), you MUST provide 'base_branch' (typically 'main' or 'master') to create the branch from. If the branch already exists, base_branch is not needed. This action handles race conditions automatically: if the branch is updated by another commit between fetching the HEAD and updating the reference (resulting in a 422 'not a fast forward' error), the action will retry by refetching the HEAD and rebasing changes. Use max_retries to control this behavior."
      },
      {
        "slug": "GITHUB_COMPARE_TWO_COMMITS",
        "name": "Compare two commits",
        "description": "Compares two commit points (commits, branches, tags, or SHAs) within a repository or across forks, using `BASE...HEAD` or `OWNER:REF...OWNER:REF` format for the `basehead` parameter."
      },
      {
        "slug": "GITHUB_CONFIGURE_JIT_RUNNER_FOR_ORG",
        "name": "Configure JIT runner for an org",
        "description": "Generates a JIT configuration for a GitHub organization's new self-hosted runner to run a single job then unregister; requires admin:org scope and the runner_group_id must exist in the organization."
      },
      {
        "slug": "GITHUB_CONFIGURE_OIDC_SUBJECT_CLAIM_TEMPLATE",
        "name": "Configure OIDC subject claim template",
        "description": "Sets or updates the OIDC subject claim customization template for an existing GitHub organization by specifying which claims (e.g., 'repo', 'actor') form the OIDC token's subject (`sub`). This action customizes which claim keys are included in the OIDC subject claim for the specified organization. It allows for fine-tuning the content of the subject claim based on organizational needs."
      },
      {
        "slug": "GITHUB_CONVERT_ORG_MEMBER_TO_OUTSIDE_COLLABORATOR",
        "name": "Convert an organization member to outside collaborator",
        "description": "Converts an existing organization member, who is not an owner, to an outside collaborator, restricting their access to explicitly granted repositories."
      },
      {
        "slug": "GITHUB_CONVERT_PULL_REQUEST_TO_DRAFT",
        "name": "Convert Pull Request to Draft",
        "description": "Converts an open pull request to draft status, indicating it is not ready for review. Use this action when you need to mark a PR as work-in-progress after it has been opened. Draft pull requests cannot be merged until they are marked as ready for review. This action is useful when additional work is needed before the PR can be reviewed or merged."
      },
      {
        "slug": "GITHUB_CREATE_A_BLOB",
        "name": "Create a blob",
        "description": "Creates a Git blob in a repository, requiring content and encoding ('utf-8' or 'base64'). Requires write access to the repository."
      },
      {
        "slug": "GITHUB_CREATE_A_CHECK_RUN",
        "name": "Create a check run",
        "description": "Creates a new check run for a specific commit in a repository, used by external services to report status, detailed feedback, annotations, and images directly within the GitHub UI. NOTE: This endpoint requires GitHub App authentication - OAuth tokens and personal access tokens cannot create check runs."
      },
      {
        "slug": "GITHUB_CREATE_A_CHECK_SUITE",
        "name": "Create a check suite",
        "description": "Creates a new check suite for a specific commit (`head_sha`) in an original repository (not a fork). IMPORTANT: This endpoint requires a GitHub App installation access token - OAuth tokens and classic personal access tokens cannot use this endpoint. GitHub dispatches a `check_suite` webhook event with the `requested` action upon success."
      },
      {
        "slug": "GITHUB_CREATE_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
        "name": "Create a codespace for the authenticated user",
        "description": "Creates a GitHub Codespace for the authenticated user, requiring a JSON request body with either `repository_id` (integer) or a `pull_request` object (containing `pull_request_number` (integer) and `repository_id` (integer)). This action allows users to set up a development environment quickly by creating a codespace from a specified repository or pull request."
      },
      {
        "slug": "GITHUB_CREATE_A_CODESPACE_FROM_A_PULL_REQUEST",
        "name": "Create a codespace from a pull request",
        "description": "Creates a GitHub Codespace for an open pull request in a Codespaces-enabled repository, with options to customize its configuration."
      },
      {
        "slug": "GITHUB_CREATE_A_CODESPACE_IN_A_REPOSITORY",
        "name": "Create a codespace in a repository",
        "description": "Creates a GitHub Codespace for the authenticated user in a specified repository, which must be accessible and use a valid `devcontainer.json` if `devcontainer_path` is specified."
      },
      {
        "slug": "GITHUB_CREATE_A_COMMIT",
        "name": "Create a commit",
        "description": "Creates a new commit in a GitHub repository; the `tree` SHA and any `parents` SHAs must already exist in the repository."
      },
      {
        "slug": "GITHUB_CREATE_A_COMMIT_COMMENT",
        "name": "Create a commit comment",
        "description": "Creates a comment on a specific commit, or on a specific line if `path` and `position` are provided."
      },
      {
        "slug": "GITHUB_CREATE_A_COMMIT_STATUS",
        "name": "Create a commit status",
        "description": "Sets a commit's status (e.g., error, failure, pending, success from CI/CD) for a given SHA; max 1000 statuses per SHA/context."
      },
      {
        "slug": "GITHUB_CREATE_A_CUSTOM_ORGANIZATION_ROLE",
        "name": "Create a custom organization role",
        "description": "Creates a custom role with defined permissions within a GitHub organization."
      },
      {
        "slug": "GITHUB_CREATE_A_DEPLOY_KEY",
        "name": "Create a deploy key",
        "description": "Creates a deploy key for a repository; the repository must exist and be accessible, and the provided key must be a valid public SSH key."
      },
      {
        "slug": "GITHUB_CREATE_A_DEPLOYMENT",
        "name": "Create a deployment",
        "description": "Creates a GitHub deployment for an existing repository, targeting a specific ref (branch, tag, or SHA) that must also exist within the repository."
      },
      {
        "slug": "GITHUB_CREATE_A_DEPLOYMENT_BRANCH_POLICY",
        "name": "Create a deployment branch policy",
        "description": "Creates a deployment branch or tag policy for an existing environment in a GitHub repository, using a Ruby File.fnmatch pattern (where `*` doesn't match `/`) to specify which branches or tags are deployable."
      },
      {
        "slug": "GITHUB_CREATE_A_DEPLOYMENT_STATUS",
        "name": "Create a deployment status",
        "description": "Creates a status for an existing deployment, updating its operational state, associated URLs, and description."
      },
      {
        "slug": "GITHUB_CREATE_A_DISCUSSION",
        "name": "Create a discussion",
        "description": "Creates a new discussion post on a specific team's page within an organization."
      },
      {
        "slug": "GITHUB_CREATE_A_DISCUSSION_COMMENT",
        "name": "Create a discussion comment",
        "description": "Creates a new comment on an existing team discussion within a GitHub organization."
      },
      {
        "slug": "GITHUB_CREATE_A_FORK",
        "name": "Create a fork",
        "description": "Creates a fork of an accessible repository, optionally into a specific organization, with a new name, or copying only the default branch."
      },
      {
        "slug": "GITHUB_CREATE_A_GIST",
        "name": "Create a gist",
        "description": "Creates a new gist on GitHub with provided files, an optional description, and public/secret visibility."
      },
      {
        "slug": "GITHUB_CREATE_A_GIST_COMMENT",
        "name": "Create a gist comment",
        "description": "Creates a new comment on a specified GitHub gist."
      },
      {
        "slug": "GITHUB_CREATE_A_GITHUB_APP_FROM_A_MANIFEST",
        "name": "Create a GitHub App from a manifest",
        "description": "Use this action to complete the GitHub App Manifest flow (step 3 of 3) by exchanging the temporary authorization `code` for the app's full configuration, including credentials and private key. The code is provided via redirect URL after creating the app through GitHub's web interface and must be used within 1 hour."
      },
      {
        "slug": "GITHUB_CREATE_A_GITHUB_PAGES_DEPLOYMENT",
        "name": "Create a github pages deployment",
        "description": "Creates a GitHub Pages deployment for a repository using a specified artifact and OIDC token, provided GitHub Pages is enabled and the artifact (containing static assets) is accessible."
      },
      {
        "slug": "GITHUB_CREATE_A_GITHUB_PAGES_SITE",
        "name": "Create a github pages site",
        "description": "Configures or updates GitHub Pages for a repository, setting build type and source; ensure a Pages workflow exists for 'workflow' `build_type`, or `source_branch` exists for 'legacy' or unspecified `build_type`. This action allows users to effectively manage their GitHub Pages site settings, specifying how the site is built and where the source files are located."
      },
      {
        "slug": "GITHUB_CREATE_A_LABEL",
        "name": "Create a label",
        "description": "Creates a new label in a specified GitHub repository, provided the repository exists and the user has write permissions."
      },
      {
        "slug": "GITHUB_CREATE_A_MILESTONE",
        "name": "Create a milestone",
        "description": "Creates a milestone in a GitHub repository for tracking progress on issues or pull requests; requires repository existence and user write permissions."
      },
      {
        "slug": "GITHUB_CREATE_AN_AUTOLINK_REFERENCE_FOR_A_REPOSITORY",
        "name": "Create an autolink reference for a repository",
        "description": "Creates a repository autolink to automatically convert text references (e.g., 'TICKET-123') into hyperlinks, using a unique `key_prefix` and a `url_template` that includes `<num>`."
      },
      {
        "slug": "GITHUB_CREATE_AN_ENVIRONMENT_VARIABLE",
        "name": "Create an environment variable",
        "description": "Creates an encrypted environment variable for a pre-existing environment within a GitHub repository; will fail if the variable name already exists."
      },
      {
        "slug": "GITHUB_CREATE_AN_ISSUE",
        "name": "Create an issue",
        "description": "Creates a new issue in a GitHub repository, requiring the repository to exist and have issues enabled; specific fields like assignees, milestone, or labels may require push access."
      },
      {
        "slug": "GITHUB_CREATE_AN_ISSUE_COMMENT",
        "name": "Create an issue comment",
        "description": "Creates a new comment on an existing GitHub issue or pull request within the specified repository."
      },
      {
        "slug": "GITHUB_CREATE_AN_ORGANIZATION_PROJECT",
        "name": "Create an organization project",
        "description": "Creates a new classic project board within a specified GitHub organization. Note: This action uses GitHub's Projects (classic) REST API. The classic projects feature may be disabled in some organizations, and GitHub recommends migrating to Projects V2 (accessible via GraphQL API) for new projects. Requirements: - The authenticated user must be an organization member with project creation permissions - Classic projects must be enabled for the organization - Requires 'repo' and 'admin:org' or 'write:org' scopes"
      },
      {
        "slug": "GITHUB_CREATE_AN_ORGANIZATION_REPOSITORY",
        "name": "Create an organization repository",
        "description": "Creates a new repository within a specified GitHub organization, with options for detailed configuration including visibility, features, merge strategies, initial commit, and templates."
      },
      {
        "slug": "GITHUB_CREATE_AN_ORGANIZATION_VARIABLE",
        "name": "Create an organization variable",
        "description": "Creates a new, uniquely named GitHub Actions variable for an organization, with configurable repository access visibility (all, private, or selected)."
      },
      {
        "slug": "GITHUB_CREATE_AN_ORGANIZATION_WEBHOOK",
        "name": "Create an organization webhook",
        "description": "Creates a webhook for a GitHub organization to deliver event notifications to a configured URL."
      },
      {
        "slug": "GITHUB_CREATE_A_PROJECT_CARD",
        "name": "Create a project card",
        "description": "Creates a project card in a GitHub project column (classic projects only). DEPRECATION NOTICE: GitHub Projects (classic) was sunset on August 23, 2024. This API only works with existing classic project columns. New classic projects cannot be created. Consider using GitHub Projects V2 (GraphQL API) instead. The request body must contain either: - `note`: A text note for the card - OR `content_id` AND `content_type`: To associate an issue or pull request"
      },
      {
        "slug": "GITHUB_CREATE_A_PROJECT_COLUMN",
        "name": "Create a project column (Classic - Deprecated)",
        "description": "Creates a new column in a GitHub project (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/"
      },
      {
        "slug": "GITHUB_CREATE_A_PULL_REQUEST",
        "name": "Create a pull request",
        "description": "Creates a pull request in a GitHub repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided."
      },
      {
        "slug": "GITHUB_CREATE_A_REFERENCE",
        "name": "Create a reference",
        "description": "Creates a NEW Git reference (branch or tag) in a repository. IMPORTANT: This action ONLY creates NEW references - if the reference already exists, it will fail with a 422 'Reference already exists' error. To update an existing reference, use the 'Update a reference' (GITHUB_UPDATE_A_REFERENCE) action instead. The repository must not be empty prior to this operation."
      },
      {
        "slug": "GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_AN_ORGANIZATION",
        "name": "Create a registration token for an organization",
        "description": "Generates a temporary (one-hour) registration token to add a new self-hosted runner to an organization for GitHub Actions."
      },
      {
        "slug": "GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_A_REPOSITORY",
        "name": "Create a registration token for a repository",
        "description": "Generates a time-limited token required to register a new self-hosted runner with a specific repository."
      },
      {
        "slug": "GITHUB_CREATE_A_RELEASE",
        "name": "Create a release",
        "description": "Creates a release in a GitHub repository for a specified tag; the tag must be unique for published releases, and if a `discussion_category_name` is given, it must already exist."
      },
      {
        "slug": "GITHUB_CREATE_A_REMOVE_TOKEN_FOR_AN_ORGANIZATION",
        "name": "Create a remove token for an organization",
        "description": "Generates a token, valid for one hour, to authenticate removing a self-hosted runner from an organization."
      },
      {
        "slug": "GITHUB_CREATE_A_REMOVE_TOKEN_FOR_A_REPOSITORY",
        "name": "Create a remove token for a repository",
        "description": "Generates a temporary (one-hour validity) token required to unregister and remove a self-hosted runner from a repository."
      },
      {
        "slug": "GITHUB_CREATE_A_REPLY_FOR_A_REVIEW_COMMENT",
        "name": "Create a reply for a review comment",
        "description": "Posts a reply to a specific review comment on a GitHub pull request, requiring the repository, pull request, and original comment to exist, and a non-empty reply body."
      },
      {
        "slug": "GITHUB_CREATE_A_REPOSITORY_DISPATCH_EVENT",
        "name": "Create a repository dispatch event",
        "description": "Triggers a GitHub Actions workflow or a webhook on a repository by creating a repository dispatch event, allowing programmatic triggering of workflows based on events outside of GitHub."
      },
      {
        "slug": "GITHUB_CREATE_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER",
        "name": "Create a repository for the authenticated user",
        "description": "Creates a new repository for the authenticated user, optionally within an organization if `team_id` is specified."
      },
      {
        "slug": "GITHUB_CREATE_A_REPOSITORY_FROM_AN_UNPUBLISHED_CODESPACE",
        "name": "Create a repository from an unpublished codespace",
        "description": "Publishes the specified codespace to a new repository, using the codespace's current state as the initial commit."
      },
      {
        "slug": "GITHUB_CREATE_A_REPOSITORY_PROJECT",
        "name": "Create a repository project",
        "description": "Creates a new GitHub Projects V2 project board linked to a specified repository. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub. The project is owned by the repository owner (user or organization) and linked to the specified repository."
      },
      {
        "slug": "GITHUB_CREATE_A_REPOSITORY_RULESET",
        "name": "Create a repository ruleset",
        "description": "Creates a uniquely named ruleset for a repository, defining rules for branches or tags with specified enforcement, conditions, and bypass actors."
      },
      {
        "slug": "GITHUB_CREATE_A_REPOSITORY_USING_A_TEMPLATE",
        "name": "Create a repository using a template",
        "description": "Creates a new repository from an existing template repository; the authenticated user must have access to the template and, if creating in an organization, repository creation permissions within it."
      },
      {
        "slug": "GITHUB_CREATE_A_REPOSITORY_VARIABLE",
        "name": "Create a repository variable",
        "description": "Creates a new, unencrypted variable in a repository for GitHub Actions workflows; fails if a variable with the same name already exists."
      },
      {
        "slug": "GITHUB_CREATE_A_REPOSITORY_WEBHOOK",
        "name": "Create a repository webhook",
        "description": "Creates a webhook for a specified repository; requires admin permissions on the repository."
      },
      {
        "slug": "GITHUB_CREATE_A_REVIEW_COMMENT_FOR_A_PULL_REQUEST",
        "name": "Create a review comment for a pull request",
        "description": "Creates a review comment on a pull request's diff, targeting a specific line, range of lines, an entire file, or replying to an existing comment."
      },
      {
        "slug": "GITHUB_CREATE_A_REVIEW_FOR_A_PULL_REQUEST",
        "name": "Create a review for a pull request",
        "description": "Creates a pull request review, allowing approval, change requests, or comments; `body` is required if `event` is `REQUEST_CHANGES` or `COMMENT`, and omitting `event` makes the review `PENDING`."
      },
      {
        "slug": "GITHUB_CREATE_A_SCOPED_ACCESS_TOKEN",
        "name": "Create a scoped access token",
        "description": "Exchanges a user-to-server token for a new, fine-grained scoped access token for a GitHub App, requiring `client_id`, `access_token`, either `target` or `target_id`, and at least one permission; for repository-specific scoping, provide either `repositories` (names) or `repository_ids` (IDs), but not both."
      },
      {
        "slug": "GITHUB_CREATE_A_SNAPSHOT_OF_DEPENDENCIES_FOR_A_REPOSITORY",
        "name": "Create a dependency snapshot",
        "description": "Creates a snapshot of a repository's dependencies to populate the GitHub dependency graph and enable security alerts; `sha` must be a 40-character commit ID, `ref` a fully qualified Git reference (e.g., `refs/heads/main`), and `scanned` an ISO 8601 timestamp."
      },
      {
        "slug": "GITHUB_CREATE_A_TAG_OBJECT",
        "name": "Create a tag object",
        "description": "Creates an annotated Git tag object in a repository, pointing to an existing Git object (commit, tree, or blob) defined by its SHA and ensuring the `type` field correctly specifies the object's type."
      },
      {
        "slug": "GITHUB_CREATE_A_TAG_PROTECTION_STATE_FOR_A_REPOSITORY",
        "name": "Create a tag protection state for a repository",
        "description": "DEPRECATED: This API was sunset on August 30, 2024. Use GITHUB_CREATE_A_REPOSITORY_RULESET instead to create tag protection rules via repository rulesets."
      },
      {
        "slug": "GITHUB_CREATE_A_TEAM",
        "name": "Create a team",
        "description": "Creates a new team in an organization, optionally with maintainers, repositories, specific privacy, notification settings, or a parent team; if `parent_team_id` is given, `privacy` must be 'closed'."
      },
      {
        "slug": "GITHUB_CREATE_A_TEMPORARY_PRIVATE_FORK",
        "name": "Create a temporary private fork",
        "description": "Creates a temporary private fork of the specified repository to address a security vulnerability, linking the fork to a GHSA ID that must be specifically associated with this repository; the fork may take up to 5 minutes to become accessible."
      },
      {
        "slug": "GITHUB_CREATE_A_TREE",
        "name": "Create a tree",
        "description": "Creates a new Git tree object in a repository, defining file/directory structure by specifying tree entries, optionally building on a `base_tree` SHA; all provided SHAs must be valid."
      },
      {
        "slug": "GITHUB_CREATE_A_USER_PROJECT",
        "name": "Create a user project",
        "description": "Creates a new GitHub Projects V2 project board for the authenticated user to organize and track issues, pull requests, and notes. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub."
      },
      {
        "slug": "GITHUB_CREATE_A_WORKFLOW_DISPATCH_EVENT",
        "name": "Create a workflow dispatch event",
        "description": "Manually triggers a GitHub Actions workflow identified by `workflow_id` at a given `ref`, if the workflow is configured to accept `workflow_dispatch` events."
      },
      {
        "slug": "GITHUB_CREATE_BRANCH",
        "name": "Create a branch",
        "description": "Creates a new branch in a GitHub repository pointing to a specified commit. Use this action when you need to create a new branch from an existing commit SHA. IMPORTANT: This action only creates NEW branches. If the branch already exists, it will fail with a 422 'Reference already exists' error. The repository must not be empty (must have at least one commit) before creating a branch."
      },
      {
        "slug": "GITHUB_CREATE_COMMIT_SIGNATURE_PROTECTION",
        "name": "Create commit signature protection",
        "description": "Enables commit signature protection for a specified branch, requiring all new commits to be signed."
      },
      {
        "slug": "GITHUB_CREATE_DEPLOYMENT_PROTECTION_RULE",
        "name": "Create a custom deployment protection rule on an environment",
        "description": "Enables a custom deployment protection rule for an existing environment in a repository by linking a configured GitHub App (via `integration_id`) to control deployments."
      },
      {
        "slug": "GITHUB_CREATE_DRAFT_ITEM_FOR_USER_PROJECT",
        "name": "Create draft item for user project",
        "description": "Creates a draft issue item in a user-owned GitHub ProjectsV2. Use when you need to add a new draft item to track ideas or tasks in a user's project."
      },
      {
        "slug": "GITHUB_CREATE_INFERENCE_CHAT_COMPLETIONS",
        "name": "Create inference chat completions",
        "description": "Tool to create chat completions using GitHub Models inference API. Use when you need to generate AI-powered text responses using models like GPT-4, Claude, or Llama through GitHub's inference endpoint."
      },
      {
        "slug": "GITHUB_CREATE_INFERENCE_EMBEDDINGS",
        "name": "Create inference embeddings",
        "description": "Tool to create inference embeddings using GitHub's AI models. Use when you need to convert text into vector representations for similarity search, clustering, or other ML tasks."
      },
      {
        "slug": "GITHUB_CREATE_ISSUE_TYPE",
        "name": "Create issue type",
        "description": "Create a new issue type for a GitHub organization. Requires the authenticated user to be an organization administrator. OAuth tokens need admin:org scope."
      },
      {
        "slug": "GITHUB_CREATE_JIT_RUNNER_CONFIG",
        "name": "Create JIT runner config for repo",
        "description": "Generates a temporary Just-In-Time (JIT) configuration for a new self-hosted GitHub Actions runner for a repository; any specified non-default `runner_group_id` must be an existing runner group accessible by the repository."
      },
      {
        "slug": "GITHUB_CREATE_OR_UPDATE_AN_ENVIRONMENT",
        "name": "Create or update an environment",
        "description": "Creates a new environment or updates an existing one in a GitHub repository, allowing configuration of deployment protection rules such as wait timers and reviewers; ensure `environment_name` is URL-encoded if it contains special characters."
      },
      {
        "slug": "GITHUB_CREATE_OR_UPDATE_AN_ENVIRONMENT_SECRET",
        "name": "Create or update an environment secret",
        "description": "Creates or updates an environment secret with an `encrypted_value` that was encrypted using the public key identified by `key_id` for the specified environment."
      },
      {
        "slug": "GITHUB_CREATE_OR_UPDATE_AN_ORGANIZATION_SECRET",
        "name": "Create or update an organization secret",
        "description": "Creates or updates an organization secret for GitHub Actions, requiring its value to be pre-encrypted via LibSodium using the organization's public key."
      },
      {
        "slug": "GITHUB_CREATE_OR_UPDATE_A_REPOSITORY_SECRET",
        "name": "Create or update a repository secret",
        "description": "Creates or updates a GitHub Actions secret within a specific repository; use `encrypted_value` and `key_id` to set or change its value."
      },
      {
        "slug": "GITHUB_CREATE_OR_UPDATE_A_SECRET_FOR_THE_AUTHENTICATED_USER",
        "name": "Create or update a secret for the authenticated user",
        "description": "Creates or updates a Codespaces secret for the authenticated user; `encrypted_value` must be encrypted with the public key (ID: `key_id`) from GitHub's 'Get public key for the authenticated user' endpoint."
      },
      {
        "slug": "GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORG",
        "name": "Create or update custom properties for an organization",
        "description": "Creates new custom property schemas or updates existing ones in bulk for a specified organization; each property definition must include `property_name` and `value_type`."
      },
      {
        "slug": "GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTY_ORG",
        "name": "Create or update a custom property for an organization",
        "description": "Creates a new custom property (name must be unique for creation) or updates an existing one for an organization to define metadata for its repositories."
      },
      {
        "slug": "GITHUB_CREATE_OR_UPDATE_FILE_CONTENTS",
        "name": "Create or update file contents",
        "description": "Creates a new file or updates an existing file in a GitHub repository; SHA can be provided to validate file updates, automatically fetched if not provided."
      },
      {
        "slug": "GITHUB_CREATE_OR_UPDATE_GITHUB_PAGES_SITE",
        "name": "Create or Update GitHub Pages Site",
        "description": "Tool to enable or update GitHub Pages configuration for a repository. Use when setting up GitHub Pages for static site deployment or modifying Pages settings like custom domains and HTTPS enforcement."
      },
      {
        "slug": "GITHUB_CREATE_OR_UPDATE_REPO_SECRET_WITH_ENCRYPTED_VALUE",
        "name": "Create or update repo secret with encrypted value",
        "description": "Creates or updates a Dependabot secret in a repository using an `encrypted_value` (pre-encrypted with LibSodium using the repository's Dependabot public key) and its corresponding `key_id`. This action allows you to securely manage secrets for a given repository, ensuring that sensitive data remains protected during the update process. By providing the encrypted value alongside the key ID, you can seamlessly maintain the necessary credentials for your repository's operations."
      },
      {
        "slug": "GITHUB_CREATE_REACTION_FOR_A_COMMIT_COMMENT",
        "name": "Create reaction for a commit comment",
        "description": "Creates an emoji reaction for a commit comment; if the user has already reacted with the same content, details of the existing reaction are returned."
      },
      {
        "slug": "GITHUB_CREATE_REACTION_FOR_AN_ISSUE",
        "name": "Create reaction for an issue",
        "description": "Creates a reaction for a specified issue within a GitHub repository."
      },
      {
        "slug": "GITHUB_CREATE_REACTION_FOR_AN_ISSUE_COMMENT",
        "name": "Create reaction for an issue comment",
        "description": "Creates a reaction for a specific comment on an issue within a GitHub repository."
      },
      {
        "slug": "GITHUB_CREATE_REACTION_FOR_A_PULL_REQUEST_REVIEW_COMMENT",
        "name": "Create reaction for a pull request review comment",
        "description": "Adds a specified reaction to a pull request review comment within a GitHub repository."
      },
      {
        "slug": "GITHUB_CREATE_REACTION_FOR_A_RELEASE",
        "name": "Create reaction for a release",
        "description": "Creates an emoji reaction for a specific, existing release in a GitHub repository."
      },
      {
        "slug": "GITHUB_CREATE_REACTION_FOR_A_TEAM_DISCUSSION",
        "name": "Create reaction for a team discussion",
        "description": "Creates a reaction for a team discussion within a GitHub organization."
      },
      {
        "slug": "GITHUB_CREATE_REACTION_FOR_A_TEAM_DISCUSSION_COMMENT",
        "name": "Create reaction for a team discussion comment",
        "description": "Adds a reaction to a team discussion comment, requiring the specified organization, team, discussion, and comment to exist."
      },
      {
        "slug": "GITHUB_CREATE_REPOSITORY",
        "name": "Create repository",
        "description": "Creates a new repository for the authenticated user. Use this action when you need to create a new GitHub repository under the authenticated user's account. The repository name must be unique for the user, and various settings can be configured such as visibility (public/private), enabled features (issues, wiki, projects), and merge options."
      },
      {
        "slug": "GITHUB_CREATE_SPONSORSHIP",
        "name": "Create sponsorship",
        "description": "Tool to start a new GitHub sponsorship or reactivate a past sponsorship using GraphQL. Use when you need to sponsor a maintainer through GitHub Sponsors with a specified amount and privacy level."
      },
      {
        "slug": "GITHUB_CREATE_SPONSORS_TIER",
        "name": "Create Sponsors Tier",
        "description": "Tool to create a new payment tier for your GitHub Sponsors profile using GraphQL. Use when you need to add a new sponsorship tier with a specific monthly price and description. The amount is specified in dollars and will be converted to cents automatically."
      },
      {
        "slug": "GITHUB_CREATE_UPDATE_ORG_SECRET_WITH_LIB_SODIUM",
        "name": "Create or Update Organization Secret with LibSodium",
        "description": "Creates or updates a Dependabot organization secret, requiring the secret value to be pre-encrypted with LibSodium using the organization's public key obtained from the 'Get an organization public key' endpoint."
      },
      {
        "slug": "GITHUB_CREATE_USER_LIST",
        "name": "Create user list",
        "description": "Tool to create a new user list on GitHub. Use when you need to organize and group GitHub users for easier tracking and management."
      },
      {
        "slug": "GITHUB_CREATE_VIEW_FOR_USER_PROJECT",
        "name": "Create view for user project",
        "description": "Tool to create a new view in a user-owned GitHub project (Projects V2). Use when you need to add a customized view with specific layout, filters, and visible fields to organize project items. Note: This action works with GitHub Projects V2. The view can be configured with different layouts (table, board, roadmap) and optional filters. The visible_fields parameter is not applicable to roadmap layouts."
      },
      {
        "slug": "GITHUB_DECLINE_A_REPOSITORY_INVITATION",
        "name": "Decline a repository invitation",
        "description": "Declines a specific, pending repository invitation for the authenticated user, identified by its `invitation_id`."
      },
      {
        "slug": "GITHUB_DELETE_ACCESS_RESTRICTIONS",
        "name": "Delete access restrictions",
        "description": "Removes all user, team, and app-based access restrictions from a protected branch."
      },
      {
        "slug": "GITHUB_DELETE_ADMIN_BRANCH_PROTECTION",
        "name": "Delete admin branch protection",
        "description": "Removes admin enforcement from a protected branch (branch name cannot contain wildcard characters) in a repository."
      },
      {
        "slug": "GITHUB_DELETE_A_FILE",
        "name": "Delete a file",
        "description": "Deletes a file by path from a GitHub repository. The file's blob SHA is automatically fetched if not provided."
      },
      {
        "slug": "GITHUB_DELETE_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USER",
        "name": "Delete a package version for the authenticated user",
        "description": "Deletes an existing package version associated with the authenticated user."
      },
      {
        "slug": "GITHUB_DELETE_APP_AUTHORIZATION",
        "name": "Delete an app authorization",
        "description": "Deletes an OAuth application grant for a user, which revokes ALL OAuth tokens and their associated authorizations for the application. This endpoint is only accessible to OAuth App owners and requires Basic Authentication using the OAuth App's client_id and client_secret."
      },
      {
        "slug": "GITHUB_DELETE_APP_TOKEN",
        "name": "Delete an app token",
        "description": "Revokes a single OAuth access token for an OAuth App or GitHub App with OAuth authorization. IMPORTANT: This endpoint requires Basic Authentication using the OAuth App's client_id as username and client_secret as password. It CANNOT be called with personal access tokens, GitHub App installation tokens, or any other token type. You must be the OAuth App owner to use this endpoint."
      },
      {
        "slug": "GITHUB_DELETE_A_REFERENCE",
        "name": "Delete a reference",
        "description": "Deletes a Git reference from a repository; 'ref' must be fully qualified (e.g., 'refs/heads/branch' or 'refs/tags/tag')."
      },
      {
        "slug": "GITHUB_DELETE_A_RELEASE",
        "name": "Delete a release",
        "description": "Permanently deletes a specific release, its assets, and potentially its associated Git tag from a repository."
      },
      {
        "slug": "GITHUB_DELETE_A_RELEASE_ASSET",
        "name": "Delete a release asset",
        "description": "Deletes a specific release asset from a GitHub repository; this action is idempotent."
      },
      {
        "slug": "GITHUB_DELETE_A_RELEASE_REACTION",
        "name": "Delete a release reaction",
        "description": "Deletes a reaction from a GitHub release, provided the repository, release, and reaction exist."
      },
      {
        "slug": "GITHUB_DELETE_A_REPOSITORY",
        "name": "Delete a repository",
        "description": "Permanently deletes the specified repository; this is a destructive, irreversible action that requires admin privileges for the repository."
      },
      {
        "slug": "GITHUB_DELETE_A_REPOSITORY_INVITATION",
        "name": "Delete a repository invitation",
        "description": "Deletes an active repository invitation, permanently revoking a user's access to collaborate on the specified repository."
      },
      {
        "slug": "GITHUB_DELETE_A_REPOSITORY_RULESET",
        "name": "Delete a repository ruleset",
        "description": "Permanently deletes a repository ruleset."
      },
      {
        "slug": "GITHUB_DELETE_A_REPOSITORY_SECRET",
        "name": "Delete a repository secret",
        "description": "Deletes a named GitHub Actions secret from a specified repository; this operation is destructive and idempotent, and requires the repository to exist."
      },
      {
        "slug": "GITHUB_DELETE_A_REPOSITORY_SUBSCRIPTION",
        "name": "Delete a repository subscription",
        "description": "Deletes the authenticated user's subscription to a specified repository if it exists, effectively 'unwatching' it."
      },
      {
        "slug": "GITHUB_DELETE_A_REPOSITORY_VARIABLE",
        "name": "Delete a repository variable",
        "description": "Deletes a named variable (e.g., for GitHub Actions workflows) from a repository; the repository and the variable must already exist."
      },
      {
        "slug": "GITHUB_DELETE_A_REPOSITORY_WEBHOOK",
        "name": "Delete a repository webhook",
        "description": "Deletes a specific webhook from a repository."
      },
      {
        "slug": "GITHUB_DELETE_A_REVIEW_COMMENT_FOR_A_PULL_REQUEST",
        "name": "Delete a review comment for a pull request",
        "description": "Deletes a specific pull request review comment."
      },
      {
        "slug": "GITHUB_DELETE_ARTIFACT",
        "name": "Delete an artifact",
        "description": "Deletes a GitHub artifact by its ID within a repository, typically resulting in an empty response (HTTP 204 No Content) on success."
      },
      {
        "slug": "GITHUB_DELETE_A_SECRET_FOR_THE_AUTHENTICATED_USER",
        "name": "Delete a secret for the authenticated user",
        "description": "Deletes an existing Codespaces secret for the authenticated user by `secret_name`. This is a destructive and irreversible operation. Returns 404 if the secret does not exist."
      },
      {
        "slug": "GITHUB_DELETE_A_SELF_HOSTED_RUNNER_FROM_AN_ORGANIZATION",
        "name": "Delete a self hosted runner from an organization",
        "description": "Forces the removal of a self-hosted runner from a GitHub organization. This endpoint can be used to completely remove the runner when the machine you were using no longer exists. The runner will be immediately disconnected from GitHub Actions. Requires admin:org scope and organization admin access. Returns 204 No Content on successful deletion."
      },
      {
        "slug": "GITHUB_DELETE_A_SELF_HOSTED_RUNNER_FROM_A_REPOSITORY",
        "name": "Delete a self hosted runner from a repository",
        "description": "Removes a specific self-hosted runner (by `runner_id`) from a repository, if registered there; this is idempotent."
      },
      {
        "slug": "GITHUB_DELETE_A_TAG_PROTECTION_STATE_FOR_A_REPOSITORY",
        "name": "Delete a tag protection state for a repository",
        "description": "DEPRECATED: This API was sunset on August 30, 2024. Use GITHUB_DELETE_A_REPOSITORY_RULESET instead to manage tag protection rules via repository rulesets."
      },
      {
        "slug": "GITHUB_DELETE_A_TEAM",
        "name": "Delete a team",
        "description": "Deletes a team (and any child teams) from an organization."
      },
      {
        "slug": "GITHUB_DELETE_A_THREAD_SUBSCRIPTION",
        "name": "Delete a thread subscription",
        "description": "Call this to mute a specific notification thread by deleting the user's subscription; notifications may still occur if the user is @mentioned, comments, or due to repository watch settings."
      },
      {
        "slug": "GITHUB_DELETE_AUTOLINK_REFERENCE",
        "name": "Delete an autolink reference from a repository",
        "description": "Deletes a specific autolink reference (which automatically links external resource IDs like JIRA-123 to URLs) from the specified repository."
      },
      {
        "slug": "GITHUB_DELETE_A_WORKFLOW_RUN",
        "name": "Delete a workflow run",
        "description": "Deletes a specific workflow run from a repository."
      },
      {
        "slug": "GITHUB_DELETE_BRANCH_PROTECTION",
        "name": "Delete branch protection",
        "description": "Removes all protection rules from a specific branch in a GitHub repository; the branch must currently have protection rules enabled."
      },
      {
        "slug": "GITHUB_DELETE_CODE_SCANNING_ANALYSIS",
        "name": "Delete a code scanning analysis from a repository",
        "description": "Deletes a specific code scanning analysis by its ID from a repository; `confirm_delete` must be `true` if it's the last analysis of its type for a given tool and reference to prevent data loss."
      },
      {
        "slug": "GITHUB_DELETE_CODESPACE",
        "name": "Delete a codespace for the authenticated user",
        "description": "Deletes a specific codespace owned by the authenticated user; this is a destructive action and the codespace must exist."
      },
      {
        "slug": "GITHUB_DELETE_COMMIT_COMMENT",
        "name": "Delete a commit comment",
        "description": "Deletes a specific commit comment, identified by its `comment_id`, from the specified repository; the comment must exist."
      },
      {
        "slug": "GITHUB_DELETE_COMMIT_COMMENT_REACTION",
        "name": "Delete a commit comment reaction",
        "description": "Deletes a reaction from a commit comment in a GitHub repository."
      },
      {
        "slug": "GITHUB_DELETE_COMMIT_SIGNATURE_PROTECTION",
        "name": "Delete commit signature protection",
        "description": "Disables GPG commit signature protection for a specific branch in a GitHub repository, meaning commits pushed to this branch no longer require GPG signing."
      },
      {
        "slug": "GITHUB_DELETE_CUSTOM_ORGANIZATION_ROLE",
        "name": "Delete a custom organization role",
        "description": "Deletes a custom organization role (which should not be actively assigned) by its ID; a 204 No Content response indicates success."
      },
      {
        "slug": "GITHUB_DELETE_DEPENDEBOT_SECRET_BY_NAME",
        "name": "Delete dependabot secret by name",
        "description": "Deletes a specific Dependabot secret, identified by its name, from a given repository if both the repository and secret exist."
      },
      {
        "slug": "GITHUB_DELETE_DEPLOY_KEY",
        "name": "Delete a deploy key",
        "description": "Deletes a specific deploy key from a repository; to change a key's properties or access scope, the existing key must be deleted and a new one created."
      },
      {
        "slug": "GITHUB_DELETE_DEPLOYMENT",
        "name": "Delete a deployment",
        "description": "Permanently deletes a specified *inactive* deployment from a repository."
      },
      {
        "slug": "GITHUB_DELETE_DEPLOYMENT_BRANCH_POLICY",
        "name": "Delete a deployment branch policy",
        "description": "Deletes a specific deployment branch or tag policy, identified by its ID, from a given environment within a repository."
      },
      {
        "slug": "GITHUB_DELETE_DISCUSSION",
        "name": "Delete a discussion",
        "description": "Deletes a specific team discussion, identified by its number, from an organization's team."
      },
      {
        "slug": "GITHUB_DELETE_DISCUSSION_COMMENT",
        "name": "Delete a discussion comment",
        "description": "Deletes a specific comment from an existing team discussion within an organization, provided the specified organization, team, discussion, and comment all exist."
      },
      {
        "slug": "GITHUB_DELETE_EMAIL_ADDRESS",
        "name": "Delete authenticated user email address",
        "description": "Sends an empty request body to `DELETE /user/emails` to attempt deletion of user email addresses; the API typically requires specific emails, so outcome may vary."
      },
      {
        "slug": "GITHUB_DELETE_ENVIRONMENT",
        "name": "Delete an environment",
        "description": "Deletes an existing deployment environment from an existing repository."
      },
      {
        "slug": "GITHUB_DELETE_ENVIRONMENT_SECRET",
        "name": "Delete an environment secret",
        "description": "Deletes an existing and accessible secret from a specified environment within a GitHub repository, returning an empty dictionary on success or error details otherwise."
      },
      {
        "slug": "GITHUB_DELETE_ENVIRONMENT_VARIABLE",
        "name": "Delete an environment variable",
        "description": "Deletes a named environment variable from a specified, existing environment within a GitHub repository."
      },
      {
        "slug": "GITHUB_DELETE_GIST",
        "name": "Delete a gist",
        "description": "Permanently deletes an existing GitHub gist, specified by its `gist_id`; this action is destructive and cannot be undone."
      },
      {
        "slug": "GITHUB_DELETE_GIST_COMMENT",
        "name": "Delete a gist comment",
        "description": "Deletes a specific comment from a GitHub Gist using its `gist_id` and `comment_id`."
      },
      {
        "slug": "GITHUB_DELETE_GITHUB_ACTIONS_CACHE_BY_ID",
        "name": "Delete GitHub Actions cache by ID",
        "description": "Deletes a specific GitHub Actions cache from a repository using its unique `cache_id`."
      },
      {
        "slug": "GITHUB_DELETE_GITHUB_PAGES_SITE",
        "name": "Delete a GitHub Pages site",
        "description": "Deletes the GitHub Pages site for the specified repository; completes without error if no site is currently enabled."
      },
      {
        "slug": "GITHUB_DELETE_ISSUE_COMMENT",
        "name": "Delete an issue comment",
        "description": "Permanently deletes a specific comment by its ID from an issue or pull request, if the repository exists and the comment ID is valid."
      },
      {
        "slug": "GITHUB_DELETE_ISSUE_COMMENT_REACTION",
        "name": "Delete an issue comment reaction",
        "description": "Deletes a reaction from an issue comment in a repository; the repository, comment, and reaction must exist."
      },
      {
        "slug": "GITHUB_DELETE_ISSUE_REACTION",
        "name": "Delete an issue reaction",
        "description": "Permanently removes a specific reaction from an issue in a GitHub repository."
      },
      {
        "slug": "GITHUB_DELETE_LABEL",
        "name": "Delete a label",
        "description": "Permanently removes an existing label from a repository."
      },
      {
        "slug": "GITHUB_DELETE_MILESTONE",
        "name": "Delete a milestone",
        "description": "Deletes the specified milestone if it exists; this operation is idempotent, typically returning a 404 if the milestone is not found or already deleted."
      },
      {
        "slug": "GITHUB_DELETE_ORGANIZATION",
        "name": "Delete an organization",
        "description": "Deletes a GitHub organization and its repositories; this is a destructive action and the organization name will be unavailable for reuse for approximately 90 days."
      },
      {
        "slug": "GITHUB_DELETE_ORGANIZATION_SECRET",
        "name": "Delete an organization secret",
        "description": "Permanently deletes a secret from a GitHub organization, making it inaccessible to GitHub Actions workflows or other tools."
      },
      {
        "slug": "GITHUB_DELETE_ORGANIZATION_VARIABLE",
        "name": "Delete an organization variable",
        "description": "Deletes a named GitHub Actions variable from a specified organization."
      },
      {
        "slug": "GITHUB_DELETE_ORGANIZATION_WEBHOOK",
        "name": "Delete an organization webhook",
        "description": "Deletes a specific webhook, identified by `hook_id`, from an existing organization."
      },
      {
        "slug": "GITHUB_DELETE_ORG_CODESPACE",
        "name": "Delete a codespace from the organization",
        "description": "Permanently deletes a specific codespace belonging to a member of the specified organization."
      },
      {
        "slug": "GITHUB_DELETE_ORG_PACKAGE",
        "name": "Delete a package for an organization",
        "description": "Deletes a specific package in an organization; cannot delete public packages with over 5,000 downloads."
      },
      {
        "slug": "GITHUB_DELETE_PACKAGE",
        "name": "Delete a package for the authenticated user",
        "description": "Permanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this API."
      },
      {
        "slug": "GITHUB_DELETE_PACKAGE_VERSION",
        "name": "Delete package version",
        "description": "Tool to delete a package version using GitHub GraphQL API. Use when you need to remove a specific version of a package by its global node ID."
      },
      {
        "slug": "GITHUB_DELETE_PACKAGE_VERSION_FOR_AN_ORGANIZATION",
        "name": "Delete package version for an organization",
        "description": "Deletes a specific package version within an organization; requires admin permissions for packages with over 5,000 downloads."
      },
      {
        "slug": "GITHUB_DELETE_PACKAGE_VERSION_FOR_A_USER",
        "name": "Delete package version for a user",
        "description": "Permanently and irreversibly deletes a specific version of a package owned by the specified user."
      },
      {
        "slug": "GITHUB_DELETE_PENDING_REVIEW",
        "name": "Delete a pending review for a pull request",
        "description": "Deletes a pending (unsubmitted) review from a pull request; this is only possible if the review has not yet been submitted."
      },
      {
        "slug": "GITHUB_DELETE_PROJECT",
        "name": "Delete a project",
        "description": "Deletes the specified GitHub project (Projects V2) using the GraphQL API. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects (classic) REST API was sunset on April 1, 2025 and is no longer available. The project is permanently deleted and cannot be recovered. The user must have admin permissions for the project to delete it."
      },
      {
        "slug": "GITHUB_DELETE_PROJECT_CARD",
        "name": "Delete a project card (Classic - Deprecated)",
        "description": "Deletes a project card from a GitHub 'Project (classic)'; this operation is idempotent. DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action may return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/"
      },
      {
        "slug": "GITHUB_DELETE_PROJECT_COLUMN",
        "name": "Delete a project field (column)",
        "description": "Deletes a project field (column) from a GitHub Projects V2 project using the GraphQL API. IMPORTANT: GitHub Classic Projects REST API was sunset on April 1, 2025. This action now uses the GitHub Projects V2 GraphQL API with the deleteProjectV2Field mutation. Note: The built-in Status field cannot be deleted as it is a core field in GitHub Projects V2. Only custom fields can be deleted."
      },
      {
        "slug": "GITHUB_DELETE_PROJECT_ITEM_FOR_USER",
        "name": "Delete project item for user",
        "description": "Tool to delete a project item for a user in GitHub Projects V2. Use when you need to remove an item from a user's project. Requires the project item's GraphQL node ID (starts with 'PVTI_'). Uses the GitHub GraphQL API deleteProjectV2Item mutation."
      },
      {
        "slug": "GITHUB_DELETE_PULL_REQUEST_COMMENT_REACTION",
        "name": "Delete a pull request comment reaction",
        "description": "Deletes a specific reaction from a pull request review comment, provided the comment and reaction exist on that comment within the specified repository."
      },
      {
        "slug": "GITHUB_DELETE_PULL_REQUEST_REVIEW_PROTECTION",
        "name": "Delete pull request review protection",
        "description": "Disables the requirement for pull request reviews before merging for a specific, existing branch in an existing repository; this action is idempotent and will succeed even if the protection is not currently enabled."
      },
      {
        "slug": "GITHUB_DELETE_REPO_CODESPACE_SECRET_BY_NAME",
        "name": "Delete repo codespace secret by name",
        "description": "Deletes a specific Codespace secret from a repository by its name; this action is idempotent and will succeed even if the secret doesn't exist."
      },
      {
        "slug": "GITHUB_DELETE_SOCIAL_ACCOUNTS_FOR_THE_AUTHENTICATED_USER",
        "name": "Delete social accounts for the authenticated user",
        "description": "Deletes currently linked social media account URLs from the authenticated user's GitHub profile."
      },
      {
        "slug": "GITHUB_DELETE_TEAM_DISCUSSION_COMMENT_REACTION",
        "name": "Delete team discussion comment reaction",
        "description": "Deletes a reaction from a team discussion comment, given the organization name, team slug, discussion number, comment number, and reaction ID."
      },
      {
        "slug": "GITHUB_DELETE_TEAM_DISCUSSION_REACTION",
        "name": "Delete team discussion reaction",
        "description": "Permanently deletes a specific reaction from a team discussion within an organization."
      },
      {
        "slug": "GITHUB_DELETE_USER_LIST",
        "name": "Delete User List",
        "description": "Tool to delete a GitHub user list using GraphQL. Use when you need to remove a user list from a GitHub account."
      },
      {
        "slug": "GITHUB_DELETE_USER_PACKAGE",
        "name": "Delete a package for a user",
        "description": "Deletes a package owned by the specified user, requiring admin permissions for the authenticated user; deletion of public packages with over 5,000 downloads may require GitHub support."
      },
      {
        "slug": "GITHUB_DELETE_WORKFLOW_RUN_LOGS",
        "name": "Delete workflow run logs",
        "description": "Deletes all logs for a specific workflow run in a GitHub repository, provided the repository and run exist."
      },
      {
        "slug": "GITHUB_DISABLE_A_CUSTOM_PROTECTION_RULE_FOR_AN_ENVIRONMENT",
        "name": "Disable a custom protection rule for an environment",
        "description": "Disables a specific, currently active custom deployment protection rule for an existing environment within a GitHub repository."
      },
      {
        "slug": "GITHUB_DISABLE_A_WORKFLOW",
        "name": "Disable a workflow",
        "description": "Disables a specified workflow (by ID or filename) in a given GitHub repository, preventing new automatic triggers; any in-progress runs will continue."
      },
      {
        "slug": "GITHUB_DISABLE_PRIVATE_VULN_REPORTING_FOR_REPO",
        "name": "Disable private vulnerability reporting for a repository",
        "description": "Disables private vulnerability reporting for an existing GitHub repository, preventing direct private vulnerability reports to maintainers via GitHub's interface for this repository."
      },
      {
        "slug": "GITHUB_DISABLE_REPOSITORY_ACTIONS_IN_ORG",
        "name": "Disable Repository Actions In Org",
        "description": "Removes a repository from the list of selected repositories enabled for GitHub Actions in an organization. Only works when the organization's `enabled_repositories` policy is set to `selected`. Requires admin:org scope."
      },
      {
        "slug": "GITHUB_DISMISS_A_REVIEW_FOR_A_PULL_REQUEST",
        "name": "Dismiss a review for a pull request",
        "description": "Dismisses an APPROVED or CHANGES_REQUESTED review on a pull request with a mandatory explanatory message. IMPORTANT: Only reviews in APPROVED or CHANGES_REQUESTED state can be dismissed. Reviews in COMMENTED, PENDING, or already DISMISSED state will return a 422 error. To dismiss a review on a protected branch, you must be a repository admin or be authorized to dismiss pull request reviews."
      },
      {
        "slug": "GITHUB_DOWNLOAD_AN_ARTIFACT",
        "name": "Download an artifact",
        "description": "Downloads a GitHub Actions workflow artifact as a ZIP file. Returns the artifact as a downloadable file. Use GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORY or GITHUB_LIST_WORKFLOW_RUN_ARTIFACTS to get valid artifact IDs first."
      },
      {
        "slug": "GITHUB_DOWNLOAD_A_REPOSITORY_ARCHIVE_TAR",
        "name": "Download a repository tarball",
        "description": "Downloads a repository's source code as a tarball (.tar.gz) archive for a specific Git reference, if the repository is accessible."
      },
      {
        "slug": "GITHUB_DOWNLOAD_A_REPOSITORY_ARCHIVE_ZIP",
        "name": "Download a repository archive ZIP",
        "description": "Downloads a repository's source code as a ZIP archive for a specific Git reference (branch, tag, or commit SHA). IMPORTANT SIZE LIMITATION: This action may fail with 'payload too large' errors for large repositories due to platform size restrictions. If you encounter size limit issues, consider these alternatives: - Use GITHUB_GET_REPOSITORY_CONTENT to fetch specific files or directories (also lists directory contents) - Clone the repository using git if you need the full codebase Best suited for: small to medium repositories, downloading specific tagged releases, or quick code inspection."
      },
      {
        "slug": "GITHUB_DOWNLOAD_JOB_LOGS_FOR_A_WORKFLOW_RUN",
        "name": "Download job logs for a workflow run",
        "description": "Downloads logs for a specific job in a GitHub Actions workflow run, contingent on the repository's existence and the job ID being valid and having produced logs."
      },
      {
        "slug": "GITHUB_DOWNLOAD_WORKFLOW_RUN_ATTEMPT_LOGS",
        "name": "Download workflow run attempt logs",
        "description": "Downloads a ZIP archive of logs for a specific workflow run attempt. Returns a downloadable ZIP file containing logs for all jobs and steps in the workflow run."
      },
      {
        "slug": "GITHUB_DOWNLOAD_WORKFLOW_RUN_LOGS",
        "name": "Download workflow run logs",
        "description": "Downloads logs for a specific GitHub Actions workflow run as a ZIP archive containing log files for each job in the workflow."
      },
      {
        "slug": "GITHUB_ENABLE_A_WORKFLOW",
        "name": "Enable a workflow",
        "description": "Reactivates a currently disabled GitHub Actions workflow within a repository using its workflow ID or filename."
      },
      {
        "slug": "GITHUB_ENABLE_GITHUB_ACTIONS_IN_SELECTED_REPOSITORIES",
        "name": "Enable GitHub actions in selected repositories",
        "description": "Sets the specific repositories that can use GitHub Actions within an organization by replacing the current list; only applies if the organization's Actions policy is 'selected repositories'."
      },
      {
        "slug": "GITHUB_ENABLE_PRIVATE_VULN_REPORTING_FOR_REPO",
        "name": "Enable private vulnerability reporting for a repository",
        "description": "Enables private vulnerability reporting for a repository, allowing security researchers to privately submit vulnerability reports to maintainers."
      },
      {
        "slug": "GITHUB_ENABLE_REPO_FOR_GITHUB_ACTIONS",
        "name": "Enable repo for Github Actions",
        "description": "Adds a repository to the list of selected repositories enabled for GitHub Actions in an organization. Requires the organization's 'enabled_repositories' policy to be set to 'selected'."
      },
      {
        "slug": "GITHUB_ENCRYPT_AND_UPDATE_DEV_SECRET",
        "name": "Encrypt and update dev secret",
        "description": "Creates or updates a repository's development environment secret using an `encrypted_value` and its corresponding `key_id`; the secret must be pre-encrypted with the repository's Codespaces public key."
      },
      {
        "slug": "GITHUB_ENCRYPT_ORG_DEV_ENV_SECRET",
        "name": "Encrypt org dev env secret",
        "description": "Creates or updates an organization's GitHub Codespaces secret using an encrypted value and its corresponding public key ID."
      },
      {
        "slug": "GITHUB_EXPORT_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
        "name": "Export a codespace for the authenticated user",
        "description": "Triggers an export of a user's specified codespace, automatically stopping it if active, and returns its export status and download URL."
      },
      {
        "slug": "GITHUB_EXPORT_SBOM_FOR_REPO",
        "name": "Export an SBOM for a repository",
        "description": "Exports the software bill of materials (SBOM) in SPDX JSON format for a repository, if its dependency graph is enabled and it has at least one commit."
      },
      {
        "slug": "GITHUB_FIND_PULL_REQUESTS",
        "name": "Find Pull Requests",
        "description": "Primary tool to find and search pull requests. Supports filtering by repository, author, state, labels, and merge status, and returns structured PR data for reliable use in workflows. GitHub search results are capped at ~1000 total items; narrow filters when totals approach this limit. `created_since`/`updated_since` filter on creation/update timestamps, not `merged_at`; apply merge-date filtering client-side."
      },
      {
        "slug": "GITHUB_FIND_REPOSITORIES",
        "name": "Find Repositories",
        "description": "AI-optimized repository search with smart filtering by language, stars, topics, and ownership. Builds intelligent search queries and returns clean, actionable repository data. Check `incomplete_results` in the response — when true, results are non-exhaustive. Search endpoints are rate-limited to ~30 requests/minute (vs. 5000/hour for general REST); apply backoff on 403/429. Total results are capped at ~1000 per query regardless of pagination."
      },
      {
        "slug": "GITHUB_FOLLOW_ORGANIZATION_GRAPHQL",
        "name": "Follow Organization (GraphQL)",
        "description": "Tool to follow a GitHub organization using GraphQL. Use when you need to make the authenticated user follow an organization."
      },
      {
        "slug": "GITHUB_FOLLOW_USER",
        "name": "Follow a user",
        "description": "Allows the authenticated user to follow the GitHub user specified by `username`; this action is idempotent and the user cannot follow themselves."
      },
      {
        "slug": "GITHUB_FOLLOW_USER_GRAPHQL",
        "name": "Follow User (GraphQL)",
        "description": "Tool to follow a GitHub user using GraphQL. Use when you need to make the authenticated user follow another user."
      },
      {
        "slug": "GITHUB_FORCE_CANCEL_WORKFLOW_RUN",
        "name": "Force cancel a workflow run",
        "description": "Forcefully cancels a queued or in-progress GitHub Actions workflow run, bypassing conditions like always() that would otherwise continue execution. Only use when the standard cancel endpoint fails. Cannot cancel completed workflow runs. Requires write permissions to the repository."
      },
      {
        "slug": "GITHUB_FORK_GIST",
        "name": "Fork a gist",
        "description": "Forks a specified public gist, creating a copy under the authenticated user's account."
      },
      {
        "slug": "GITHUB_GENERATE_RELEASE_NOTES",
        "name": "Generate release notes content for a release",
        "description": "Generates Markdown release notes content (listing changes, pull requests, and contributors) for a GitHub repository release, customizable via tags and a configuration file."
      },
      {
        "slug": "GITHUB_GET_A_BLOB",
        "name": "Get a blob",
        "description": "Retrieves the raw, typically Base64-encoded, content of a file (blob) from a GitHub repository using its SHA hash, if the repository and blob SHA exist."
      },
      {
        "slug": "GITHUB_GET_A_BRANCH",
        "name": "Get a branch",
        "description": "Retrieves detailed information for a specified branch within a GitHub repository."
      },
      {
        "slug": "GITHUB_GET_ACCESS_RESTRICTIONS",
        "name": "Get access restrictions",
        "description": "Lists users, teams, and GitHub Apps with push access to a branch; this branch must be protected in repository settings for detailed restrictions, otherwise expect a 404 or empty response."
      },
      {
        "slug": "GITHUB_GET_A_COMMIT",
        "name": "Get a commit",
        "description": "Retrieves a specific commit from a repository by its owner, name, and a valid commit reference (SHA, branch, or tag), supporting pagination for large diffs."
      },
      {
        "slug": "GITHUB_GET_ADMIN_BRANCH_PROTECTION",
        "name": "Get admin branch protection",
        "description": "Checks if repository administrators are subject to the branch protection rules on a specific branch."
      },
      {
        "slug": "GITHUB_GET_ALL_API_VERSIONS",
        "name": "Get all API versions",
        "description": "Retrieves all officially supported, date-based (e.g., \"2022-11-28\") versions of the GitHub REST API from the /versions endpoint."
      },
      {
        "slug": "GITHUB_GET_ALL_CONTRIBUTOR_COMMIT_ACTIVITY",
        "name": "Get all contributor commit activity",
        "description": "Retrieves commit activity (total commits, weekly additions/deletions/commits) for all contributors to a repository; may require a retry if GitHub returns 202 while preparing data."
      },
      {
        "slug": "GITHUB_GET_ALL_DEPLOYMENT_PROTECTION_RULES_FOR_ENV",
        "name": "Get all deployment protection rules for an environment",
        "description": "Lists all enabled custom deployment protection rules for a specific environment in a repository; the environment must exist and be configured for deployments."
      },
      {
        "slug": "GITHUB_GET_A_MILESTONE",
        "name": "Get a milestone",
        "description": "Retrieves detailed information for a specific milestone within a GitHub repository by its number."
      },
      {
        "slug": "GITHUB_GET_AN_APP",
        "name": "Get an app",
        "description": "Retrieves publicly available information for an existing GitHub App, identified by its unique URL-friendly `app_slug`."
      },
      {
        "slug": "GITHUB_GET_AN_ARTIFACT",
        "name": "Get an artifact",
        "description": "Gets a specific artifact for a repository by `artifact_id`. This action retrieves the details of a specific artifact from a GitHub repository using the artifact's unique identifier. It allows users to access information about artifacts stored in the repository."
      },
      {
        "slug": "GITHUB_GET_AN_ASSIGNMENT",
        "name": "Get an assignment",
        "description": "Retrieves detailed information for a specific GitHub Classroom assignment if the authenticated user is an administrator of the classroom."
      },
      {
        "slug": "GITHUB_GET_AN_AUTOLINK_REFERENCE_OF_A_REPOSITORY",
        "name": "Get an autolink reference of a repository",
        "description": "Retrieves a specific autolink reference (which automatically hyperlinks text like 'JIRA-123' to an external system) for a repository using its unique ID; requires administrator access to the repository."
      },
      {
        "slug": "GITHUB_GET_AN_ENVIRONMENT",
        "name": "Get an environment",
        "description": "Retrieves the details of a specific deployment environment for a given repository, including its name, configurations, and current status."
      },
      {
        "slug": "GITHUB_GET_AN_ENVIRONMENT_PUBLIC_KEY",
        "name": "Get an environment public key",
        "description": "Retrieves the public key for a specified GitHub repository environment, used to encrypt secrets for GitHub Actions."
      },
      {
        "slug": "GITHUB_GET_AN_ENVIRONMENT_SECRET",
        "name": "Get an environment secret",
        "description": "Retrieves metadata (name and timestamps) for a single secret in a GitHub Actions environment. Note: The actual secret value is never returned by this API for security reasons."
      },
      {
        "slug": "GITHUB_GET_AN_ENVIRONMENT_VARIABLE",
        "name": "Get an environment variable",
        "description": "Retrieves a specific environment variable from a GitHub Actions environment by repository owner, repository name, environment name, and variable name."
      },
      {
        "slug": "GITHUB_GET_AN_ISSUE",
        "name": "Get an issue",
        "description": "Retrieves detailed information about a specific issue in a repository using the owner, repository name, and issue number."
      },
      {
        "slug": "GITHUB_GET_AN_ISSUE_COMMENT",
        "name": "Get an issue comment",
        "description": "Action to get an issue comment."
      },
      {
        "slug": "GITHUB_GET_AN_ISSUE_EVENT",
        "name": "Get an issue event",
        "description": "Fetches details of a specific issue event for a given repository and event ID."
      },
      {
        "slug": "GITHUB_GET_AN_ORGANIZATION",
        "name": "Get an organization",
        "description": "Get an organization"
      },
      {
        "slug": "GITHUB_GET_AN_ORGANIZATION_PUBLIC_KEY",
        "name": "Get an organization public key",
        "description": "Action for `GetAnOrganizationPublicKey`."
      },
      {
        "slug": "GITHUB_GET_AN_ORGANIZATION_ROLE",
        "name": "Get an organization role",
        "description": "Retrieves a specific GitHub organization role by its ID."
      },
      {
        "slug": "GITHUB_GET_AN_ORGANIZATION_SECRET",
        "name": "Get an organization secret",
        "description": "Gets an organization secret's metadata (e.g., name, creation/update dates, visibility), but not its encrypted value."
      },
      {
        "slug": "GITHUB_GET_AN_ORGANIZATION_VARIABLE",
        "name": "Get an organization variable",
        "description": "Retrieves details (name, value, visibility, timestamps) of a specific, existing variable for an existing GitHub organization."
      },
      {
        "slug": "GITHUB_GET_AN_ORGANIZATION_WEBHOOK",
        "name": "Get an organization webhook",
        "description": "Retrieves the full configuration, including subscribed events and delivery settings, for an existing organization webhook."
      },
      {
        "slug": "GITHUB_GET_A_PACKAGE_FOR_AN_ORGANIZATION",
        "name": "Get a package for an organization",
        "description": "Retrieves a specific package (by type and name) from an organization, if both the package and organization exist."
      },
      {
        "slug": "GITHUB_GET_A_PACKAGE_FOR_A_USER",
        "name": "Get a package for a user",
        "description": "Retrieves metadata for a specific package owned by a GitHub user, using package type, name, and username as identifiers."
      },
      {
        "slug": "GITHUB_GET_A_PACKAGE_FOR_THE_AUTHENTICATED_USER",
        "name": "Get a package for the authenticated user",
        "description": "Retrieves detailed information for a specific package owned by the authenticated user."
      },
      {
        "slug": "GITHUB_GET_A_PACKAGE_VERSION_FOR_AN_ORGANIZATION",
        "name": "Get a package version for an organization",
        "description": "Retrieves detailed information for a specific version of a package within an organization."
      },
      {
        "slug": "GITHUB_GET_A_PACKAGE_VERSION_FOR_A_USER",
        "name": "Get a package version for a user",
        "description": "Retrieves a specific public package version associated with a GitHub user."
      },
      {
        "slug": "GITHUB_GET_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USER",
        "name": "Get authenticated user package version",
        "description": "Retrieves detailed information for an existing specific package version associated with the authenticated user, identified by its type, name, and version ID."
      },
      {
        "slug": "GITHUB_GET_A_PROJECT",
        "name": "Get a project",
        "description": "Retrieves detailed information for a specific GitHub project (V2) using its project number and owner. Note: This action uses GitHub's Projects V2 REST API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed."
      },
      {
        "slug": "GITHUB_GET_A_PROJECT_CARD",
        "name": "Get a project card",
        "description": "Retrieves all details of a specific project card, given its unique `card_id`. DEPRECATION NOTICE: GitHub Projects (classic) REST API was sunset on April 1, 2025. This action only works with existing classic project cards that were created before the sunset date. For new projects, use GitHub Projects V2 (GraphQL API) instead."
      },
      {
        "slug": "GITHUB_GET_A_PROJECT_COLUMN",
        "name": "Get a project column (Classic - Deprecated)",
        "description": "Retrieves detailed information for a specific project column from GitHub Projects (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return 404 for most requests on GitHub.com. However, it may still work on GitHub Enterprise Server instances where classic projects are enabled. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/ Returns column details including: id, name, url, project_url, cards_url, node_id, created_at, and updated_at timestamps."
      },
      {
        "slug": "GITHUB_GET_A_PULL_REQUEST",
        "name": "Get a pull request",
        "description": "Retrieves a specific pull request from a GitHub repository using its owner, repository name, and pull request number."
      },
      {
        "slug": "GITHUB_GET_A_REFERENCE",
        "name": "Get a reference",
        "description": "Retrieves a specific Git reference (e.g., a branch, tag, or fully qualified like 'heads/main') from a GitHub repository. The reference must exist in the repository; use 'list_matching_references' first if unsure what references are available."
      },
      {
        "slug": "GITHUB_GET_A_RELEASE",
        "name": "Get a release",
        "description": "Gets a specific release from a GitHub repository, provided the repository is accessible and the release exists."
      },
      {
        "slug": "GITHUB_GET_A_RELEASE_ASSET",
        "name": "Get a release asset",
        "description": "Gets metadata for a specific release asset in a GitHub repository, including a `browser_download_url` for downloading the asset."
      },
      {
        "slug": "GITHUB_GET_A_RELEASE_BY_TAG_NAME",
        "name": "Get a release by tag name",
        "description": "Gets a release from a GitHub repository by its tag name; the repository and a release with this tag must already exist."
      },
      {
        "slug": "GITHUB_GET_A_REPOSITORY",
        "name": "Get a repository",
        "description": "Retrieves detailed information about an existing and accessible GitHub repository."
      },
      {
        "slug": "GITHUB_GET_A_REPOSITORY_PUBLIC_KEY",
        "name": "Get a repository public key",
        "description": "Gets a repository's public key for encrypting secrets to be used in GitHub Actions, if the repository exists and is accessible."
      },
      {
        "slug": "GITHUB_GET_A_REPOSITORY_README",
        "name": "Get a repository readme",
        "description": "Fetches the README file (if it exists and is accessible) from a specified GitHub repository, returning its Base64-encoded content and metadata."
      },
      {
        "slug": "GITHUB_GET_A_REPOSITORY_README_FOR_A_DIRECTORY",
        "name": "Get a repository readme for a directory",
        "description": "Retrieves the README file from a specified directory within a GitHub repository, optionally at a given commit, branch, or tag."
      },
      {
        "slug": "GITHUB_GET_A_REPOSITORY_RULESET",
        "name": "Get a repository ruleset",
        "description": "Retrieves a specific repository ruleset by its ID; if `includes_parents` is true, the search for this `ruleset_id` also extends to rulesets from parent organizations."
      },
      {
        "slug": "GITHUB_GET_A_REPOSITORY_RULE_SUITE",
        "name": "Get a repository rule suite",
        "description": "Gets detailed information for a specific repository rule suite by its ID, including its evaluation status and the results of its individual rules."
      },
      {
        "slug": "GITHUB_GET_A_REPOSITORY_SECRET",
        "name": "Get a repository secret",
        "description": "Gets metadata (name, creation/update timestamps) for an existing repository secret, excluding its encrypted value."
      },
      {
        "slug": "GITHUB_GET_A_REPOSITORY_SUBSCRIPTION",
        "name": "Get a repository subscription",
        "description": "Gets the authenticated user's subscription details for a repository, indicating if they receive notifications."
      },
      {
        "slug": "GITHUB_GET_A_REPOSITORY_VARIABLE",
        "name": "Get a repository variable",
        "description": "Gets a specific GitHub Actions variable by name from an accessible repository."
      },
      {
        "slug": "GITHUB_GET_A_REPOSITORY_WEBHOOK",
        "name": "Get a repository webhook",
        "description": "Returns the configuration of an existing webhook for a given repository."
      },
      {
        "slug": "GITHUB_GET_A_REVIEW_COMMENT_FOR_A_PULL_REQUEST",
        "name": "Get a review comment for a pull request",
        "description": "Retrieves a specific pull request review comment by its ID, provided the repository exists, is accessible, and the comment ID is valid."
      },
      {
        "slug": "GITHUB_GET_A_REVIEW_FOR_A_PULL_REQUEST",
        "name": "Get a review for a pull request",
        "description": "Retrieves a specific review for a pull request using its owner, repository, pull request number, and review ID."
      },
      {
        "slug": "GITHUB_GET_A_SECRET_FOR_THE_AUTHENTICATED_USER",
        "name": "Get a secret for the authenticated user",
        "description": "Retrieves metadata (name, timestamps, visibility; not the value) for a specific, existing development environment secret associated with the authenticated user's GitHub Codespaces."
      },
      {
        "slug": "GITHUB_GET_A_SELF_HOSTED_RUNNER_FOR_AN_ORGANIZATION",
        "name": "Get a self hosted runner for an organization",
        "description": "Retrieves detailed information about a specific self-hosted runner registered within a GitHub organization."
      },
      {
        "slug": "GITHUB_GET_A_SELF_HOSTED_RUNNER_FOR_A_REPOSITORY",
        "name": "Get a self hosted runner for a repository",
        "description": "Gets a specific self-hosted runner for a repository by its unique ID."
      },
      {
        "slug": "GITHUB_GET_ASSIGNMENT_GRADES",
        "name": "Get assignment grades",
        "description": "Retrieves all grades for an existing GitHub Classroom assignment."
      },
      {
        "slug": "GITHUB_GET_A_TAG",
        "name": "Get a tag",
        "description": "Retrieves detailed information for a specific Git tag object from a GitHub repository, using the SHA of the tag object itself."
      },
      {
        "slug": "GITHUB_GET_A_TEAM_BY_NAME",
        "name": "Get a team by name",
        "description": "Retrieves a GitHub team by its slug from a specific organization."
      },
      {
        "slug": "GITHUB_GET_A_THREAD",
        "name": "Get a thread",
        "description": "Retrieves a specific GitHub notification thread using its unique `thread_id`."
      },
      {
        "slug": "GITHUB_GET_A_THREAD_SUBSCRIPTION_FOR_THE_AUTHENTICATED_USER",
        "name": "Get a thread subscription for the authenticated user",
        "description": "Retrieves the authenticated user's subscription details for a specific notification thread, identified by `thread_id`."
      },
      {
        "slug": "GITHUB_GET_A_TREE",
        "name": "List repository files and directories",
        "description": "Browse and list all files/directories in a GitHub repository. Efficiently retrieves the complete repository structure in a single API call when used with recursive mode. Perfect for analyzing codebase structure, finding specific files, or getting an overview of repository contents without cloning."
      },
      {
        "slug": "GITHUB_GET_A_USER",
        "name": "Get a user",
        "description": "Retrieves the public profile information for an existing GitHub user, specified by their username."
      },
      {
        "slug": "GITHUB_GET_A_WEBHOOK_CONFIGURATION_FOR_AN_ORGANIZATION",
        "name": "Get a webhook configuration for an organization",
        "description": "Retrieves the configuration for a specific webhook associated with a GitHub organization."
      },
      {
        "slug": "GITHUB_GET_A_WEBHOOK_CONFIGURATION_FOR_A_REPOSITORY",
        "name": "Get a webhook configuration for a repository",
        "description": "Returns the configuration for an existing webhook on the specified repository."
      },
      {
        "slug": "GITHUB_GET_A_WEBHOOK_DELIVERY_FOR_AN_ORGANIZATION_WEBHOOK",
        "name": "Get a webhook delivery for an organization webhook",
        "description": "Returns detailed information for a specific delivery attempt of a webhook configured for the specified GitHub organization."
      },
      {
        "slug": "GITHUB_GET_A_WORKFLOW",
        "name": "Get a workflow",
        "description": "Retrieves detailed information for a specific GitHub Actions workflow in a repository, identified by either its numeric ID or its filename."
      },
      {
        "slug": "GITHUB_GET_A_WORKFLOW_RUN",
        "name": "Get a workflow run",
        "description": "Gets a specific workflow run by its ID from a GitHub repository."
      },
      {
        "slug": "GITHUB_GET_A_WORKFLOW_RUN_ATTEMPT",
        "name": "Get a workflow run attempt",
        "description": "Retrieves detailed information for a specific attempt of a workflow run in a GitHub repository, including its status, conclusion, and timings."
      },
      {
        "slug": "GITHUB_GET_BILLING_USAGE_REPORT_USER",
        "name": "Get billing usage report for user",
        "description": "Retrieves the billing usage report for a specified GitHub user. Use when you need to analyze billing costs and usage patterns."
      },
      {
        "slug": "GITHUB_GET_BRANCH_PROTECTION",
        "name": "Get branch protection",
        "description": "Retrieves branch protection settings for a specific, existing, and accessible branch in a GitHub repository; protection feature availability varies by GitHub product plan."
      },
      {
        "slug": "GITHUB_GET_CATALOG_MODELS",
        "name": "Get catalog models",
        "description": "Tool to retrieve the list of AI models available in the GitHub Models catalog. Use when you need to discover available models, their capabilities, token limits, and supported modalities."
      },
      {
        "slug": "GITHUB_GET_CHECK_RUN",
        "name": "Get a check run",
        "description": "Retrieves detailed information for a specific check run within a GitHub repository."
      },
      {
        "slug": "GITHUB_GET_CHECK_SUITE",
        "name": "Get a check suite",
        "description": "Retrieves a specific check suite (a collection of check runs) by its ID from a repository accessible to the authenticated user."
      },
      {
        "slug": "GITHUB_GET_CLASSROOM",
        "name": "Get a classroom",
        "description": "Retrieves details for a specific GitHub Classroom. Requires the authenticated user to be an administrator of the classroom."
      },
      {
        "slug": "GITHUB_GET_CODE_OF_CONDUCT",
        "name": "Get a code of conduct",
        "description": "Retrieves the full details of a specific GitHub code of conduct using its unique key."
      },
      {
        "slug": "GITHUB_GET_CODE_OF_CONDUCT_GRAPH_QL",
        "name": "Get Code of Conduct (GraphQL)",
        "description": "Tool to look up a code of conduct by its key using GitHub's GraphQL API. Use when you need to fetch code of conduct details as part of a GraphQL workflow."
      },
      {
        "slug": "GITHUB_GET_CODEQL_DATABASE",
        "name": "Get a CodeQL database for a repository",
        "description": "Gets an existing CodeQL database (including a download URL) for a specified language in an accessible repository, if one has been successfully built for that language."
      },
      {
        "slug": "GITHUB_GET_CODE_SCANNING_ALERT",
        "name": "Get a code scanning alert",
        "description": "Retrieves a specific code scanning alert, which identifies potential code vulnerabilities or errors, by its number from the specified GitHub repository."
      },
      {
        "slug": "GITHUB_GET_CODE_SCANNING_ANALYSIS",
        "name": "Get a code scanning analysis for a repository",
        "description": "Retrieves detailed information for a specific code scanning analysis on an accessible repository, identified by its `analysis_id`."
      },
      {
        "slug": "GITHUB_GET_CODE_SCANNING_DEFAULT_SETUP",
        "name": "Get a code scanning default setup configuration",
        "description": "Gets the default setup configuration for code scanning in a repository, including state, languages, query suite, and schedule for a repository if it exists."
      },
      {
        "slug": "GITHUB_GET_CODESPACE",
        "name": "Get a codespace for the authenticated user",
        "description": "Call to retrieve detailed information for a `codespace_name` belonging to the authenticated user, ensuring the codespace exists and is accessible."
      },
      {
        "slug": "GITHUB_GET_COMMIT_AUTHORS",
        "name": "Get commit authors",
        "description": "Fetches commit authors identified during a repository import, used to map authors from an external VCS to GitHub accounts. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports."
      },
      {
        "slug": "GITHUB_GET_COMMIT_COMMENT",
        "name": "Get a commit comment",
        "description": "Retrieves the full details of a specific commit comment in a GitHub repository, using its unique identifier."
      },
      {
        "slug": "GITHUB_GET_COMMIT_OBJECT",
        "name": "Get a commit object",
        "description": "Retrieves detailed information (including author, committer, message, tree, parents, verification) for a specific commit in a GitHub repository, identified by its SHA."
      },
      {
        "slug": "GITHUB_GET_COMMIT_SIGNATURE_PROTECTION",
        "name": "Get commit signature protection",
        "description": "Gets the commit signature protection status for a branch in a repository."
      },
      {
        "slug": "GITHUB_GET_COMMIT_STATUSES",
        "name": "Get commit statuses",
        "description": "List all statuses for a commit reference (SHA, branch, or tag) in reverse chronological order. Use when you need to check CI/CD status results from various systems for a specific commit."
      },
      {
        "slug": "GITHUB_GET_COMMUNITY_PROFILE_METRICS",
        "name": "Get community profile metrics",
        "description": "Retrieves a repository's community profile metrics, including health percentage and the presence of key community files (e.g., README, LICENSE)."
      },
      {
        "slug": "GITHUB_GET_CONTEXTUAL_INFORMATION_FOR_A_USER",
        "name": "Get contextual information for a user",
        "description": "Gets contextual hovercard information for a GitHub user; `subject_type` and `subject_id` can be jointly provided for more specific details."
      },
      {
        "slug": "GITHUB_GET_CUSTOM_DEPLOYMENT_PROTECTION_RULE",
        "name": "Get a custom deployment protection rule",
        "description": "Retrieves a specific custom deployment protection rule (used by GitHub Apps for external validation or manual approval of deployments) for a given environment in a repository."
      },
      {
        "slug": "GITHUB_GET_DEFAULT_ATTRIBUTES_FOR_A_CODESPACE",
        "name": "Get default attributes for a codespace",
        "description": "Get pre-flight data (e.g., default location, devcontainer path) for creating a Codespace in a given repository (must exist and be accessible), optionally for a specific Git ref."
      },
      {
        "slug": "GITHUB_GET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_AN_ORGANIZATION",
        "name": "Get default workflow permissions for an organization",
        "description": "Gets the default GITHUB_TOKEN workflow permissions and settings for a GitHub organization."
      },
      {
        "slug": "GITHUB_GET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_A_REPOSITORY",
        "name": "Get default workflow permissions for a repository",
        "description": "Gets the default workflow permissions (`read` or `write`) for the GITHUB_TOKEN and whether it can approve pull request reviews in an existing and accessible repository."
      },
      {
        "slug": "GITHUB_GET_DEPENDENCY_DIFF",
        "name": "Get a diff of the dependencies between commits",
        "description": "Gets the dependency diff between two Git revisions in a repository, where 'basehead' specifies the revisions and 'name' can optionally scope to a specific manifest file."
      },
      {
        "slug": "GITHUB_GET_DEPLOY_KEY",
        "name": "Get a deploy key",
        "description": "Gets a specific deploy key, identified by its `key_id`, for the GitHub repository specified by `owner` and `repo`."
      },
      {
        "slug": "GITHUB_GET_DEPLOYMENT",
        "name": "Get a deployment",
        "description": "Gets a specific deployment by ID from a repository, provided the repository and deployment ID exist."
      },
      {
        "slug": "GITHUB_GET_DEPLOYMENT_BRANCH_POLICY",
        "name": "Get a deployment branch policy",
        "description": "Retrieves a specific deployment branch policy for an environment in a repository, identified by its unique ID."
      },
      {
        "slug": "GITHUB_GET_DEPLOYMENT_STATUS",
        "name": "Get a deployment status",
        "description": "Retrieves a specific deployment status by its ID for a given deployment within a GitHub repository."
      },
      {
        "slug": "GITHUB_GET_DETAILS_ABOUT_A_CODESPACE_EXPORT",
        "name": "Get details about a codespace export",
        "description": "Retrieves detailed information about a specific export of a codespace."
      },
      {
        "slug": "GITHUB_GET_DISCUSSION",
        "name": "Get a discussion",
        "description": "Fetches a specific discussion by its number from a team within an organization. This is a read-only action that retrieves discussion details including title, body, author information, comment count, and reactions. The authenticated user must be a member of the organization to access team discussions."
      },
      {
        "slug": "GITHUB_GET_DISCUSSION_COMMENT",
        "name": "Get a discussion comment",
        "description": "Fetches a specific comment from a team discussion within a specific organization."
      },
      {
        "slug": "GITHUB_GET_EMOJIS",
        "name": "Get emojis",
        "description": "Lists all emojis available for use on GitHub, including custom and Unicode emojis."
      },
      {
        "slug": "GITHUB_GET_ENTERPRISE_MEMBER_INVITATION",
        "name": "Get Enterprise Member Invitation",
        "description": "Tool to look up a pending enterprise unaffiliated member invitation by invitee and enterprise. Use when you need to check the status of a specific invitation."
      },
      {
        "slug": "GITHUB_GET_FEEDS",
        "name": "Get feeds",
        "description": "Fetches a list of available GitHub feed URLs for the authenticated user."
      },
      {
        "slug": "GITHUB_GET_GIST",
        "name": "Get a gist",
        "description": "Fetches a specific GitHub gist by its `gist_id`, returning comprehensive details if the gist exists."
      },
      {
        "slug": "GITHUB_GET_GIST_COMMENT",
        "name": "Get a gist comment",
        "description": "Retrieves a specific Gist comment by its ID and the Gist's ID."
      },
      {
        "slug": "GITHUB_GET_GIST_REVISION",
        "name": "Get a gist revision",
        "description": "Retrieves a specific revision of a gist."
      },
      {
        "slug": "GITHUB_GET_GITHUB_ACTIONS_CACHE_USAGE_FOR_AN_ORGANIZATION",
        "name": "Get GitHub Actions cache usage for an organization",
        "description": "Retrieves total GitHub Actions cache usage statistics for an organization, including active cache count and size across all repositories."
      },
      {
        "slug": "GITHUB_GET_GITHUB_ACTIONS_CACHE_USAGE_FOR_A_REPOSITORY",
        "name": "Get github actions cache usage for a repository",
        "description": "Retrieves the total count of active GitHub Actions caches and their combined size in bytes for a specified repository."
      },
      {
        "slug": "GITHUB_GET_GITHUB_ACTIONS_PERMISSIONS_FOR_AN_ORGANIZATION",
        "name": "Get github actions permissions for an organization",
        "description": "Gets the GitHub Actions permissions for a specified organization, detailing repository enablement and allowed actions policies."
      },
      {
        "slug": "GITHUB_GET_GITHUB_ACTIONS_PERMISSIONS_FOR_A_REPOSITORY",
        "name": "Get GitHub Actions permissions for a repository",
        "description": "Gets the GitHub Actions permissions policy for a repository, including its enabled status and the scope of allowed actions."
      },
      {
        "slug": "GITHUB_GET_GITHUB_BILLING_PREMIUM_REQUEST_USAGE_REPORT_USER",
        "name": "Get billing premium request usage",
        "description": "Tool to get billing premium request usage report for a GitHub user. Use when you need to retrieve usage data for premium features like Copilot or AI models."
      },
      {
        "slug": "GITHUB_GET_GITHUB_BILLING_USAGE_SUMMARY_FOR_USER",
        "name": "Get billing usage summary for user",
        "description": "Tool to retrieve billing usage summary for a GitHub user account. Use when tracking usage costs, monitoring billing details, or generating usage reports for a specific user. Note: This endpoint only returns data for the past 24 months and is currently in public preview."
      },
      {
        "slug": "GITHUB_GET_GITHUB_META_INFORMATION",
        "name": "Get github meta information",
        "description": "Fetches GitHub's publicly available metadata, useful for configuring network security policies or IP allow-listing."
      },
      {
        "slug": "GITHUB_GET_GITHUB_PAGES_BUILD",
        "name": "Get github pages build",
        "description": "Retrieves detailed information about a specific GitHub Pages build for a repository, which must have GitHub Pages enabled."
      },
      {
        "slug": "GITHUB_GET_GITIGNORE_TEMPLATE",
        "name": "Get a gitignore template",
        "description": "Retrieves a specific .gitignore template from GitHub by its name, which must be an existing template in GitHub's collection."
      },
      {
        "slug": "GITHUB_GET_GLOBAL_SECURITY_ADVISORY",
        "name": "Get a global security advisory",
        "description": "Retrieve a global GitHub security advisory by its GHSA identifier. Use this to get detailed information about vulnerabilities including severity, affected packages, CVSS scores, and references."
      },
      {
        "slug": "GITHUB_GET_GRAPHQL_NODE",
        "name": "Fetch GraphQL Node",
        "description": "Tool to fetch any GitHub object by its global node ID. Use when you have a node_id and need to retrieve the corresponding object details."
      },
      {
        "slug": "GITHUB_GET_GRAPHQL_RATE_LIMIT",
        "name": "Get GraphQL rate limit",
        "description": "Tool to retrieve the authenticated client's GitHub GraphQL API rate limit information. Use when you need to check remaining quota, current usage, or reset time for GraphQL requests."
      },
      {
        "slug": "GITHUB_GET_INFORMATION_ABOUT_A_SARIF_UPLOAD",
        "name": "Get information about a sarif upload",
        "description": "Retrieves detailed information, including processing status and results URL, about a specific SARIF (Static Analysis Results Interchange Format) upload for a repository, uniquely identified by its sarif_id."
      },
      {
        "slug": "GITHUB_GET_INTERACTION_RESTRICTIONS_FOR_AN_ORGANIZATION",
        "name": "Get interaction restrictions for an organization",
        "description": "Retrieves interaction restrictions for an organization, showing which GitHub user types can interact with its public repositories and when restrictions expire; returns an empty response if no restrictions are set."
      },
      {
        "slug": "GITHUB_GET_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORY",
        "name": "Get interaction restrictions for a repository",
        "description": "Retrieves active interaction restrictions for a repository, detailing which user groups are limited from activities like commenting or creating pull requests, and when these restrictions expire."
      },
      {
        "slug": "GITHUB_GET_INTERACTION_RESTRICTIONS_FOR_PUBLIC_REPOS",
        "name": "Get interaction restrictions for public repositories",
        "description": "Retrieves currently active interaction restrictions for the authenticated user's public repositories."
      },
      {
        "slug": "GITHUB_GET_ISSUE_COMMENTS",
        "name": "Get issue comments",
        "description": "Retrieves all comments for a specific GitHub issue in chronological order. Use this action when you need to view discussion history, analyze comment threads, or fetch comment details for a specific issue. Comments can be filtered by update time and paginated for large discussions."
      },
      {
        "slug": "GITHUB_GET_LABEL",
        "name": "Get a label",
        "description": "Retrieves a specific label by its name from a specified GitHub repository."
      },
      {
        "slug": "GITHUB_GET_LARGE_FILES",
        "name": "Get large files",
        "description": "Lists files larger than 100MB identified during a previous source import for the specified repository. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports."
      },
      {
        "slug": "GITHUB_GET_LATEST_PAGES_BUILD",
        "name": "Get latest pages build",
        "description": "Retrieves information about the most recent GitHub Pages build for a repository, which must exist, be accessible, have GitHub Pages enabled, and have at least one prior build."
      },
      {
        "slug": "GITHUB_GET_LICENSE",
        "name": "Get a license",
        "description": "Call this action to retrieve comprehensive details for a specific software license recognized by GitHub, using its unique license key."
      },
      {
        "slug": "GITHUB_GET_LICENSE_GRAPH_QL",
        "name": "Get License (GraphQL)",
        "description": "Tool to look up an open source license by its SPDX ID using GitHub's GraphQL API. Use when you need to fetch license details for compliance tracking or repository setup."
      },
      {
        "slug": "GITHUB_GET_OCTOCAT",
        "name": "Get octocat",
        "description": "Fetches an ASCII art representation of GitHub's Octocat, suitable for text-based displays."
      },
      {
        "slug": "GITHUB_GET_OIDC_SUBJECT_CLAIM_TEMPLATE",
        "name": "Customize OIDC subject claim template",
        "description": "Retrieves the OpenID Connect (OIDC) subject claim customization template for a repository, which defines the `sub` claim structure in OIDC tokens for GitHub Actions workflows; returns the default configuration if no customization is applied."
      },
      {
        "slug": "GITHUB_GET_ORG_ALLOWED_ACTIONS",
        "name": "Get allowed actions and workflows for an org",
        "description": "Gets the list of allowed actions and reusable workflows for an organization when the 'allowed_actions' policy is set to 'selected'."
      },
      {
        "slug": "GITHUB_GET_ORGANIZATION_AUDIT_LOG",
        "name": "Get organization audit log",
        "description": "Tool to retrieve an organization's audit log events for security and compliance investigations. Use when tracking organizational changes, security audits, or compliance monitoring. Requires organization owner permissions and read:audit_log scope."
      },
      {
        "slug": "GITHUB_GET_ORGANIZATION_CUSTOM_PROPERTY",
        "name": "Get a custom property for an organization",
        "description": "Retrieves the definition (schema) of a specific, existing custom property for an organization."
      },
      {
        "slug": "GITHUB_GET_ORGANIZATION_PROJECT_ITEM",
        "name": "Get organization project item",
        "description": "Tool to get an item from an organization-owned GitHub Projects V2 project. Use when you need to retrieve details about a specific project item including its content, fields, timestamps, and creator information."
      },
      {
        "slug": "GITHUB_GET_ORGANIZATION_PUBLIC_KEY",
        "name": "Get organization public key for Codespaces secrets",
        "description": "Retrieves an organization's public key, which must be used to encrypt secret values before they are configured for Codespaces."
      },
      {
        "slug": "GITHUB_GET_ORGANIZATION_PUBLIC_KEY_FOR_DEPENDABOT",
        "name": "Fetch Public Key For Secret Encryption",
        "description": "Retrieves the public key for an existing GitHub organization, required for encrypting Dependabot secrets. Requires admin:org scope."
      },
      {
        "slug": "GITHUB_GET_ORGANIZATION_TEAMS",
        "name": "Get organization teams",
        "description": "Retrieves a list of teams for a specified GitHub organization. Use this action when you need to list all teams, find team information, or explore team structure within an organization. Requires read:org scope and returns paginated results."
      },
      {
        "slug": "GITHUB_GET_ORG_DEV_ENVIRONMENT_SECRET_SAFELY",
        "name": "Get org dev environment secret safely",
        "description": "Retrieves metadata for a specific secret available to an organization's GitHub Codespaces without exposing its encrypted value."
      },
      {
        "slug": "GITHUB_GET_ORG_OIDC_SUBJECT_CLAIM_TEMPLATE",
        "name": "Get custom OIDC subject claim template",
        "description": "Retrieves the OpenID Connect (OIDC) subject claim customization template for a GitHub organization, which defines how the `sub` claim in OIDC tokens for workflows is constructed."
      },
      {
        "slug": "GITHUB_GET_PAGES_DNS_HEALTH_CHECK",
        "name": "Get a dns health check for github pages",
        "description": "Retrieves the DNS health check status (e.g., CNAME/A records, HTTPS) for a GitHub Pages site; the check may be pending (HTTP 202) on initial calls or after site changes."
      },
      {
        "slug": "GITHUB_GET_PAGES_SITE",
        "name": "Get a GitHub Pages site",
        "description": "Retrieves information for a GitHub Pages site, which must be enabled for the repository."
      },
      {
        "slug": "GITHUB_GET_PAGE_VIEWS",
        "name": "Get page views",
        "description": "Retrieves page view statistics for a repository over the last 14 days, including total views, unique visitors, and a daily or weekly breakdown."
      },
      {
        "slug": "GITHUB_GET_PENDING_DEPLOYMENTS_FOR_A_WORKFLOW_RUN",
        "name": "Get pending deployments for a workflow run",
        "description": "Retrieves pending deployment environments for a specific workflow run that are awaiting approval due to protection rules."
      },
      {
        "slug": "GITHUB_GET_PROJECT_PERMISSION_FOR_A_USER",
        "name": "Get project permission for a user",
        "description": "Retrieves permission information for a GitHub project (classic) collaborator. Returns the permission level and full user object for a collaborator on a GitHub project (classic). The permission returned can be admin, write, read, or none."
      },
      {
        "slug": "GITHUB_GET_PUBLIC_KEY_FOR_SECRET_ENCRYPTION",
        "name": "Get public key for secret encryption",
        "description": "Retrieves a repository's public key for encrypting GitHub Codespaces secrets; requires `repo` scope or equivalent read access to codespaces secrets for private repositories."
      },
      {
        "slug": "GITHUB_GET_PUBLIC_KEY_FOR_THE_AUTHENTICATED_USER",
        "name": "Get public key for the authenticated user",
        "description": "Retrieves the authenticated user's public key for encrypting GitHub Codespaces secrets. The returned key must be used with libsodium sealed box encryption before creating or updating secrets via the API."
      },
      {
        "slug": "GITHUB_GET_PULL_REQUEST_REVIEW_PROTECTION",
        "name": "Get pull request review protection",
        "description": "Retrieves the pull request review protection settings for a specific branch in a GitHub repository, if such protection is configured."
      },
      {
        "slug": "GITHUB_GET_PULL_REQUESTS",
        "name": "Get Pull Requests",
        "description": "Retrieves a list of pull requests from a repository with flexible filtering options. Use this action when you need to list all pull requests in a repository, optionally filtered by state (open, closed, all), base branch, head branch, or sort order. Returns an array of pull request objects with comprehensive details including title, state, author, labels, timestamps, and branch information."
      },
      {
        "slug": "GITHUB_GET_RATE_LIMIT_STATUS_FOR_THE_AUTHENTICATED_USER",
        "name": "Get rate limit status for the authenticated user",
        "description": "Retrieves the authenticated user's current GitHub API rate limit status, including usage and limits across different resource categories."
      },
      {
        "slug": "GITHUB_GET_RAW_REPOSITORY_CONTENT",
        "name": "Get Raw Repository Content",
        "description": "Tool to fetch raw file content from a GitHub repository. Returns raw bytes in whatever format the file uses (JSON, CSV, binary, etc.) — parsing and validation are the caller's responsibility. Ensure owner, repo, ref, and path are consistent when combining with other GitHub tools to avoid mismatched-ref errors."
      },
      {
        "slug": "GITHUB_GET_REPO_ALLOWED_ACTIONS",
        "name": "Get allowed actions and workflows for a repository",
        "description": "Gets the settings for allowed actions and reusable workflows in a repository. Requires the repository's `allowed_actions` policy to be set to `selected` (returns 409 if set to `all` or `local_only`)."
      },
      {
        "slug": "GITHUB_GET_REPO_DEV_ENV_SECRET",
        "name": "Get repository development environment secret",
        "description": "Gets metadata (name, creation/update timestamps) for a specific, existing development environment secret (Codespaces secret) in a repository, without exposing its value."
      },
      {
        "slug": "GITHUB_GET_REPOS_ATTESTATIONS",
        "name": "Get repository attestations",
        "description": "Tool to retrieve attestations by subject digest from a GitHub repository. Use when you need to verify or check attestations for a specific artifact identified by its SHA256 digest."
      },
      {
        "slug": "GITHUB_GET_REPOSITORY_CLONES",
        "name": "Get repository clones",
        "description": "Retrieves the total number of clones and a breakdown of clone activity (daily or weekly) for a specified repository over the preceding 14 days."
      },
      {
        "slug": "GITHUB_GET_REPOSITORY_CONTENT",
        "name": "Get repository content",
        "description": "Retrieves a file's Base64 encoded content or lists a directory's contents from a GitHub repository."
      },
      {
        "slug": "GITHUB_GET_REPOSITORY_GRAPH_QL",
        "name": "Get Repository via GraphQL",
        "description": "Tool to lookup a repository by owner and name using GitHub's GraphQL API. Use when you need comprehensive repository information."
      },
      {
        "slug": "GITHUB_GET_REPOSITORY_OWNER",
        "name": "Get Repository Owner",
        "description": "Tool to lookup a repository owner (User or Organization) by login using GitHub's GraphQL API. Use when you need to determine whether a login is a user or organization and retrieve basic profile information."
      },
      {
        "slug": "GITHUB_GET_REPOSITORY_PERMISSIONS_FOR_A_USER",
        "name": "Get repository permissions for a user",
        "description": "Retrieves a specific user's permission level ('admin', 'write', 'read', or 'none') for a given repository, where 'maintain' role is reported as 'write' and 'triage' as 'read'."
      },
      {
        "slug": "GITHUB_GET_REPOSITORY_PUBLIC_KEY_FOR_ENCRYPTION",
        "name": "Retrieve repo public key for encryption",
        "description": "Gets a repository's public key, used to encrypt secrets for Dependabot."
      },
      {
        "slug": "GITHUB_GET_REPOSITORY_SECRET_SECURELY",
        "name": "Get repository secret securely",
        "description": "Retrieves metadata for an existing Dependabot secret in a repository, without exposing its encrypted value."
      },
      {
        "slug": "GITHUB_GET_REPOSITORY_SECURITY_ADVISORY",
        "name": "Get repository security advisory",
        "description": "Tool to retrieve a repository security advisory using its GHSA identifier. Use when you need detailed information about a specific security vulnerability."
      },
      {
        "slug": "GITHUB_GET_REPOSITORY_WEBHOOK_DELIVERY",
        "name": "Get a delivery for a repository webhook",
        "description": "Retrieves a specific delivery for a repository webhook, identified by its `hook_id` and `delivery_id`."
      },
      {
        "slug": "GITHUB_GET_RULES_FOR_A_BRANCH",
        "name": "Get rules for a branch",
        "description": "Retrieves all active rules for a specific branch in a GitHub repository, excluding rules in 'evaluate' or 'disabled' status."
      },
      {
        "slug": "GITHUB_GET_SINGLE_ORG_SECRET_WITHOUT_DECRYPTION",
        "name": "Get Organization Dependabot Secret",
        "description": "Gets a single organization Dependabot secret's metadata (name, timestamps, visibility) without revealing its encrypted value. Requires admin:org scope."
      },
      {
        "slug": "GITHUB_GET_STATUS_CHECKS_PROTECTION",
        "name": "Get status checks protection",
        "description": "Retrieves the status check protection settings for a specific branch in a GitHub repository, if status check protection is enabled for it."
      },
      {
        "slug": "GITHUB_GET_TEAM_MEMBERS",
        "name": "Get team members",
        "description": "Retrieves a list of members for a specific team within an organization. Returns team members including members of child teams. Use this action when you need to see who belongs to a team, optionally filtered by their role (member or maintainer). Requires the authenticated user to have read access to the team within the organization."
      },
      {
        "slug": "GITHUB_GET_TEAM_MEMBERSHIP_FOR_A_USER",
        "name": "Get team membership for a user",
        "description": "Retrieves a user's role and membership status within a specific team in an organization. Returns membership details including role ('member' or 'maintainer') and state ('active' or 'pending'). If the user is not a member of the team, returns is_member=False with a descriptive message. Requires the authenticated user to be an organization member with visibility into the team."
      },
      {
        "slug": "GITHUB_GET_TEAMS_WITH_ACCESS_TO_THE_PROTECTED_BRANCH",
        "name": "Get teams with access to the protected branch",
        "description": "Lists teams with explicit push access to a protected branch, provided team restrictions are configured in the branch's protection settings; returns an empty list otherwise."
      },
      {
        "slug": "GITHUB_GET_THE_AUTHENTICATED_USER",
        "name": "Get the authenticated user",
        "description": "Gets the profile information for the currently authenticated GitHub user, including potentially private details based on user settings."
      },
      {
        "slug": "GITHUB_GET_THE_COMBINED_STATUS_FOR_A_SPECIFIC_REFERENCE",
        "name": "Get the combined status for a specific reference",
        "description": "Retrieves the aggregated commit status (e.g., success, failure, pending) from all checks for a specific reference (SHA, branch, or tag) in a GitHub repository."
      },
      {
        "slug": "GITHUB_GET_THE_HOURLY_COMMIT_COUNT_FOR_EACH_DAY",
        "name": "Get the hourly commit count for each day",
        "description": "Retrieves the 'punch card' data, showing hourly commit counts for each day of the week for an existing and accessible repository."
      },
      {
        "slug": "GITHUB_GET_THE_LAST_YEAR_OF_COMMIT_ACTIVITY",
        "name": "Get the last year of commit activity",
        "description": "Fetches weekly commit totals and daily commit counts for the last 52 weeks for a specified GitHub repository."
      },
      {
        "slug": "GITHUB_GET_THE_LATEST_RELEASE",
        "name": "Get the latest release",
        "description": "Fetches the latest official (non-prerelease, non-draft) release for a GitHub repository; requires at least one such published release."
      },
      {
        "slug": "GITHUB_GET_THE_LICENSE_FOR_A_REPOSITORY",
        "name": "Get the license for a repository",
        "description": "Retrieves the license file and its details for a repository, optionally from a specific Git reference (branch, tag, or commit SHA)."
      },
      {
        "slug": "GITHUB_GET_THE_REVIEW_HISTORY_FOR_A_WORKFLOW_RUN",
        "name": "Get the review history for a workflow run",
        "description": "Retrieves the detailed approval history for a specific workflow run in a GitHub repository, detailing each review's environment, state, reviewer, and comments, to track the approval process for workflows, particularly automated deployments."
      },
      {
        "slug": "GITHUB_GET_THE_STATUS_OF_A_GITHUB_PAGES_DEPLOYMENT",
        "name": "Get the status of a GitHub Pages deployment",
        "description": "Retrieves the status of a specific GitHub Pages deployment for a repository, which must have GitHub Pages enabled."
      },
      {
        "slug": "GITHUB_GET_THE_WEEKLY_COMMIT_ACTIVITY",
        "name": "Get the weekly commit activity",
        "description": "Fetches the weekly commit activity (additions and deletions per week) for a repository over the past year; best for repositories with under 10,000 commits."
      },
      {
        "slug": "GITHUB_GET_THE_WEEKLY_COMMIT_COUNT",
        "name": "Get the weekly commit count",
        "description": "Retrieves the weekly commit count for a repository, detailing commits by the owner and all contributors over the last 52 weeks; GitHub may return a 202 status or an empty response if statistics are being computed."
      },
      {
        "slug": "GITHUB_GET_THE_ZEN_OF_GITHUB",
        "name": "Get the Zen of GitHub",
        "description": "Retrieves a random quote from GitHub's 'Zen of GitHub' collection, reflecting GitHub's design philosophies and offering humorous insights, useful for displaying GitHub wisdom or a lighthearted message."
      },
      {
        "slug": "GITHUB_GET_TOP_REFERRAL_PATHS",
        "name": "Get top referral paths",
        "description": "Fetches the top 10 most viewed content paths for a repository from the last 14 days."
      },
      {
        "slug": "GITHUB_GET_TOP_REFERRAL_SOURCES",
        "name": "Get top referral sources",
        "description": "Fetches the top 10 websites that referred traffic to a repository within the last 14 days."
      },
      {
        "slug": "GITHUB_GET_USER_BY_ID",
        "name": "Get user by ID",
        "description": "Retrieves a GitHub user's profile information by their unique numeric account ID. Use when you know the user's numeric ID rather than their username."
      },
      {
        "slug": "GITHUB_GET_USER_PROJECT_ITEM",
        "name": "Get user project item",
        "description": "Tool to get an item from a user-owned project in GitHub Projects V2. Use when you need to retrieve details about a specific item (issue, pull request, or draft issue) in a user's project board."
      },
      {
        "slug": "GITHUB_GET_USERS_ATTESTATIONS",
        "name": "Get user attestations by subject digest",
        "description": "Tool to get attestations by subject digest for a GitHub user. Use when you need to retrieve attestation data for a specific artifact or resource identified by its subject digest."
      },
      {
        "slug": "GITHUB_GET_USERS_PROJECTS_V2",
        "name": "Get user's projects v2",
        "description": "Tool to list GitHub Projects v2 for a specified user. Use when you need to retrieve all projects owned by a user with pagination support."
      },
      {
        "slug": "GITHUB_GET_USERS_WITH_ACCESS_TO_THE_PROTECTED_BRANCH",
        "name": "Get users with access to the protected branch",
        "description": "Lists users with explicit push access to a protected branch, provided its protection rule restricts pushes to specific users."
      },
      {
        "slug": "GITHUB_GET_VIEWER_GRAPHQL",
        "name": "Get Viewer via GraphQL",
        "description": "Tool to retrieve the authenticated user's profile information via GitHub GraphQL. Use when working with GraphQL queries or need viewer details in GraphQL format."
      },
      {
        "slug": "GITHUB_GET_WORKFLOW_EXTERNAL_ACCESS",
        "name": "Get workflow external access level",
        "description": "Gets the access level settings for a private repository, determining how workflows outside this repository can use its actions and reusable workflows."
      },
      {
        "slug": "GITHUB_GET_WORKFLOW_RUN_JOB",
        "name": "Get a job for a workflow run",
        "description": "Retrieves detailed information for a specific job within a GitHub Actions workflow run, given its `job_id` which must be valid for the specified repository's workflow."
      },
      {
        "slug": "GITHUB_GET_WORKFLOW_RUN_USAGE",
        "name": "Get workflow run usage",
        "description": "Gets the billable time, in milliseconds, for a specific workflow run, detailing time spent on various operating systems."
      },
      {
        "slug": "GITHUB_GET_WORKFLOW_USAGE",
        "name": "Get workflow usage",
        "description": "Gets the billable time (in milliseconds, broken down by runner OS) for a specific workflow within a repository for the current billing cycle."
      },
      {
        "slug": "GITHUB_IS_REPOSITORY_STARRED_BY_THE_USER",
        "name": "Check if repo starred by auth user",
        "description": "Use to determine if the authenticated user has starred a specific GitHub repository, which is confirmed by an HTTP 204 status (resulting in an empty dictionary in the response data); the action fails (e.g., HTTP 404) if the repository is not starred or does not exist."
      },
      {
        "slug": "GITHUB_LIST_ACCEPTED_ASSIGNMENTS_FOR_AN_ASSIGNMENT",
        "name": "List accepted assignments for an assignment",
        "description": "Lists accepted assignments (student repositories created after acceptance) for an existing GitHub Classroom assignment, identified by its unique `assignment_id`."
      },
      {
        "slug": "GITHUB_LIST_ACCESSIBLE_REPOSITORIES",
        "name": "List repositories accessible via GitHub App installation",
        "description": "Lists repositories that the authenticated user can access through a specific GitHub App installation. Returns repositories where the user has explicit :read, :write, or :admin permission through the installation. The response includes permission details for each repository. Prerequisites: - Requires a GitHub App user access token (not a standard OAuth token) - Use GITHUB_LIST_APP_INSTALLATIONS first to get valid installation IDs"
      },
      {
        "slug": "GITHUB_LIST_APP_INSTALLATIONS",
        "name": "List app installations for user token",
        "description": "Lists GitHub App installations accessible to the authenticated user via their access token, including installation details, permissions, and repository access."
      },
      {
        "slug": "GITHUB_LIST_APPS_WITH_ACCESS_TO_THE_PROTECTED_BRANCH",
        "name": "Get apps with access to the protected branch",
        "description": "Lists GitHub Apps with push access to a repository's protected branch."
      },
      {
        "slug": "GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORY",
        "name": "List artifacts for a repository",
        "description": "Lists GitHub Actions workflow artifacts for a specified repository, which must exist."
      },
      {
        "slug": "GITHUB_LIST_ASSIGNEES",
        "name": "List assignees",
        "description": "Lists users who can be assigned to issues in a repository, typically those with push access."
      },
      {
        "slug": "GITHUB_LIST_ASSIGNMENTS_FOR_A_CLASSROOM",
        "name": "List assignments for a classroom",
        "description": "Lists all assignments for a given GitHub Classroom `classroom_id`; the classroom must exist and be accessible."
      },
      {
        "slug": "GITHUB_LIST_ATTESTATION_REPOSITORIES",
        "name": "List attestation repositories",
        "description": "Tool to list attestation repositories for an organization. Use when you need to discover which repositories in an organization have attestations. Attestations provide verifiable metadata about software artifacts."
      },
      {
        "slug": "GITHUB_LIST_AVAILABLE_MACHINE_TYPES_FOR_A_REPOSITORY",
        "name": "List available machine types for a repository",
        "description": "Lists machine types available for GitHub Codespaces in a repository, optionally using a Git ref to check compatibility based on prebuild availability and devcontainer configurations."
      },
      {
        "slug": "GITHUB_LIST_BRANCHES",
        "name": "List branches",
        "description": "List branches in a GitHub repository. Returns branch names, commit information, and protection status. Use this action when you need to retrieve all branches in a repository, optionally filtered by protection status. This is useful for identifying available branches, checking which branches are protected, or preparing to create pull requests."
      },
      {
        "slug": "GITHUB_LIST_BRANCHES_FOR_HEAD_COMMIT",
        "name": "List branches for head commit",
        "description": "Lists branches in an accessible repository where the provided commit SHA is the head, useful for identifying development lines based on that commit."
      },
      {
        "slug": "GITHUB_LIST_CHECK_RUN_ANNOTATIONS",
        "name": "List check run annotations",
        "description": "Lists annotations for a specific check run in a GitHub repository, detailing issues like errors or warnings on particular code lines."
      },
      {
        "slug": "GITHUB_LIST_CHECK_RUNS_FOR_A_REF",
        "name": "List check runs for a git ref",
        "description": "List GitHub check runs for a commit SHA, branch, or tag to assess CI status and conclusions. Use when you need reliable CI pass/fail signals beyond commit metadata."
      },
      {
        "slug": "GITHUB_LIST_CHECK_RUNS_IN_A_CHECK_SUITE",
        "name": "List check runs in a check suite",
        "description": "Lists check runs for a specific check suite in a GitHub repository, optionally filtering by check name or status."
      },
      {
        "slug": "GITHUB_LIST_CHECK_SUITES_FOR_A_GIT_REFERENCE",
        "name": "List check suites for a git reference",
        "description": "Lists check suites for a Git reference (commit SHA, branch, or tag) in a repository, optionally filtering by GitHub App ID or check run name."
      },
      {
        "slug": "GITHUB_LIST_CHILD_TEAMS",
        "name": "List child teams",
        "description": "Lists the immediate child teams of a parent team within an organization."
      },
      {
        "slug": "GITHUB_LIST_CLASSROOMS",
        "name": "List classrooms",
        "description": "Lists GitHub Classrooms to which the authenticated user has administrative access."
      },
      {
        "slug": "GITHUB_LIST_CODEOWNERS_ERRORS",
        "name": "List codeowners errors",
        "description": "Lists syntax errors in a repository's CODEOWNERS file, which must be located at the root, `.github/`, or `docs/` directory for the specified ref."
      },
      {
        "slug": "GITHUB_LIST_CODEQL_DATABASES_FOR_A_REPOSITORY",
        "name": "List CodeQL databases for a repository",
        "description": "Lists all CodeQL databases for a repository where CodeQL analysis has been previously run and completed."
      },
      {
        "slug": "GITHUB_LIST_CODE_SCANNING_ALERTS_FOR_AN_ORGANIZATION",
        "name": "List code scanning alerts for an organization",
        "description": "Lists code scanning alerts for a GitHub organization; use EITHER `tool_name` OR `tool_guid` if filtering by tool, not both."
      },
      {
        "slug": "GITHUB_LIST_CODE_SCANNING_ALERTS_FOR_A_REPOSITORY",
        "name": "List code scanning alerts for a repository",
        "description": "Lists code scanning alerts for a repository, optionally filtering by tool (which must have produced scan results for the repository), Git reference, state, or severity."
      },
      {
        "slug": "GITHUB_LIST_CODE_SCANNING_ANALYSES_FOR_A_REPOSITORY",
        "name": "List code scanning analyses for a repository",
        "description": "Lists code scanning analyses for an existing repository, optionally filtering by tool (name or GUID), Git reference, or SARIF ID."
      },
      {
        "slug": "GITHUB_LIST_CODES_OF_CONDUCT",
        "name": "Get all codes of conduct",
        "description": "Retrieves all available codes of conduct from GitHub, often used to select one for a repository."
      },
      {
        "slug": "GITHUB_LIST_CODES_OF_CONDUCT_GRAPHQL",
        "name": "List Codes of Conduct (GraphQL)",
        "description": "Tool to fetch all available codes of conduct using GitHub's GraphQL API. Use when you need to retrieve the complete list of codes of conduct that can be applied to repositories."
      },
      {
        "slug": "GITHUB_LIST_CODESPACES_FOR_A_USER_IN_ORGANIZATION",
        "name": "List codespaces for a user in organization",
        "description": "Lists all GitHub Codespaces owned by a specified member of a given organization."
      },
      {
        "slug": "GITHUB_LIST_CODESPACES_FOR_THE_AUTHENTICATED_USER",
        "name": "List codespaces for the authenticated user",
        "description": "Lists GitHub Codespaces for the authenticated user, optionally filtering by repository ID and supporting pagination."
      },
      {
        "slug": "GITHUB_LIST_CODESPACES_FOR_THE_ORGANIZATION",
        "name": "List codespaces for the organization",
        "description": "Lists active/pending GitHub Codespaces for an existing organization; admins list all, members list their own."
      },
      {
        "slug": "GITHUB_LIST_COMMENT_CHANGES",
        "name": "List comment changes across organization",
        "description": "Tool to list issue and PR comment changes across an organization's repositories efficiently. Use when monitoring comment activity without per-PR/per-issue polling. Filters organization events to return only comment-related events (IssueCommentEvent, PullRequestReviewCommentEvent, CommitCommentEvent). Note: Events are limited to the past 30 days and up to 300 events per timeline. Use ETag header for efficient polling to avoid rate limits."
      },
      {
        "slug": "GITHUB_LIST_COMMENTS_FOR_A_PULL_REQUEST_REVIEW",
        "name": "List comments for a pull request review",
        "description": "Lists all comments for a specific review on a GitHub pull request."
      },
      {
        "slug": "GITHUB_LIST_COMMIT_COMMENTS",
        "name": "List commit comments",
        "description": "Retrieves all comments for a specific commit in a GitHub repository, supporting pagination."
      },
      {
        "slug": "GITHUB_LIST_COMMIT_COMMENTS_FOR_A_REPOSITORY",
        "name": "List commit comments for a repository",
        "description": "Lists all commit comments for a specified repository, which must exist and be accessible."
      },
      {
        "slug": "GITHUB_LIST_COMMITS",
        "name": "List commits",
        "description": "Lists commits for a GitHub repository. Requires 'owner' (username/org) and 'repo' (repository name) parameters. Optionally filter by SHA/branch, path, author, committer, or date range."
      },
      {
        "slug": "GITHUB_LIST_COMMITS_ON_A_PULL_REQUEST",
        "name": "List commits on a pull request",
        "description": "Lists commits for a pull request; requires the repository and pull request to exist and be accessible, and supports pagination."
      },
      {
        "slug": "GITHUB_LIST_COMMONLY_USED_LICENSES",
        "name": "Get all commonly used licenses",
        "description": "Retrieves a list of commonly used software licenses from GitHub, optionally filtering for 'featured' licenses whose specific selection criteria by GitHub may vary."
      },
      {
        "slug": "GITHUB_LIST_CUSTOM_PROPERTIES_FOR_AN_ORGANIZATION",
        "name": "Get all custom properties for an organization",
        "description": "Gets the schema definitions for all custom properties configured for an organization, not the specific values assigned to repositories."
      },
      {
        "slug": "GITHUB_LIST_CUSTOM_PROPERTY_VALUES_FOR_A_REPOSITORY",
        "name": "Get all custom property values for a repository",
        "description": "Gets all custom property values for a repository. Custom properties are defined at the organization level, so this endpoint works with organization-owned repositories. Returns an empty array if no custom properties are set."
      },
      {
        "slug": "GITHUB_LIST_CUSTOM_PROPERTY_VALUES_FOR_ORG_REPOS",
        "name": "List custom property values for organization repositories",
        "description": "Lists repositories in an organization with their custom property values. Requires 'Custom properties' organization permission (read)."
      },
      {
        "slug": "GITHUB_LIST_DELIVERIES_FOR_AN_ORGANIZATION_WEBHOOK",
        "name": "List deliveries for an organization webhook",
        "description": "Retrieves a list of webhook deliveries for a specific webhook in an organization, allowing inspection of delivery history and details."
      },
      {
        "slug": "GITHUB_LIST_DELIVERIES_FOR_A_REPOSITORY_WEBHOOK",
        "name": "List deliveries for a repository webhook",
        "description": "Retrieves delivery attempts for a specific repository webhook to inspect its history; ensure the webhook ID exists."
      },
      {
        "slug": "GITHUB_LIST_DEPLOY_KEYS",
        "name": "List deploy keys",
        "description": "Lists deploy SSH keys for a specified repository; the repository must exist."
      },
      {
        "slug": "GITHUB_LIST_DEPLOYMENT_BRANCH_POLICIES",
        "name": "List deployment branch policies",
        "description": "Lists all deployment branch policies for a specified environment in a GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_DEPLOYMENTS",
        "name": "List deployments",
        "description": "Lists deployments for a specified repository; repository must exist."
      },
      {
        "slug": "GITHUB_LIST_DEPLOYMENT_STATUSES",
        "name": "List deployment statuses",
        "description": "Lists all statuses for a given deployment in a repository."
      },
      {
        "slug": "GITHUB_LIST_DISCUSSION_COMMENTS",
        "name": "List discussion comments",
        "description": "Lists all comments for a specific team discussion within an organization. Note: Team discussions are deprecated as of 2023-11-28. Consider using GitHub Discussions instead. This endpoint requires the authenticated user to be a member of the organization and have access to the team's discussions."
      },
      {
        "slug": "GITHUB_LIST_DISCUSSIONS",
        "name": "List discussions",
        "description": "Lists discussions for a specific team within an organization, with options for sorting, pagination, and filtering by pinned status. Note: Team discussions are deprecated as of 2023-11-28. Consider using GitHub Discussions instead. This endpoint requires the authenticated user to be a member of the organization and have access to the team's discussions."
      },
      {
        "slug": "GITHUB_LIST_EMAIL_ADDRESSES_FOR_THE_AUTHENTICATED_USER",
        "name": "List email addresses for the authenticated user",
        "description": "Lists all email addresses for the authenticated user, including their primary status, verification status, and visibility. This action retrieves the complete list of email addresses associated with the authenticated user, providing important details such as which email is primary and whether the emails are verified."
      },
      {
        "slug": "GITHUB_LIST_ENVIRONMENT_CUSTOM_DEPLOYMENT_RULES",
        "name": "List environment custom deployment rules",
        "description": "Lists all custom deployment protection rule integrations for a repository environment; the `environment_name` must be URL-encoded."
      },
      {
        "slug": "GITHUB_LIST_ENVIRONMENTS",
        "name": "List environments",
        "description": "Retrieves all deployment environments for a specified repository, which are used to configure protection rules and secrets for different software lifecycle stages."
      },
      {
        "slug": "GITHUB_LIST_ENVIRONMENT_SECRETS",
        "name": "List environment secrets",
        "description": "Lists the names and metadata (not values) of secrets for a specified, existing environment within an existing GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_ENVIRONMENT_VARIABLES",
        "name": "List environment variables",
        "description": "Lists all environment variables, which are plaintext key-value pairs for GitHub Actions workflows, for a specified environment within a GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_EVENTS_FOR_THE_AUTHENTICATED_USER",
        "name": "List events for the authenticated user",
        "description": "Lists public events for the specified GitHub user, or private events if authenticated as that user, in reverse chronological order."
      },
      {
        "slug": "GITHUB_LIST_EVENTS_FOR_USER",
        "name": "List events for user",
        "description": "Lists events performed by a GitHub user in reverse chronological order. If authenticated as the specified user, you will see private events; otherwise, only public events are returned. Use this action when you need to retrieve a user's activity history, such as commits, pull requests, issues, and other GitHub actions."
      },
      {
        "slug": "GITHUB_LIST_EVENTS_RECEIVED_BY_THE_AUTHENTICATED_USER",
        "name": "List events received by the authenticated user",
        "description": "Lists events a specific GitHub user received from followed users and watched repositories; returns private events if authenticated for `username`, otherwise public."
      },
      {
        "slug": "GITHUB_LIST_FOLLOWERS_OF_A_USER",
        "name": "List followers of a user",
        "description": "Lists followers for a specified, existing GitHub user."
      },
      {
        "slug": "GITHUB_LIST_FOLLOWERS_OF_THE_AUTHENTICATED_USER",
        "name": "List followers of the authenticated user",
        "description": "Lists users following the authenticated GitHub user, returning an empty list if the user has no followers."
      },
      {
        "slug": "GITHUB_LIST_FOLLOWING_FOR_USER",
        "name": "List following for user",
        "description": "Lists the people that a GitHub user follows. Use this action when you need to retrieve the list of users that a specific GitHub user is following. The response includes public profile information for each followed user with pagination support."
      },
      {
        "slug": "GITHUB_LIST_FORKS",
        "name": "List forks",
        "description": "Lists forks for a specified repository, which must exist, with options for sorting and pagination."
      },
      {
        "slug": "GITHUB_LIST_GIST_COMMENTS",
        "name": "List gist comments",
        "description": "Lists comments for a specified GitHub Gist."
      },
      {
        "slug": "GITHUB_LIST_GIST_COMMITS",
        "name": "List gist commits",
        "description": "Lists all commits for a specified gist."
      },
      {
        "slug": "GITHUB_LIST_GIST_FORKS",
        "name": "List gist forks",
        "description": "Lists all forks for a given GitHub gist ID."
      },
      {
        "slug": "GITHUB_LIST_GISTS_FOR_A_USER",
        "name": "List gists for a user",
        "description": "_lists public gists for a specified GitHub user._"
      },
      {
        "slug": "GITHUB_LIST_GISTS_FOR_THE_AUTHENTICATED_USER",
        "name": "List gists for the authenticated user",
        "description": "Lists gists for the authenticated user, with optional filtering by update time and pagination."
      },
      {
        "slug": "GITHUB_LIST_GITHUB_ACTIONS_CACHES_FOR_A_REPOSITORY",
        "name": "List github actions caches for a repository",
        "description": "Lists GitHub Actions caches for a repository, with options to filter by Git reference or cache key, and to sort and paginate results."
      },
      {
        "slug": "GITHUB_LIST_GITHUB_PAGES_BUILDS",
        "name": "List GitHub Pages builds",
        "description": "Lists GitHub Pages builds for a repository; GitHub Pages must be enabled on the repository for builds to be listed."
      },
      {
        "slug": "GITHUB_LIST_GITIGNORE_TEMPLATES",
        "name": "Get all gitignore templates",
        "description": "Retrieves all available .gitignore template names from GitHub (e.g., 'Python', 'Node', 'Java'), used for generating .gitignore files."
      },
      {
        "slug": "GITHUB_LIST_GLOBAL_SECURITY_ADVISORIES",
        "name": "List global security advisories",
        "description": "Lists GitHub's global security advisories, filterable by various attributes including ID, type, ecosystem, severity, and dates."
      },
      {
        "slug": "GITHUB_LIST_GPG_KEYS_FOR_A_USER",
        "name": "List GPG keys for a user",
        "description": "Tool to list GPG keys for a GitHub user. Use when you need to fetch the public GPG keys associated with a specific GitHub user account."
      },
      {
        "slug": "GITHUB_LIST_INSTALLATION_REQUESTS_FOR_THE_AUTHENTICATED_APP",
        "name": "List installation requests for the authenticated app",
        "description": "Lists pending installation requests made by users or organizations for the authenticated GitHub App."
      },
      {
        "slug": "GITHUB_LIST_INSTANCES_OF_A_CODE_SCANNING_ALERT",
        "name": "List instances of a code scanning alert",
        "description": "Lists all instances of a specific code scanning alert, optionally filtered by Git ref; requires code scanning to be enabled on the repository."
      },
      {
        "slug": "GITHUB_LIST_ISSUE_COMMENTS",
        "name": "List issue comments",
        "description": "Lists comments for a specified issue in a GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_ISSUE_COMMENTS_FOR_A_REPOSITORY",
        "name": "List issue comments for a repository",
        "description": "Lists issue comments, including those on pull requests, for an accessible repository."
      },
      {
        "slug": "GITHUB_LIST_ISSUE_DEPENDENCIES_BLOCKED_BY",
        "name": "List issue dependencies blocked by",
        "description": "Tool to list dependencies an issue is blocked by. Use when you need to retrieve all issues that are blocking a specific issue from being closed or completed."
      },
      {
        "slug": "GITHUB_LIST_ISSUE_DEPENDENCIES_BLOCKING",
        "name": "List issue dependencies blocking",
        "description": "Tool to list dependencies an issue is blocking. Use when you need to see which issues are blocked by a specific issue."
      },
      {
        "slug": "GITHUB_LIST_ISSUE_EVENTS",
        "name": "List issue events",
        "description": "Retrieves a list of all events for a specific issue within a GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_ISSUE_EVENTS_FOR_A_REPOSITORY",
        "name": "List issue events for a repository",
        "description": "Lists all issue events (e.g., closed, reopened, assigned) for a specified repository."
      },
      {
        "slug": "GITHUB_LIST_ISSUES_ASSIGNED_TO_THE_AUTHENTICATED_USER",
        "name": "List issues for user",
        "description": "Lists GitHub issues for the authenticated user across visible repositories, with filtering by user relationship, state, labels, an ISO 8601 `since` timestamp (YYYY-MM-DDTHH:MM:SSZ), and sorting options; pull requests are typically included."
      },
      {
        "slug": "GITHUB_LIST_ISSUE_TYPES",
        "name": "List issue types",
        "description": "List all issue types configured for a GitHub organization. Requires read:org scope for OAuth tokens."
      },
      {
        "slug": "GITHUB_LIST_JOBS_FOR_A_WORKFLOW_RUN",
        "name": "List jobs for a workflow run",
        "description": "Lists jobs for a specific workflow run in a GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_JOBS_FOR_A_WORKFLOW_RUN_ATTEMPT",
        "name": "List jobs for a workflow run attempt",
        "description": "Lists jobs, including details like ID, status, and steps, for a specific attempt of a GitHub Actions workflow run."
      },
      {
        "slug": "GITHUB_LIST_LABELS_FOR_AN_ISSUE",
        "name": "List labels for an issue",
        "description": "Lists all labels for a specified issue in a GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_LABELS_FOR_A_REPOSITORY",
        "name": "List labels for a repository",
        "description": "Retrieves all labels for a specified, existing GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_LABELS_FOR_A_SELF_HOSTED_RUNNER_FOR_A_REPOSITORY",
        "name": "List labels for a self-hosted runner for a repository",
        "description": "Lists all labels assigned to a specific self-hosted runner registered with the given repository."
      },
      {
        "slug": "GITHUB_LIST_LABELS_FOR_ISSUES_IN_A_MILESTONE",
        "name": "List labels for issues in a milestone",
        "description": "Lists all labels for issues within a specific milestone in a repository."
      },
      {
        "slug": "GITHUB_LIST_LABELS_FOR_SELF_HOSTED_RUNNER_ORG",
        "name": "List labels for a self-hosted runner for an organization",
        "description": "Lists all labels assigned to a specific self-hosted runner within a GitHub organization, which are used to route workflows."
      },
      {
        "slug": "GITHUB_LIST_LICENSES_GRAPH_QL",
        "name": "List Licenses (GraphQL)",
        "description": "Tool to fetch all known open source licenses using GitHub's GraphQL API. Use when you need to retrieve the complete list of licenses that can be applied to repositories."
      },
      {
        "slug": "GITHUB_LIST_MACHINE_TYPES_FOR_A_CODESPACE",
        "name": "List machine types for a codespace",
        "description": "Lists available machine types for a specific, accessible codespace, enabling it to be transitioned to a new hardware configuration."
      },
      {
        "slug": "GITHUB_LIST_MATCHING_REFERENCES",
        "name": "List matching references",
        "description": "Lists all Git references (branches or tags) in a repository that start with the provided partial reference path (e.g., `heads/my-feature` or `tags/v1.2`)."
      },
      {
        "slug": "GITHUB_LIST_MILESTONES",
        "name": "List milestones",
        "description": "Lists milestones, which track progress for groups of issues and pull requests, for an existing repository, allowing filtering by state and sorting."
      },
      {
        "slug": "GITHUB_LIST_NOTIFICATIONS",
        "name": "List notifications for authenticated user",
        "description": "Tool to list notification threads for the authenticated user with efficient polling support. Use when you need to fetch the user's GitHub notification inbox with filters like unread/participating/since. Returns notification threads plus polling headers (Last-Modified, ETag, X-Poll-Interval) for efficient polling. IMPORTANT: This endpoint requires a Personal Access Token (classic) with 'notifications' or 'repo' scope. It does NOT work with GitHub App tokens or fine-grained personal access tokens. If the token type is incompatible, a clear error message will be returned."
      },
      {
        "slug": "GITHUB_LIST_NOTIFICATIONS_FOR_THE_AUTHENTICATED_USER",
        "name": "List notifications for the authenticated user (Deprecated)",
        "description": "DEPRECATED: Use GITHUB_LIST_NOTIFICATIONS instead. Lists notifications for the authenticated user, sorted by most recent update, with filtering and pagination options."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATION_CODESPACES_SECRETS",
        "name": "List org level codespaces secrets",
        "description": "Lists all Codespaces secrets available for a specified organization, which must exist."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATION_EVENTS_FOR_THE_AUTHENTICATED_USER",
        "name": "List organization events for the authenticated user",
        "description": "Lists public events in a specified GitHub organization for the authenticated user's organization dashboard. Returns activities like repository pushes, pull requests, issues, forks, and other public events within the organization. The authenticated user must be a member of the organization to see events."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATION_MEMBERS",
        "name": "List organization members",
        "description": "Tool to list all members of a GitHub organization. Returns a list of users who are members of the specified organization. Use this action when you need to retrieve the list of members in an organization, optionally filtered by role (admin/member) or two-factor authentication status. Organization owners can filter by 2FA status to identify members who need to enable or upgrade their 2FA methods."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATION_MEMBERSHIPS_FOR_THE_AUTHENTICATED_U",
        "name": "List organization memberships for authenticated user",
        "description": "List organization memberships for authenticated user"
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATION_PROJECTS",
        "name": "List organization projects",
        "description": "Lists projects (V2) for a specified GitHub organization, with optional search query and cursor-based pagination."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATION_REPOSITORIES",
        "name": "List organization repositories",
        "description": "Retrieves a list of repositories for a specified GitHub organization, allowing filtering by type and sorting."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATION_ROLES_FOR_AN_ORGANIZATION",
        "name": "Get all organization roles for an organization",
        "description": "Lists all custom organization roles for an existing GitHub organization."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATIONS",
        "name": "List organizations",
        "description": "Lists GitHub organizations for the authenticated user, sorted by ID in ascending order."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATION_SECRETS",
        "name": "List organization secrets",
        "description": "Lists GitHub Actions secrets available for a specified organization."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATIONS_FOR_A_USER",
        "name": "List organizations for a user",
        "description": "Lists public organizations for a specified GitHub user; the `username` must be a valid GitHub handle."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATIONS_FOR_THE_AUTHENTICATED_USER",
        "name": "List organizations for the authenticated user",
        "description": "Lists organizations the authenticated GitHub user is a member of, returning details for each organization."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATIONS_FOR_USER",
        "name": "List organizations for a user",
        "description": "List public organization memberships for a GitHub user. This returns all organizations where the specified user is a public member. Use this action when you need to discover which organizations a user publicly belongs to."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATION_VARIABLES",
        "name": "List organization variables",
        "description": "Lists all GitHub Actions variables for a specified organization."
      },
      {
        "slug": "GITHUB_LIST_ORGANIZATION_WEBHOOKS",
        "name": "List organization webhooks",
        "description": "Lists all webhooks for a specified GitHub organization; the organization must exist."
      },
      {
        "slug": "GITHUB_LIST_ORG_FINE_GRAINED_PERMISSIONS",
        "name": "List organization fine-grained permissions",
        "description": "Lists all fine-grained permissions available in a GitHub organization for use in custom organization roles. These permissions define granular access controls that can be combined when creating custom roles. Note: This endpoint requires GitHub Enterprise Cloud with the custom organization roles feature enabled. The authenticated user must be an administrator or have the 'read_organization_custom_org_role' permission."
      },
      {
        "slug": "GITHUB_LIST_ORG_ISSUES_FOR_THE_AUTHENTICATED_USER",
        "name": "List organization issues assigned to the authenticated user",
        "description": "Lists issues for the authenticated user within a specified GitHub organization, with options to filter by involvement type, state, labels, and to sort results."
      },
      {
        "slug": "GITHUB_LIST_ORG_PACKAGE_VERSIONS",
        "name": "List package versions for an organization package",
        "description": "Lists all versions for a specified package, if it exists and is owned by the given GitHub organization."
      },
      {
        "slug": "GITHUB_LIST_ORG_PROJECT_VIEW_ITEMS",
        "name": "List organization project view items",
        "description": "Tool to list items for an organization project view. Use when you need to retrieve all items from a specific view within a GitHub organization's Projects V2 project. Returns a list of project items with their content, metadata, and field values."
      },
      {
        "slug": "GITHUB_LIST_ORG_REPOS_WITH_GITHUB_ACTIONS_ENABLED",
        "name": "List organization repositories with Github Actions enabled",
        "description": "Lists the selected repositories that are enabled for GitHub Actions in an organization. This endpoint only returns results when the organization's 'enabled_repositories' permission policy is configured to 'selected'. Requires admin:org scope and organization admin permissions."
      },
      {
        "slug": "GITHUB_LIST_ORG_RESOURCE_ACCESS_TOKENS",
        "name": "List org resource access tokens",
        "description": "Lists approved fine-grained personal access tokens (PATs) with access to resources in a GitHub organization, optionally filtering by owner, repository, permissions, or last usage time. AUTHENTICATION REQUIREMENT: This endpoint requires GitHub App authentication with 'Personal access tokens' organization permissions (read). Standard personal access tokens CANNOT use this endpoint. The GitHub App must also have access to the organization."
      },
      {
        "slug": "GITHUB_LIST_ORG_RESOURCES_WITH_PERSONAL_TOKENS",
        "name": "List org resources with personal tokens",
        "description": "Lists requests from organization members to access organization resources with fine-grained personal access tokens (pending, approved, or denied). Note: This endpoint requires GitHub App authentication with 'organization_personal_access_token_requests:read' permissions; it cannot be used with personal access tokens."
      },
      {
        "slug": "GITHUB_LIST_ORG_SECRETS_WITHOUT_VALUES",
        "name": "List organization Dependabot secrets without values",
        "description": "Lists all Dependabot secrets (metadata like names, creation/update timestamps, but not their encrypted values) for a specified organization, which must exist."
      },
      {
        "slug": "GITHUB_LIST_OUTSIDE_COLLABORATORS_FOR_AN_ORGANIZATION",
        "name": "List outside collaborators for an organization",
        "description": "Lists outside collaborators for a GitHub organization, with options to filter (e.g., by 2FA status) and paginate results."
      },
      {
        "slug": "GITHUB_LIST_OWNED_PACKAGE_VERSIONS",
        "name": "List owned package versions",
        "description": "Lists all versions for an existing package owned by the authenticated user, identified by its type and name."
      },
      {
        "slug": "GITHUB_LIST_PACKAGES_FOR_AN_ORGANIZATION",
        "name": "List packages for an organization",
        "description": "Lists GitHub Packages for an organization, noting specific interpretations for package_type and visibility parameters."
      },
      {
        "slug": "GITHUB_LIST_PACKAGES_FOR_A_USER",
        "name": "List packages for a user",
        "description": "Lists packages for a specified GitHub user, filterable by package type and visibility."
      },
      {
        "slug": "GITHUB_LIST_PACKAGES_FOR_THE_AUTHENTICATED_USER",
        "name": "List packages for the authenticated user's namespace",
        "description": "Lists packages of a specific type and visibility within the authenticated user's namespace on GitHub."
      },
      {
        "slug": "GITHUB_LIST_PACKAGE_VERSIONS_FOR_A_PACKAGE_OWNED_BY_A_USER",
        "name": "List package versions for a package owned by a user",
        "description": "Lists all versions of a public package owned by a specific GitHub user, identified by package type, package name, and username."
      },
      {
        "slug": "GITHUB_LIST_PENDING_TEAM_INVITATIONS",
        "name": "List pending team invitations",
        "description": "Lists all pending membership invitations for a specified team within an organization. The authenticated user must be an organization member with the read:org scope. The response includes invitation details such as the invitee's login/email, the role they're being invited to, and who sent the invitation. The 'role' field indicates the type of invitation: - 'direct_member': Regular organization member - 'admin': Organization administrator - 'billing_manager': Billing manager role - 'hiring_manager': Hiring manager role - 'reinstate': Reinstating a previous member Note: If the invitee is not a GitHub member, the 'login' field will be null and only the 'email' field will be populated."
      },
      {
        "slug": "GITHUB_LIST_PROJECT_CARDS",
        "name": "List project cards (Classic - Deprecated)",
        "description": "Lists all project cards for a given column_id in GitHub Projects (classic). DEPRECATION NOTICE: GitHub Projects (classic) and its REST API were sunset on April 1, 2025. This action will return 404 for most requests on GitHub.com. However, it may still work on GitHub Enterprise Server instances where classic projects are enabled. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/ Returns a list of project cards including: id, node_id, url, note (or null for linked cards), creator info, content_url (for issue/PR cards), column_url, project_url, timestamps, and archived status."
      },
      {
        "slug": "GITHUB_LIST_PROJECT_COLLABORATORS",
        "name": "List project collaborators (classic)",
        "description": "Lists collaborators for a GitHub Project (classic) by project ID. IMPORTANT: This action uses the Projects (classic) REST API which was sunset on April 1, 2025 for GitHub.com. The API may still be available on GitHub Enterprise Server versions before 3.17. For GitHub.com users: GitHub Projects (classic) has been replaced by the new Projects experience. The new Projects does not have a REST API for listing collaborators - use the GitHub web interface to manage project collaborators instead. You must be an organization owner or a project admin to list collaborators."
      },
      {
        "slug": "GITHUB_LIST_PROJECT_COLUMNS",
        "name": "List project columns",
        "description": "Lists all of a GitHub project's columns (e.g., 'To Do', 'In Progress'); project_id must identify a valid, accessible project. Note: This action uses GitHub's Projects (classic) REST API. The Projects (classic) API was sunset on April 1, 2025. This action will return an empty columns list with an informative message for projects that no longer exist or when the API returns 404."
      },
      {
        "slug": "GITHUB_LIST_PROJECT_FIELDS_FOR_USER",
        "name": "List project fields for user",
        "description": "Tool to list all fields in a GitHub Projects V2 project for a specific user. Use when you need to see available fields in a project."
      },
      {
        "slug": "GITHUB_LIST_PROJECT_ITEMS_FOR_USER",
        "name": "List project items for user",
        "description": "Tool to list items for a user-owned GitHub project. Use when you need to retrieve all items (issues, pull requests, draft issues) from a specific project belonging to a user."
      },
      {
        "slug": "GITHUB_LIST_PROJECT_VIEW_ITEMS_FOR_USER",
        "name": "List items for user project view",
        "description": "Tool to list items for a user's GitHub Projects (v2) view. Use when you need to retrieve items from a specific view of a user's project. Supports pagination and field filtering."
      },
      {
        "slug": "GITHUB_LIST_PUBLIC_EMAILS_FOR_AUTH_USER",
        "name": "List public email addresses for the authenticated user",
        "description": "Lists the public email addresses for the authenticated user."
      },
      {
        "slug": "GITHUB_LIST_PUBLIC_EVENTS",
        "name": "List public events",
        "description": "Lists public GitHub events, which may be delayed by up to 5 minutes, with support for pagination."
      },
      {
        "slug": "GITHUB_LIST_PUBLIC_EVENTS_FOR_A_NETWORK_OF_REPOSITORIES",
        "name": "List public events for a network of repositories",
        "description": "Retrieves public events (up to 90 days old, newest first) for a GitHub repository network, including the repository and its forks."
      },
      {
        "slug": "GITHUB_LIST_PUBLIC_EVENTS_FOR_A_USER",
        "name": "List public events for a user",
        "description": "Retrieves a list of public events for a specified GitHub user, in reverse chronological order."
      },
      {
        "slug": "GITHUB_LIST_PUBLIC_EVENTS_RECEIVED_BY_A_USER",
        "name": "List public events received by a user",
        "description": "Lists public events for a specified GitHub user (e.g., activities in repositories they watch or are involved in); the target user's profile must be public, and if blocked by the authenticated user, a 404 error is returned."
      },
      {
        "slug": "GITHUB_LIST_PUBLIC_GISTS",
        "name": "List public gists",
        "description": "Lists public gists from GitHub, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first."
      },
      {
        "slug": "GITHUB_LIST_PUBLIC_KEYS_FOR_A_USER",
        "name": "List public keys for a user",
        "description": "Lists the verified public SSH keys for a specified GitHub user."
      },
      {
        "slug": "GITHUB_LIST_PUBLIC_ORGANIZATION_EVENTS",
        "name": "List public organization events",
        "description": "Lists public events for a specified GitHub organization, which must exist. This action retrieves the events that are publicly accessible for the organization specified. It returns a paginated list of events with details about each event."
      },
      {
        "slug": "GITHUB_LIST_PUBLIC_ORGANIZATION_MEMBERS",
        "name": "List public organization members",
        "description": "Lists users who have publicly declared their membership in a specified, existing GitHub organization."
      },
      {
        "slug": "GITHUB_LIST_PUBLIC_REPOSITORIES",
        "name": "List public repositories",
        "description": "Lists all public repositories on GitHub; use the `since` parameter with a repository ID from a previous result for pagination."
      },
      {
        "slug": "GITHUB_LIST_PULL_REQUESTS",
        "name": "List pull requests",
        "description": "Lists pull requests for a GitHub repository. REQUIRES 'owner' AND 'repo' parameters - both are MANDATORY and must be provided in every call. Does NOT support filtering by assignee or date range - use GITHUB_FIND_PULL_REQUESTS instead for searching PRs by assignee, author, or across multiple repositories."
      },
      {
        "slug": "GITHUB_LIST_PULL_REQUESTS_ASSOCIATED_WITH_A_COMMIT",
        "name": "List pull requests associated with a commit",
        "description": "Lists pull requests for a commit; returns merged PRs that introduced the commit if on the default branch, or open PRs including the commit if on other branches."
      },
      {
        "slug": "GITHUB_LIST_PULL_REQUESTS_FILES",
        "name": "List pull requests files",
        "description": "Lists all files (including additions, modifications, and removals) associated with a specific pull request in a GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_REACTIONS_FOR_A_COMMIT_COMMENT",
        "name": "List reactions for a commit comment",
        "description": "Lists reactions for a specific commit comment; this is a read-only operation."
      },
      {
        "slug": "GITHUB_LIST_REACTIONS_FOR_AN_ISSUE",
        "name": "List reactions for an issue",
        "description": "Lists reactions for a specific, existing issue within an accessible GitHub repository, optionally filtering by content type."
      },
      {
        "slug": "GITHUB_LIST_REACTIONS_FOR_AN_ISSUE_COMMENT",
        "name": "List reactions for an issue comment",
        "description": "Lists reactions for a specific issue comment in a GitHub repository, optionally filtering by content type."
      },
      {
        "slug": "GITHUB_LIST_REACTIONS_FOR_A_PULL_REQUEST_REVIEW_COMMENT",
        "name": "List reactions for a pull request review comment",
        "description": "Lists reactions for a pull request review comment in a repository, optionally filtering by reaction type."
      },
      {
        "slug": "GITHUB_LIST_REACTIONS_FOR_A_RELEASE",
        "name": "List reactions for a release",
        "description": "Lists all reactions, or optionally filters reactions by a specific content type, for a given GitHub release."
      },
      {
        "slug": "GITHUB_LIST_REACTIONS_FOR_A_TEAM_DISCUSSION",
        "name": "List reactions for a team discussion",
        "description": "Lists reactions for an existing team discussion within an organization. This endpoint allows you to retrieve all reactions (emoji responses) made to a specific team discussion. You can optionally filter by reaction type. Note: OAuth app tokens and personal access tokens (classic) need the `read:discussion` scope to use this endpoint."
      },
      {
        "slug": "GITHUB_LIST_REACTIONS_FOR_A_TEAM_DISCUSSION_COMMENT",
        "name": "List reactions for a team discussion comment",
        "description": "Lists reactions for a specific comment in a team discussion within an organization, optionally filtering by content type."
      },
      {
        "slug": "GITHUB_LIST_RELEASE_ASSETS",
        "name": "List release assets",
        "description": "Lists assets (e.g., compiled binaries, source code archives) for a specific GitHub release, identified by `release_id` which must be valid for an existing release in the repository."
      },
      {
        "slug": "GITHUB_LIST_RELEASES",
        "name": "List releases",
        "description": "Retrieves a list of all releases (published, draft, and prerelease) for a specified repository."
      },
      {
        "slug": "GITHUB_LIST_REPO_ACCESS_BY_TOKEN",
        "name": "List repo access by token",
        "description": "Lists repositories in an organization that a fine-grained personal access token has requested access to. Only GitHub Apps can use this endpoint. Requires 'Personal access token requests' organization permissions (read)."
      },
      {
        "slug": "GITHUB_LIST_REPO_CODESPACES",
        "name": "List repo codespaces for authenticated user",
        "description": "Lists Codespaces the authenticated user can access within a specified, existing repository."
      },
      {
        "slug": "GITHUB_LIST_REPO_DEV_CONTAINER_CONFIGS_FOR_USER",
        "name": "List repo dev container configs for user",
        "description": "Lists the `devcontainer.json` configurations available in a specified repository for use with GitHub Codespaces."
      },
      {
        "slug": "GITHUB_LIST_REPO_INVITATIONS_FOR_AUTH_USER",
        "name": "List authenticated user's repository invitations",
        "description": "Lists all pending repository invitations for the authenticated user."
      },
      {
        "slug": "GITHUB_LIST_REPO_NOTIFICATIONS_FOR_AUTH_USER",
        "name": "List repository notifications for the authenticated user",
        "description": "Retrieves notifications for the authenticated user from a specified repository, to which the user must have access."
      },
      {
        "slug": "GITHUB_LIST_REPO_SECRETS_WITHOUT_VALUES",
        "name": "List repo secrets without values",
        "description": "Lists all Codespaces secrets available in a specific repository, without their encrypted values."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORIES",
        "name": "List repositories",
        "description": "Lists repositories accessible to the authenticated user based on visibility, affiliation, and type filters. Returns repositories owned by the user, those they collaborate on, or those accessible through organization membership. Use this action when you need to retrieve a comprehensive list of repositories the authenticated user can access, with options to filter by visibility (public/private), affiliation (owner/collaborator/organization), or type. Supports pagination for large result sets."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORIES_ACCESSIBLE_TO_THE_APP_INSTALLATION",
        "name": "List repos accessible to app installation",
        "description": "Lists repositories a GitHub App installation can access. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs_* prefix) for authentication. OAuth/user access tokens (gho_*) or personal access tokens are not supported and will result in a 403 Forbidden error. Returns 'total_count' and 'repositories' array with pagination support."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORIES_FOR_A_USER",
        "name": "List repositories for a user",
        "description": "Lists public repositories for a specified GitHub user, who must have an existing account."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORIES_FOR_THE_AUTHENTICATED_USER",
        "name": "List repositories for the authenticated user",
        "description": "Lists repositories for the authenticated user; using 'type' with 'visibility' or 'affiliation' API parameters (not in this model) can cause a 422 error."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORIES_STARRED_BY_A_USER",
        "name": "List repositories starred by a user",
        "description": "Lists repositories a valid and existing GitHub user has starred."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORIES_STARRED_BY_THE_AUTHENTICATED_USER",
        "name": "List repositories starred by the authenticated user",
        "description": "Lists repositories the authenticated user has starred, optionally sorted and paginated, including star creation timestamps via 'application/vnd.github.star+json' media type."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORIES_WATCHED_BY_A_USER",
        "name": "List repositories watched by a user",
        "description": "Lists repositories a given GitHub user is watching; the username must be a valid and existing GitHub user handle."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORIES_WATCHED_BY_THE_AUTHENTICATED_USER",
        "name": "List repositories watched by the authenticated user",
        "description": "Lists repositories the authenticated user is watching (subscribed to for notifications). This action retrieves a list of repositories that the authenticated user is currently watching. It allows the user to manage their watched repositories effectively."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORIES_WITH_GITHUB_ACTIONS_CACHE_USAGE",
        "name": "List repos with ghactions cache usage",
        "description": "Retrieves a paginated list of GitHub Actions cache usage statistics for repositories within an existing GitHub organization."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_ACTIVITIES",
        "name": "List repository activities",
        "description": "Lists activities for a GitHub repository, ensuring the repository exists and is accessible."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_AUTOLINKS",
        "name": "Get all autolinks of a repository",
        "description": "Retrieves all autolinks (e.g., for JIRA issues) configured for a repository; requires admin permissions on the repository."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_COLLABORATORS",
        "name": "List repository collaborators",
        "description": "Lists collaborators for a specified repository, provided it exists and is accessible to the authenticated user."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_CONTRIBUTORS",
        "name": "List repository contributors",
        "description": "Lists contributors to a specified repository, sorted by number of contributions in descending order; the repository must exist and be accessible."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_EVENTS",
        "name": "List repository events",
        "description": "Lists chronological events (e.g., code pushes, issue activities, PR actions, forks) for a specified, existing GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_INVITATIONS",
        "name": "List repository invitations",
        "description": "Retrieves all pending (unaccepted or undeclined) collaboration invitations for a specified GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_ISSUES",
        "name": "List repository issues",
        "description": "Lists issues (including pull requests) from a GitHub repository. Requires BOTH 'owner' AND 'repo' parameters (e.g., owner='octocat', repo='Hello-World' for github.com/octocat/Hello-World)."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_LANGUAGES",
        "name": "List repository languages",
        "description": "Lists the programming languages used in a GitHub repository, returning a byte count for each language."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_ORGANIZATION_SECRETS",
        "name": "List repository organization secrets",
        "description": "Lists names of organization-level secrets shared with the specified repository; actual secret values are not returned and visibility depends on token access."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_ORGANIZATION_VARIABLES",
        "name": "List repository organization variables",
        "description": "Lists organization-level variables that are shared with a specific repository. The repository must belong to an organization (not a personal account)."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_PROJECTS",
        "name": "List repository projects",
        "description": "Lists Projects (classic) associated with a specific repository. Note: This action lists GitHub Projects (classic), which is GitHub's legacy project management feature. If the repository has Projects (classic) disabled or uses the newer Projects V2, this will return an empty list. Most modern repositories use Projects V2 (GraphQL API) instead of Projects (classic)."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_RULESETS",
        "name": "Get all repository rulesets",
        "description": "Retrieves all rulesets for a GitHub repository, which define conditions and actions for repository interactions (e.g., branch protections)."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_RULE_SUITES",
        "name": "List repository rule suites",
        "description": "Lists rule suite evaluations for a repository, allowing filtering by ref (non-wildcard), time period, actor, and result."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_SECRETS",
        "name": "List repository secrets",
        "description": "Lists metadata for all secrets in a GitHub repository, excluding their encrypted values."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_SECRETS_WITHOUT_DECRYPTING",
        "name": "List repository secrets without decrypting",
        "description": "Lists metadata (e.g., name, creation/update dates) for all Dependabot secrets in a repository; secret values are not included."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_SECURITY_ADVISORIES",
        "name": "List repository security advisories",
        "description": "Tool to list security advisories for a repository. Use when you need to retrieve security advisories published for a specific repository, optionally filtered by state."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_TAGS",
        "name": "List repository tags",
        "description": "Lists tags for a specified GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_TEAMS",
        "name": "List repository teams",
        "description": "Lists all teams with explicit permission to access the specified repository; the repository must exist."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_TOPICS",
        "name": "Get all repository topics",
        "description": "Retrieves all topics for a specified, existing, and accessible repository."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_VARIABLES",
        "name": "List repository variables",
        "description": "Lists plain text key-value variables for GitHub Actions workflows within a specific, accessible repository."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_WEBHOOKS",
        "name": "List repository webhooks",
        "description": "Retrieves a list of webhooks for a repository, which must exist and be accessible."
      },
      {
        "slug": "GITHUB_LIST_REPOSITORY_WORKFLOWS",
        "name": "List repository workflows",
        "description": "Lists all GitHub Actions workflows for a specified repository, which must exist and be accessible."
      },
      {
        "slug": "GITHUB_LIST_REQUESTED_REVIEWERS_FOR_A_PULL_REQUEST",
        "name": "Get all requested reviewers for a pull request",
        "description": "Gets all users and teams requested to review a specific pull request in a repository."
      },
      {
        "slug": "GITHUB_LIST_REVIEW_COMMENTS_IN_A_REPOSITORY",
        "name": "List review comments in a repository",
        "description": "Lists all review comments on all pull requests within a specified repository."
      },
      {
        "slug": "GITHUB_LIST_REVIEW_COMMENTS_ON_A_PULL_REQUEST",
        "name": "List review comments on a pull request",
        "description": "Lists all review comments on a specific pull request within a GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_REVIEWS_FOR_A_PULL_REQUEST",
        "name": "List reviews for a pull request",
        "description": "Lists submitted reviews chronologically for a specific pull request within a GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_RUNNER_APPLICATIONS_FOR_AN_ORGANIZATION",
        "name": "List runner applications for an organization",
        "description": "Lists downloadable GitHub Actions runner application binaries for setting up self-hosted runners in a GitHub organization. Returns download URLs and checksums for various OS/architecture combinations (linux/win/osx on x64/arm/arm64). Requires admin:org scope or fine-grained 'Self-hosted runners' read permission."
      },
      {
        "slug": "GITHUB_LIST_RUNNER_APPLICATIONS_FOR_A_REPOSITORY",
        "name": "List runner applications for a repository",
        "description": "Lists available self-hosted runner application binaries for a specific repository, including their OS, architecture, and download URL."
      },
      {
        "slug": "GITHUB_LIST_SECRET_SCANNING_ALERTS_FOR_A_REPOSITORY",
        "name": "List secret scanning alerts for a repository",
        "description": "List secret scanning alerts for a GitHub repository using first-party detections. Use this to retrieve detected secrets with filtering by state, type, resolution, and validity. Supports optional hiding of secret literals for security."
      },
      {
        "slug": "GITHUB_LIST_SECRETS_FOR_THE_AUTHENTICATED_USER",
        "name": "List secrets for the authenticated user",
        "description": "Lists all Codespaces secrets accessible to the authenticated user for use within GitHub Codespaces."
      },
      {
        "slug": "GITHUB_LIST_SECURITY_ADVISORIES_GRAPHQL",
        "name": "List security advisories (GraphQL)",
        "description": "Tool to list GitHub Security Advisories using the GraphQL API. Use when you need to query security vulnerabilities and malware advisories from the GitHub Advisory Database with advanced filtering and pagination options."
      },
      {
        "slug": "GITHUB_LIST_SECURITY_VULNERABILITIES",
        "name": "List security vulnerabilities",
        "description": "Query software vulnerabilities documented by GitHub Security Advisories using GraphQL. Use this to find security issues in packages across ecosystems like npm, pip, maven, etc."
      },
      {
        "slug": "GITHUB_LIST_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_SECRET",
        "name": "List selected repositories for a Codespaces organization secret",
        "description": "Lists repositories that have been granted access to a Codespaces organization secret. Returns all repositories that have been selected when the visibility for repository access to a Codespaces secret is set to 'selected'. Requires admin:org scope and admin access to the organization. Note: This endpoint only returns results when the secret's visibility is set to 'selected'. Secrets with visibility 'all' or 'private' do not have specific repository selections."
      },
      {
        "slug": "GITHUB_LIST_SELECTED_REPOSITORIES_FOR_A_USER_SECRET",
        "name": "List selected repositories for a user secret",
        "description": "Lists repositories that have access to the specified user Codespaces secret. This endpoint retrieves all repositories that the authenticated user has granted access to for a specific user-level Codespaces secret. The secret must already exist for this endpoint to work. Use 'list_secrets_for_the_authenticated_user' to discover available secrets first. Note: The authenticated user must have Codespaces access enabled. OAuth tokens and personal access tokens require the 'codespace' or 'codespace:secrets' scope."
      },
      {
        "slug": "GITHUB_LIST_SELECTED_REPOSITORIES_FOR_SECRET_ACCESS",
        "name": "List selected repos for secret access",
        "description": "Lists repositories within a specified organization that have been granted access to a particular Dependabot secret. Note: This endpoint only returns results when the secret's visibility is set to 'selected'. Secrets with visibility 'all' or 'private' do not have specific repository selections. Requires 'admin:org' scope and the user must have admin access to the organization."
      },
      {
        "slug": "GITHUB_LIST_SELECTED_REPOS_ORG_VARIABLE",
        "name": "List selected repositories for an organization variable",
        "description": "Lists repositories in an organization that can access a specific organization variable; supports pagination and returns an empty list if no repositories have been granted access. Note: This endpoint only works for variables with visibility set to 'selected' - attempting to use it on variables with 'all' or 'private' visibility will result in a 409 Conflict error."
      },
      {
        "slug": "GITHUB_LIST_SELF_HOSTED_RUNNERS_FOR_AN_ORGANIZATION",
        "name": "List self hosted runners for an organization",
        "description": "Lists self-hosted runners for a GitHub organization, optionally filtering by name and paginating results, providing details for each runner such as OS, status, and labels."
      },
      {
        "slug": "GITHUB_LIST_SELF_HOSTED_RUNNERS_FOR_A_REPOSITORY",
        "name": "List self hosted runners for a repository",
        "description": "Lists all self-hosted runners configured for a repository."
      },
      {
        "slug": "GITHUB_LIST_SOCIAL_ACCOUNTS_FOR_A_USER",
        "name": "List social accounts for a user",
        "description": "Lists social media accounts publicly linked to an existing GitHub user's profile."
      },
      {
        "slug": "GITHUB_LIST_SOCIAL_ACCOUNTS_FOR_THE_AUTHENTICATED_USER",
        "name": "List social accounts for the authenticated user",
        "description": "Lists all social media accounts linked to the authenticated user's GitHub profile. This action retrieves the social media accounts associated with the user's GitHub profile, allowing for easy management and visibility of connected accounts. The results include accounts such as Twitter, LinkedIn, and other platforms linked to the GitHub profile."
      },
      {
        "slug": "GITHUB_LIST_SPONSORABLES",
        "name": "List Sponsorable Users and Organizations",
        "description": "Tool to list users and organizations who can be sponsored via GitHub Sponsors. Use when you need to discover sponsorable entities with optional filtering by dependency ecosystem."
      },
      {
        "slug": "GITHUB_LIST_SSH_SIGNING_KEYS_FOR_A_USER",
        "name": "List SSH signing keys for user",
        "description": "Lists the public SSH signing keys for a specified GitHub user."
      },
      {
        "slug": "GITHUB_LIST_STARGAZERS",
        "name": "List stargazers",
        "description": "Lists users who have starred the specified GitHub repository, which must exist."
      },
      {
        "slug": "GITHUB_LIST_STARRED_GISTS",
        "name": "List starred gists",
        "description": "Retrieves a list of gists starred by the authenticated user."
      },
      {
        "slug": "GITHUB_LIST_STARRED_REPOSITORIES_FOR_USER",
        "name": "List starred repositories for user",
        "description": "Lists public repositories that a user has starred. The list includes all public repositories starred by the specified user, sorted by when they were starred or last updated. Use this action when you need to retrieve the list of repositories a specific GitHub user has starred."
      },
      {
        "slug": "GITHUB_LIST_STATUS_CHECK_CONTEXTS",
        "name": "Get all status check contexts",
        "description": "Fetches all required status check contexts for a protected branch; returns an empty list if the branch isn't protected or has no required checks."
      },
      {
        "slug": "GITHUB_LIST_SUB_ISSUES",
        "name": "List sub-issues for an issue",
        "description": "Tool to list sub-issues for a specific GitHub issue. Use when you need to retrieve all sub-issues associated with a parent issue, supporting pagination for large hierarchies."
      },
      {
        "slug": "GITHUB_LIST_SUBSCRIPTIONS_FOR_THE_AUTHENTICATED_USER",
        "name": "List marketplace subscriptions for authenticated user",
        "description": "Tool to list GitHub Marketplace subscriptions for the authenticated user. Use when you need to retrieve active marketplace app subscriptions including billing details, plan information, and trial status. Returns subscription information with account, plan, billing cycle, and pricing details."
      },
      {
        "slug": "GITHUB_LIST_SUBSCRIPTIONS_FOR_THE_AUTHENTICATED_USER_STUBBED",
        "name": "List stubbed subscriptions for the authenticated user",
        "description": "Lists the authenticated user's stubbed (test/example data, not live) GitHub Marketplace subscriptions, useful for development or testing."
      },
      {
        "slug": "GITHUB_LIST_TAG_PROTECTION_STATES_FOR_A_REPOSITORY",
        "name": "List tag protection states for a repository",
        "description": "DEPRECATED: Lists tag protection rules for a repository. This API was sunset on August 30, 2024. Use GITHUB_GET_ALL_REPOSITORY_RULESETS instead to view tag protection rules via repository rulesets."
      },
      {
        "slug": "GITHUB_LIST_TEAM_MEMBERS",
        "name": "List team members",
        "description": "Lists members of a specific team within an organization, including members of child teams."
      },
      {
        "slug": "GITHUB_LIST_TEAM_PROJECTS",
        "name": "List team projects",
        "description": "Lists GitHub projects accessible to a specific team within an organization."
      },
      {
        "slug": "GITHUB_LIST_TEAM_REPOSITORIES",
        "name": "List team repositories",
        "description": "Lists repositories accessible to a specific team within a GitHub organization. Returns a list of repositories that the specified team has access to, including the team's permission level (admin, maintain, push, triage, pull) for each repository. Requires read:org scope and membership in the organization to access team data."
      },
      {
        "slug": "GITHUB_LIST_TEAMS",
        "name": "List teams",
        "description": "Lists teams for a specified GitHub organization."
      },
      {
        "slug": "GITHUB_LIST_TEAMS_FOR_THE_AUTHENTICATED_USER",
        "name": "List teams for the authenticated user",
        "description": "Lists all teams across all organizations to which the authenticated user belongs, supporting pagination."
      },
      {
        "slug": "GITHUB_LIST_TEAMS_THAT_ARE_ASSIGNED_TO_AN_ORGANIZATION_ROLE",
        "name": "List teams assigned to an organization role",
        "description": "Lists teams assigned to a specific role within a GitHub organization. This endpoint requires organization administrator privileges. Use this to audit which teams have been granted specific organization-level permissions through roles. Note: Organization roles is a feature for enterprise-level GitHub organizations."
      },
      {
        "slug": "GITHUB_LIST_THE_PEOPLE_A_USER_FOLLOWS",
        "name": "List the people a user follows",
        "description": "Lists GitHub users that a valid GitHub `username` is following, supporting pagination."
      },
      {
        "slug": "GITHUB_LIST_THE_PEOPLE_THE_AUTHENTICATED_USER_FOLLOWS",
        "name": "List people the authenticated user follows",
        "description": "Lists people the authenticated user follows."
      },
      {
        "slug": "GITHUB_LIST_TIMELINE_EVENTS_FOR_AN_ISSUE",
        "name": "List timeline events for an issue",
        "description": "Lists chronological events (e.g., comments, commits, label changes) for a specific issue in a GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_TOKEN_ACCESS_REPOSITORIES",
        "name": "List token access repositories",
        "description": "Lists repositories in an organization that a fine-grained personal access token has access to. Requires organization admin permissions or 'Personal access tokens' organization read permission. Only GitHub Apps can use this endpoint."
      },
      {
        "slug": "GITHUB_LIST_USER_PROJECTS",
        "name": "List user projects",
        "description": "Retrieves a list of projects for a specified GitHub user, optionally filtering by state and supporting pagination; the username must be a valid GitHub handle. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub."
      },
      {
        "slug": "GITHUB_LIST_USERS",
        "name": "List users",
        "description": "Retrieves all GitHub users (individuals and organizations) in chronological order of their sign-up date."
      },
      {
        "slug": "GITHUB_LIST_USERS_BLOCKED_BY_AN_ORGANIZATION",
        "name": "List users blocked by an organization",
        "description": "Lists users blocked by a specified GitHub organization."
      },
      {
        "slug": "GITHUB_LIST_USERS_BLOCKED_BY_THE_AUTHENTICATED_USER",
        "name": "List users blocked by the authenticated user",
        "description": "Lists users blocked by the authenticated user, returning an empty list if no users are blocked."
      },
      {
        "slug": "GITHUB_LIST_USERS_THAT_ARE_ASSIGNED_TO_AN_ORGANIZATION_ROLE",
        "name": "List users assigned org role",
        "description": "Lists users assigned to a specific role within a GitHub organization."
      },
      {
        "slug": "GITHUB_LIST_WATCHERS",
        "name": "List watchers",
        "description": "Retrieves a list of users watching a specific repository; the repository must be accessible to the authenticated user."
      },
      {
        "slug": "GITHUB_LIST_WORKFLOW_RUN_ARTIFACTS",
        "name": "List workflow run artifacts",
        "description": "Lists artifacts (e.g., build outputs, test results) for a specific workflow run in a GitHub repository."
      },
      {
        "slug": "GITHUB_LIST_WORKFLOW_RUNS_FOR_A_REPOSITORY",
        "name": "List workflow runs for a repository",
        "description": "Lists workflow runs for a repository, allowing filtering by actor, branch, event, status, creation date, check suite ID, or head SHA; the repository must exist and be accessible."
      },
      {
        "slug": "GITHUB_LIST_WORKFLOW_RUNS_FOR_A_WORKFLOW",
        "name": "List workflow runs for a workflow",
        "description": "Lists runs for a specified, existing workflow (identified by ID or filename like `main.yml`) in a GitHub repository, with filtering options."
      },
      {
        "slug": "GITHUB_LOCK_AN_ISSUE",
        "name": "Lock an issue",
        "description": "Locks an existing GitHub issue's conversation, preventing further comments; an optional reason can be specified."
      },
      {
        "slug": "GITHUB_LOOKUP_ENTERPRISE_ADMINISTRATOR_INVITATION",
        "name": "Lookup Enterprise Administrator Invitation",
        "description": "Tool to look up a pending enterprise administrator invitation by invitee, enterprise, and role. Use when you need to check if a specific user has a pending invitation to become an enterprise administrator."
      },
      {
        "slug": "GITHUB_LOOKUP_GITHUB_RESOURCE",
        "name": "Lookup GitHub Resource",
        "description": "Tool to lookup a GitHub resource by its URL. Use when you need to identify or retrieve information about a GitHub resource from its URL."
      },
      {
        "slug": "GITHUB_LOOKUP_NODES_BY_IDS",
        "name": "Lookup nodes by IDs",
        "description": "Tool to lookup GitHub nodes by their global node IDs. Use when you need to retrieve multiple objects by their IDs in a single batch query."
      },
      {
        "slug": "GITHUB_LOOKUP_ORGANIZATION_GRAPH_QL",
        "name": "Lookup Organization (GraphQL)",
        "description": "Tool to lookup a GitHub organization by login using GraphQL. Use when you need organization information via GraphQL API."
      },
      {
        "slug": "GITHUB_LOOKUP_TOPIC_BY_NAME",
        "name": "Look Up Topic by Name",
        "description": "Tool to look up a GitHub topic by name using GraphQL. Use when you need to find information about a specific GitHub topic including its popularity (stargazer count) and related topics."
      },
      {
        "slug": "GITHUB_MANAGE_ACCESS_CONTROL_FOR_ORGANIZATION_CODESPACES",
        "name": "Manage access control for organization codespaces",
        "description": "Sets the Codespaces access control policy for a GitHub organization, determining which members can use them. This endpoint requires admin permissions on the organization. The API returns HTTP 204 No Content on success."
      },
      {
        "slug": "GITHUB_MANAGE_CUSTOM_PROPERTIES_FOR_ORG_REPOS",
        "name": "Manage custom properties for org repos",
        "description": "Creates or updates values for an organization's predefined custom properties across multiple repositories (up to 30)."
      },
      {
        "slug": "GITHUB_MANAGE_SECRETS_IN_SELECTED_REPOSITORIES",
        "name": "List selected repositories for a GitHub Actions organization secret",
        "description": "Lists repositories within an organization that have been explicitly granted access to a specific GitHub Actions organization secret. Returns all repositories that have been selected when the visibility for repository access to an Actions secret is set to 'selected'. Requires admin:org scope and admin access to the organization. Note: This endpoint only returns results when the secret's visibility is set to 'selected'. Secrets with visibility 'all' or 'private' do not have specific repository selections."
      },
      {
        "slug": "GITHUB_MAP_A_COMMIT_AUTHOR",
        "name": "Map a commit author",
        "description": "Updates Git author information (name and/or email) for an `author_id` obtained during a repository import, to correctly attribute commits. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports."
      },
      {
        "slug": "GITHUB_MARK_A_THREAD_AS_DONE",
        "name": "Mark a thread as done",
        "description": "Marks the GitHub notification thread (identified by `thread_id`) as done or read for the authenticated user, effectively archiving it."
      },
      {
        "slug": "GITHUB_MARK_A_THREAD_AS_READ",
        "name": "Mark a thread as read",
        "description": "Marks an existing GitHub notification thread, identified by its `thread_id`, as read."
      },
      {
        "slug": "GITHUB_MARK_NOTIFICATIONS_AS_READ",
        "name": "Mark notifications as read",
        "description": "Marks notifications as read or unread, optionally for those updated at or before a `last_read_at` timestamp."
      },
      {
        "slug": "GITHUB_MARK_PULL_REQUEST_READY_FOR_REVIEW",
        "name": "Mark pull request ready for review",
        "description": "Marks a draft pull request as ready for review using GitHub GraphQL API, transitioning it from draft to reviewable state. Use this action when a draft pull request has reached a stage where it is ready for team review and can potentially be merged. This action cannot be used on pull requests that are already marked as ready for review."
      },
      {
        "slug": "GITHUB_MARK_REPOSITORY_NOTIFICATIONS_AS_READ",
        "name": "Mark repository notifications as read",
        "description": "Marks notifications in a repository as read; if 'last_read_at' is specified, notifications updated after this timestamp are not marked as read."
      },
      {
        "slug": "GITHUB_MERGE_A_BRANCH",
        "name": "Merge a branch",
        "description": "Merges a head branch or commit SHA into a base branch in a repository; fails if there are merge conflicts requiring manual resolution."
      },
      {
        "slug": "GITHUB_MERGE_A_PULL_REQUEST",
        "name": "Merge a pull request",
        "description": "Merges an open and mergeable pull request in a repository. A 405 error can occur for multiple reasons: (1) The PR is still in draft mode - convert it to ready-for-review first using GITHUB_UPDATE_A_PULL_REQUEST. (2) Branch protection rules are not satisfied - check for required approving reviews, status checks, or other repository rules that must be met before merging. (3) The base branch has been modified since the PR was last synced - update the PR branch first using GITHUB_UPDATE_A_PULL_REQUEST_BRANCH."
      },
      {
        "slug": "GITHUB_MOVE_A_PROJECT_CARD",
        "name": "Move a project card (Classic - Deprecated)",
        "description": "Moves a project card to a specified position within a column (GitHub Classic Projects). DEPRECATION NOTICE: GitHub Projects (classic) and its REST API were sunset on April 1, 2025. This action will return 404 for most requests on GitHub.com. It may still work on GitHub Enterprise Server instances where classic projects remain enabled. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/ On success, the API returns HTTP 201 with an empty body, indicating the card was moved."
      },
      {
        "slug": "GITHUB_MOVE_A_PROJECT_COLUMN",
        "name": "Move a project column (Classic - Deprecated)",
        "description": "Moves a column within a GitHub project (classic) to a new position. DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. The `position` parameter can be: - 'first': Move the column to the beginning of the project - 'last': Move the column to the end of the project - 'after:<column_id>': Place the column after the specified column (e.g., 'after:67890') See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/"
      },
      {
        "slug": "GITHUB_PING_AN_ORGANIZATION_WEBHOOK",
        "name": "Ping an organization webhook",
        "description": "Sends a 'ping' event to a specified, existing organization webhook to test its configuration and ensure it correctly receives events."
      },
      {
        "slug": "GITHUB_PING_A_REPOSITORY_WEBHOOK",
        "name": "Ping a repository webhook",
        "description": "Pings an existing webhook on a repository to test its configuration and reachability by GitHub."
      },
      {
        "slug": "GITHUB_PRIVATELY_REPORT_A_SECURITY_VULNERABILITY",
        "name": "Privately report a security vulnerability",
        "description": "Privately reports a security vulnerability to a repository's maintainers. IMPORTANT: You cannot report vulnerabilities to repositories you own - this API is for third-party security researchers to report to other repositories. The target repository must have private vulnerability reporting enabled. Specify EITHER `severity` OR `cvss_vector_string`, but not both."
      },
      {
        "slug": "GITHUB_PUBLISH_SPONSORS_TIER_GRAPH_QL",
        "name": "Publish Sponsors Tier (GraphQL)",
        "description": "Tool to publish a draft GitHub Sponsors tier using GraphQL. Use when you need to make a draft sponsors tier visible to potential sponsors. The tier must already exist in draft status."
      },
      {
        "slug": "GITHUB_REDELIVER_A_DELIVERY_FOR_AN_ORGANIZATION_WEBHOOK",
        "name": "Redeliver a delivery for an organization webhook",
        "description": "Redelivers a specific webhook delivery for a webhook within an organization, to resend an event that previously failed or was not processed."
      },
      {
        "slug": "GITHUB_REDELIVER_A_DELIVERY_FOR_A_REPOSITORY_WEBHOOK",
        "name": "Redeliver a delivery for a repository webhook",
        "description": "Redelivers a specific, previously made webhook delivery (`delivery_id`) for a repository's webhook (`hook_id`)."
      },
      {
        "slug": "GITHUB_REMOVE_A_CUSTOM_PROPERTY_FOR_AN_ORGANIZATION",
        "name": "Remove a custom property for an organization",
        "description": "Deletes a custom property, specified by `custom_property_name`, from an existing organization (`org`) for which the property is currently defined, preventing its future assignment to repositories."
      },
      {
        "slug": "GITHUB_REMOVE_A_LABEL_FROM_AN_ISSUE",
        "name": "Remove a label from an issue",
        "description": "Removes a label currently applied to a specific issue in a repository."
      },
      {
        "slug": "GITHUB_REMOVE_ALL_LABELS_FROM_AN_ISSUE",
        "name": "Remove all labels from an issue",
        "description": "Removes all labels from a specified issue in a GitHub repository; this operation is idempotent."
      },
      {
        "slug": "GITHUB_REMOVE_ALL_ORGANIZATION_ROLES_FOR_A_TEAM",
        "name": "Remove all organization roles for a team",
        "description": "Revokes all organization roles for a team in an organization; this is destructive and succeeds even if the team initially has no roles."
      },
      {
        "slug": "GITHUB_REMOVE_ALL_ORGANIZATION_ROLES_FOR_A_USER",
        "name": "Remove all organization roles for a user",
        "description": "Revokes all assigned organization-level roles from a specified user (who must be a member of the organization) within a GitHub organization, without removing the user from the organization or affecting repository-specific roles."
      },
      {
        "slug": "GITHUB_REMOVE_AN_ORGANIZATION_MEMBER",
        "name": "Remove an organization member",
        "description": "Removes a member from a GitHub organization. This action permanently removes a user's membership from the specified organization, revoking their access to all organization resources, repositories, and teams. Requirements: - The authenticated user must be an organization owner - The target user must currently be a member of the organization Note: This action cannot be used to remove the last owner of an organization."
      },
      {
        "slug": "GITHUB_REMOVE_AN_ORGANIZATION_ROLE_FROM_A_TEAM",
        "name": "Remove an organization role from a team",
        "description": "Revokes an organization role that a team currently possesses within an organization."
      },
      {
        "slug": "GITHUB_REMOVE_AN_ORGANIZATION_ROLE_FROM_A_USER",
        "name": "Remove an organization role from a user",
        "description": "Removes a custom organization role from a user within a GitHub organization, provided the organization exists, the user is a member, and the role_id corresponds to a valid custom role in that organization."
      },
      {
        "slug": "GITHUB_REMOVE_APP_ACCESS_RESTRICTIONS",
        "name": "Remove app access restrictions",
        "description": "Removes all GitHub App access restrictions from a protected branch in a repository; the branch must have protection rules configured, and this action does not alter user or team restrictions."
      },
      {
        "slug": "GITHUB_REMOVE_A_PROJECT_FROM_A_TEAM",
        "name": "Remove a project from a team",
        "description": "Removes a project from a team within an organization; this action requires the project to be currently associated with the team."
      },
      {
        "slug": "GITHUB_REMOVE_A_REPOSITORY_COLLABORATOR",
        "name": "Remove a repository collaborator",
        "description": "Removes a collaborator from a specified GitHub repository, provided the repository exists and the user is an existing collaborator."
      },
      {
        "slug": "GITHUB_REMOVE_A_REPOSITORY_FROM_AN_APP_INSTALLATION",
        "name": "Remove a repository from an app installation",
        "description": "Removes a repository from a GitHub App installation for the authenticated user, given a valid `installation_id` and the `repository_id` of a repository currently linked to that installation; this operation is idempotent."
      },
      {
        "slug": "GITHUB_REMOVE_A_REPOSITORY_FROM_A_TEAM",
        "name": "Remove a repository from a team",
        "description": "Disassociates a repository from a team; team members may lose access permissions, but the repository and team are not deleted."
      },
      {
        "slug": "GITHUB_REMOVE_A_SELECTED_REPOSITORY_FROM_A_USER_SECRET",
        "name": "Remove a selected repository from a user secret",
        "description": "Removes a selected repository's access to a user's Codespaces secret; the secret must exist and the repository must have previously been granted access."
      },
      {
        "slug": "GITHUB_REMOVE_ASSIGNEES_FROM_AN_ISSUE",
        "name": "Remove assignees from an issue",
        "description": "Removes specified assignees from a GitHub issue; requires push access, and invalid removal attempts are silently ignored."
      },
      {
        "slug": "GITHUB_REMOVE_CUSTOM_LABEL_FROM_REPO_RUNNER",
        "name": "Remove custom label from repo runner",
        "description": "Removes a custom label from a repository's self-hosted runner; this operation is idempotent."
      },
      {
        "slug": "GITHUB_REMOVE_CUSTOM_LABEL_FROM_SELF_HOSTED_RUNNER",
        "name": "Remove custom label from self hosted runner",
        "description": "Removes a currently assigned custom label (`name`) from a self-hosted runner (`runner_id`) in an organization (`org`). This action allows the organization to manage the labels associated with their runners effectively."
      },
      {
        "slug": "GITHUB_REMOVE_CUSTOM_LABELS_FROM_SELF_HOSTED_REPO_RUNNER",
        "name": "Remove custom labels from self hosted repo runner",
        "description": "Removes all custom labels from a self-hosted runner registered at the repository level, leaving only its default labels and any labels inherited from its runner group or organization."
      },
      {
        "slug": "GITHUB_REMOVE_INTERACTION_RESTRICTIONS_FOR_AN_ORGANIZATION",
        "name": "Remove interaction restrictions for an organization",
        "description": "Removes all interaction restrictions from public repositories in the specified GitHub organization, allowing all users to resume interactions."
      },
      {
        "slug": "GITHUB_REMOVE_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORY",
        "name": "Remove interaction restrictions for a repository",
        "description": "Removes all interaction restrictions for a repository, enabling all users to comment, open issues, and create pull requests by lifting any existing temporary interaction limits."
      },
      {
        "slug": "GITHUB_REMOVE_ORG_DEV_ENV_SECRET_BY_NAME",
        "name": "Remove org dev env secret by name",
        "description": "Deletes a GitHub Codespaces secret from an organization by its name; this operation is idempotent."
      },
      {
        "slug": "GITHUB_REMOVE_ORG_SECRET_BY_NAME",
        "name": "Remove org secret by name",
        "description": "Permanently removes a specific Dependabot secret, by its `secret_name`, from the GitHub `org`, making it unavailable to Dependabot for that organization."
      },
      {
        "slug": "GITHUB_REMOVE_OUTSIDE_COLLABORATOR_FROM_AN_ORGANIZATION",
        "name": "Remove outside collaborator from an organization",
        "description": "Removes a user, who must be an outside collaborator, from the specified GitHub organization, revoking their access to all its repositories."
      },
      {
        "slug": "GITHUB_REMOVE_PUBLIC_ORG_MEMBERSHIP",
        "name": "Remove public org membership",
        "description": "Removes the authenticated user's public organization membership, making it private. The user remains a member of the organization but their membership is no longer publicly visible. This operation is idempotent - calling it when the membership is already private will succeed."
      },
      {
        "slug": "GITHUB_REMOVE_PUBLIC_REPO_INTERACTION_RESTRICTIONS",
        "name": "Remove user public repo interaction restrictions",
        "description": "Removes all interaction restrictions (limitations on comments, issues, or pull requests) from all public repositories owned by the authenticated user."
      },
      {
        "slug": "GITHUB_REMOVE_REPO_FROM_ORG_DEV_ENV_SECRET",
        "name": "Remove repository from organization dev environment secret",
        "description": "Removes a repository's access to an organization-level Codespaces secret, if it was previously granted."
      },
      {
        "slug": "GITHUB_REMOVE_REPO_FROM_ORG_SECRET_WITH_SELECTED_VISIBILITY",
        "name": "Remove selected repo from org secret",
        "description": "Revokes a specific repository's access to an organization-level Dependabot secret, applicable only when the secret has 'selected' visibility and the specified repository currently has access."
      },
      {
        "slug": "GITHUB_REMOVE_REQUESTED_REVIEWERS_FROM_A_PULL_REQUEST",
        "name": "Remove requested reviewers from a pull request",
        "description": "Removes currently assigned user logins and/or team slugs from a GitHub pull request's list of requested reviewers."
      },
      {
        "slug": "GITHUB_REMOVE_REVIEW_REQUEST",
        "name": "Remove review request",
        "description": "Removes requested reviewers from a pull request. Use this action when you need to cancel a review request that was previously sent to users or teams. Only users with push access to the repository can remove review requests."
      },
      {
        "slug": "GITHUB_REMOVE_SELECTED_REPO_FROM_ORG_SECRET",
        "name": "Remove selected repository from an organization secret",
        "description": "Removes a specific repository's access to an organization-level secret; the repository must have been previously granted access to this secret."
      },
      {
        "slug": "GITHUB_REMOVE_SELECTED_REPO_FROM_ORG_VARIABLE",
        "name": "Remove selected repository from an organization variable",
        "description": "Removes a repository's access to an organization variable that has 'selected' visibility. This endpoint removes a specific repository from an organization variable's access list. The variable must have its visibility set to 'selected' for this operation to work. Returns a 409 Conflict error if the variable visibility is not 'selected'."
      },
      {
        "slug": "GITHUB_REMOVE_STATUS_CHECK_CONTEXTS",
        "name": "Remove status check contexts",
        "description": "Removes specified status check contexts from a protected branch's required status checks. This action removes the specified status check contexts from the existing list of required status checks for a protected branch. The branch must already have branch protection enabled with status checks configured. Note: The 'contexts' parameter is deprecated by GitHub in favor of 'checks' array. For new implementations, consider using update_status_check_protection with the 'checks' parameter instead."
      },
      {
        "slug": "GITHUB_REMOVE_STATUS_CHECK_PROTECTION",
        "name": "Remove status check protection",
        "description": "Removes status check protection from a branch, disabling required status checks for merging pull requests; will only have an effect if status check protection is currently configured on the branch."
      },
      {
        "slug": "GITHUB_REMOVE_TEAM_ACCESS_RESTRICTIONS",
        "name": "Remove team access restrictions",
        "description": "Removes specified teams from push access to a protected branch. This action removes teams from the list of teams with push access to a protected branch. Removing a team will also remove push access for any child teams. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must currently have push access to the branch"
      },
      {
        "slug": "GITHUB_REMOVE_TEAM_MEMBERSHIP",
        "name": "Remove team membership",
        "description": "Tool to remove team membership for a user in an organization. Use when you need to revoke a user's membership from a specific team. This action is irreversible — the user must be explicitly re-added if you want to restore their team membership. Note that if team synchronization is set up, this operation may fail with a 403 Forbidden error."
      },
      {
        "slug": "GITHUB_REMOVE_TEAM_MEMBERSHIP_FOR_A_USER",
        "name": "Remove team membership for a user",
        "description": "Removes a user from a specific team within an organization. This action requires admin:org scope permissions. It will fail if: - Team synchronization with an Identity Provider (IdP) is enabled (403 Forbidden) - The organization, team, or user membership doesn't exist (404 Not Found) - You don't have sufficient permissions to manage team memberships (403 Forbidden) Note: If the removed user was the last member and the team is not nested, the team may be deleted automatically."
      },
      {
        "slug": "GITHUB_REMOVE_USER_ACCESS_RESTRICTIONS",
        "name": "Remove user access restrictions",
        "description": "Removes specified users from the list of people allowed to push to a protected branch. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must have protection rules with push restrictions enabled - Users being removed must currently have push access to the branch - The combined total of users, apps, and teams is limited to 100 items"
      },
      {
        "slug": "GITHUB_REMOVE_USER_AS_A_COLLABORATOR",
        "name": "Remove user as a collaborator (classic project)",
        "description": "Removes a user as a collaborator from an organization project (classic). IMPORTANT: This action uses the Projects (classic) REST API which is being deprecated. The Projects (classic) feature was sunset on GitHub.com. This API may still work on GitHub Enterprise Server versions before 3.17. Requirements: - You must be an organization owner or a project admin to remove a collaborator - The user must already be a collaborator on the specified project - The project must be an organization project (classic), not a Projects V2 project For GitHub.com users: Consider using GitHub Projects V2 instead, which can be managed through the GraphQL API."
      },
      {
        "slug": "GITHUB_REMOVE_USERS_CODESPACES_ACCESS_ORG",
        "name": "Remove users from codespaces access for an organization",
        "description": "Removes selected users from GitHub Codespaces billing access for an existing organization."
      },
      {
        "slug": "GITHUB_RENAME_A_BRANCH",
        "name": "Rename a branch",
        "description": "Renames an existing branch in a GitHub repository; the new name must be unique and adhere to GitHub's naming conventions, and the current branch name cannot contain wildcard characters."
      },
      {
        "slug": "GITHUB_RENDER_A_MARKDOWN_DOCUMENT",
        "name": "Render a markdown document",
        "description": "Renders Markdown to HTML; for 'gfm' mode, provide 'context' (owner/repo) to correctly link issues, pull requests, and user mentions."
      },
      {
        "slug": "GITHUB_RENDER_MARKDOWN_RAW",
        "name": "Render Markdown (Raw Mode)",
        "description": "Tool to render raw Markdown text to HTML using GitHub's markdown API. Use when you need to convert plain Markdown content to HTML without GitHub-specific features like issue references or @mentions."
      },
      {
        "slug": "GITHUB_REOPEN_ISSUE",
        "name": "Reopen an issue",
        "description": "Reopens a closed GitHub issue by changing its state to 'open' with state_reason 'reopened'. Use this action when you need to reopen a previously closed issue that requires further attention or work. Only users with push access to the repository can reopen issues."
      },
      {
        "slug": "GITHUB_REOPEN_PULL_REQUEST",
        "name": "Reopen Pull Request",
        "description": "Reopens a previously closed pull request by setting its state to 'open'. This restores the pull request to an active state where it can be reviewed, commented on, and merged. Use this action when you need to reactivate a closed pull request that was closed prematurely or needs to be reconsidered for merging."
      },
      {
        "slug": "GITHUB_REPLACE_ALL_REPOSITORY_TOPICS",
        "name": "Replace all repository topics",
        "description": "Replaces all topics of a repository."
      },
      {
        "slug": "GITHUB_REPLACE_ORG_SECRET_VISIBILITY_TO_SELECTED",
        "name": "Replace org secret visibility to selected",
        "description": "Replaces the list of repositories that can access a Dependabot organization secret when the secret's visibility is already set to 'selected'."
      },
      {
        "slug": "GITHUB_REPLACE_REPO_ACCESS_ON_ORG_DEV_ENV_SECRET_SET",
        "name": "Replace repository access for an org Codespaces secret",
        "description": "Replaces the list of repositories that can access an organization-level Codespaces secret. This operation completely replaces the existing list of repositories with the provided list. The secret must already have its visibility set to 'selected' for this operation to succeed. Use this when you want to set an exact list of repositories that should have access. Prerequisites: - The organization must exist and you must have admin:org scope - The Codespaces secret must already exist in the organization - The secret's visibility must be set to 'selected' (not 'all' or 'private') Returns HTTP 204 No Content on success, 404 if secret/org not found, 409 if visibility is not 'selected'."
      },
      {
        "slug": "GITHUB_REQUEST_A_GITHUB_PAGES_BUILD",
        "name": "Request a github pages build",
        "description": "Manually triggers a GitHub Pages build for a repository if GitHub Pages is enabled, useful for deployments not automatically built or for retrying failed builds."
      },
      {
        "slug": "GITHUB_REQUEST_REVIEWERS",
        "name": "Request reviewers for a pull request",
        "description": "Requests reviewers for a specific pull request identified by owner, repository, and pull request number. Use this action when you need to add individual users or teams as reviewers to an existing pull request. At least one of reviewers (individual users) or team_reviewers (teams) must be provided."
      },
      {
        "slug": "GITHUB_REQUEST_REVIEWERS_FOR_A_PULL_REQUEST",
        "name": "Add reviewers to a specific pull request",
        "description": "Adds reviewers to a specific pull request identified by owner, repo, and pull_number. This is NOT a search action - it operates on an already-known PR number. Requires `owner`, `repo`, `pull_number`, and at least one of `reviewers` or `team_reviewers`."
      },
      {
        "slug": "GITHUB_REREQUEST_A_CHECK_RUN",
        "name": "Rerequest a check run",
        "description": "Triggers a re-run of a specific check run in a GitHub repository, resetting its status to 'queued', clearing its conclusion, and triggering the `check_run` webhook with `rerequested` action. IMPORTANT: This endpoint requires GitHub App authentication with 'checks:write' permission. The check run can ONLY be re-requested by the same GitHub App that originally created it. OAuth tokens and personal access tokens (PAT) cannot use this endpoint."
      },
      {
        "slug": "GITHUB_REREQUEST_A_CHECK_SUITE",
        "name": "Rerequest a check suite",
        "description": "Triggers a new run of an existing check suite within a repository, resetting its status to 'queued', clearing its conclusion, and triggering the `check_suite` webhook with `rerequested` action. IMPORTANT: This endpoint requires GitHub App authentication with 'checks:write' permission. OAuth tokens and classic personal access tokens (PAT) cannot use this endpoint. Only GitHub App user access tokens, GitHub App installation access tokens, or fine-grained personal access tokens with checks:write permission are supported."
      },
      {
        "slug": "GITHUB_RE_RUN_A_JOB_FROM_A_WORKFLOW_RUN",
        "name": "Re-run a job from a workflow run",
        "description": "Re-runs a specific job and any dependent jobs from a GitHub Actions workflow run in the specified repository, optionally enabling debug logging."
      },
      {
        "slug": "GITHUB_RE_RUN_A_WORKFLOW",
        "name": "Rerun a workflow",
        "description": "Re-runs a specific GitHub Actions workflow run identified by its owner, repository, and run ID, optionally enabling debug logging."
      },
      {
        "slug": "GITHUB_RE_RUN_FAILED_JOBS_FROM_A_WORKFLOW_RUN",
        "name": "Rerun failed jobs from a workflow run",
        "description": "Re-runs all failed jobs and their dependent jobs from a specified workflow run if the run contains previously failed jobs."
      },
      {
        "slug": "GITHUB_RESET_A_TOKEN",
        "name": "Reset a token",
        "description": "Invalidates the provided OAuth `access_token` and generates a new one for the GitHub OAuth App identified by `client_id`. Used for token rotation when a token may be compromised or for regular security maintenance. Note: This endpoint requires the OAuth App owner's credentials (client_id/client_secret for Basic Auth)."
      },
      {
        "slug": "GITHUB_RESTORE_A_PACKAGE_FOR_AN_ORGANIZATION",
        "name": "Restore a package for an organization",
        "description": "Restores a package in an organization, provided it was deleted within the last 30 days."
      },
      {
        "slug": "GITHUB_RESTORE_A_PACKAGE_FOR_A_USER",
        "name": "Restore a package for a user",
        "description": "Restores a user-owned package previously deleted from GitHub Packages, if restorable under GitHub's data retention policy (typically within 30 days of deletion)."
      },
      {
        "slug": "GITHUB_RESTORE_A_PACKAGE_FOR_THE_AUTHENTICATED_USER",
        "name": "Restore a package for the authenticated user",
        "description": "Restores a package deleted by the authenticated user within the last 30 days, if its namespace and version are still available."
      },
      {
        "slug": "GITHUB_RESTORE_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USER",
        "name": "Restore a package version for the authenticated user",
        "description": "Restores a package version that was deleted by the authenticated user within the last 30 days."
      },
      {
        "slug": "GITHUB_RESTORE_PACKAGE_VERSION_FOR_AN_ORGANIZATION",
        "name": "Restore package version for an organization",
        "description": "Restores a package version for an organization, provided it was deleted within the last 30 days."
      },
      {
        "slug": "GITHUB_RESTORE_PACKAGE_VERSION_FOR_A_USER",
        "name": "Restore package version for a user",
        "description": "Restores a specific, user-owned package version if it was deleted within the last 30 days and its original namespace and version name are still available."
      },
      {
        "slug": "GITHUB_RETIRE_SPONSORS_TIER",
        "name": "Retire Sponsors Tier",
        "description": "Tool to retire a published payment tier from your GitHub Sponsors profile using GraphQL. Use when you need to prevent a tier from being used for new sponsorships. Existing sponsors at this tier remain unaffected."
      },
      {
        "slug": "GITHUB_REVIEW_ACCESS_WITH_PERSONAL_TOKEN",
        "name": "Review access with personal token",
        "description": "Approves or denies a pending fine-grained personal access token request for organization resources; must be performed by a GitHub App."
      },
      {
        "slug": "GITHUB_REVIEW_DEPLOYMENT_PROTECTION_RULES",
        "name": "Review Custom Deployment Rules For Workflow Run",
        "description": "Approves or rejects pending custom deployment protection rules for a workflow run. This endpoint allows GitHub Apps to review their own pending custom deployment protection rules for a specific workflow run. The review can either approve (allowing the deployment to proceed) or reject (blocking the deployment). **Important notes:** - GitHub Apps can only review their own custom deployment protection rules - This endpoint requires GitHub App installation access tokens with Deployments permission (write) - Custom deployment protection rules are available in public repos for all plans; for private/internal repos, GitHub Enterprise is required - Returns 204 No Content on success"
      },
      {
        "slug": "GITHUB_REVIEW_PENDING_DEPLOYMENTS_FOR_A_WORKFLOW_RUN",
        "name": "Review pending deployments for a workflow run",
        "description": "Approves or rejects pending deployments for a specific workflow run that are in a 'waiting' state within specified, configured environments."
      },
      {
        "slug": "GITHUB_REVIEW_RESOURCE_REQUESTS_WITH_FINE_GRAINED_TOKENS",
        "name": "Review PAT Requests in Bulk",
        "description": "Approves or denies multiple fine-grained personal access token requests for an organization in bulk. This endpoint processes multiple PAT request approvals or denials in a single API call. All specified pat_request_ids must refer to currently pending requests. Important: This endpoint can ONLY be called by GitHub Apps with the 'organization_personal_access_token_requests:write' permission. It cannot be called with personal access tokens or OAuth apps. On success, returns HTTP 202 Accepted with an empty body."
      },
      {
        "slug": "GITHUB_REVOKE_AN_INSTALLATION_ACCESS_TOKEN",
        "name": "Revoke an installation access token",
        "description": "Revokes the GitHub App's current installation access token, immediately invalidating it for API authentication. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs_* prefix) for authentication. OAuth tokens (gho_*) or personal access tokens are not supported and will result in a 403 Forbidden error. After successful revocation, the token becomes permanently invalid and cannot be used for any subsequent API calls. To continue API operations, a new installation access token must be generated."
      },
      {
        "slug": "GITHUB_RUN_GRAPH_QL_QUERY",
        "name": "Run GraphQL Query",
        "description": "Tool to run an arbitrary GitHub GraphQL v4 query or mutation. Use when fetching multiple datasets in one batch. Cost-based rate limit: ~5,000 points/hour; keep field selections narrow, avoid deep nesting, and include rateLimit in responses to monitor quota. Responses are nested under data.data (e.g., data.data.repository.vulnerabilityAlerts); always inspect the errors array even on HTTP 200, as partial failures embed there. Paginate by looping on pageInfo.hasNextPage and advancing with pageInfo.endCursor. Search results cap at ~1,000 items per query; split by label, date range, or repository for full coverage. Use ProjectV2 nodes, not Classic Projects (deprecated). Parallel mutations (e.g., addProjectV2ItemById) can trigger transient conflicts; use sequential execution."
      },
      {
        "slug": "GITHUB_RUN_GRAPH_QL_RELAY_QUERY",
        "name": "Run GraphQL Relay Query",
        "description": "Tool to run a GitHub GraphQL relay query. The relay field is a workaround for re-exposing the root query object. Use when you need to access root query fields through the relay context."
      },
      {
        "slug": "GITHUB_SEARCH_CODE",
        "name": "Search code",
        "description": "Searches code file contents and paths on the default branch of GitHub repositories using a query string; searches only files under 384KB, returns max 1000 results by best match, and is optimized for precision."
      },
      {
        "slug": "GITHUB_SEARCH_CODE_ALL_PAGES",
        "name": "Search code (all pages)",
        "description": "Tool to search code across multiple pages using GitHub's code search API. Use when single-page searches may miss matches and you need a full or capped result set. GitHub caps results at ~1,000 total items regardless of pagination; results for broad queries may be silently truncated. Only the default branch is indexed, and very large files may be excluded — treat results as potentially partial. Rate limit: ~30 requests/minute; honor `Retry-After` on 403/429 responses."
      },
      {
        "slug": "GITHUB_SEARCH_COMMITS",
        "name": "Search commits",
        "description": "Finds commits on GitHub using a query string (q) supporting keywords and qualifiers, with options for sorting and pagination."
      },
      {
        "slug": "GITHUB_SEARCH_COMMITS_BY_AUTHOR",
        "name": "Search commits by author across repos",
        "description": "Searches commits across GitHub using the Search API (e.g., by author/email/org/date range) without per-repo scanning. Use when you need to find commits by author, committer email, organization, or date ranges across multiple repositories. This avoids the need to list commits per repository and prevents 409 errors on empty repos."
      },
      {
        "slug": "GITHUB_SEARCH_GITHUB_GRAPHQL",
        "name": "GitHub GraphQL Search",
        "description": "Tool to perform GitHub GraphQL searches across issues, pull requests, repositories, users, and discussions. Returns up to 1,000 results with cursor-based pagination. Use when you need structured search results with specific fields."
      },
      {
        "slug": "GITHUB_SEARCH_ISSUES",
        "name": "Search issues and pull requests",
        "description": "Searches GitHub issues and pull requests using a flexible query with qualifiers, sorting, and pagination. Use this action when you need to find issues or pull requests across repositories using search criteria like author, labels, state, milestone, or date ranges. This action searches across all repositories accessible to the authenticated user unless constrained by qualifiers like repo:, user:, or org:."
      },
      {
        "slug": "GITHUB_SEARCH_ISSUES_AND_PULL_REQUESTS",
        "name": "Search issues and pull requests",
        "description": "Searches GitHub for issues and pull requests. Supports keywords, qualifiers (repo:, org:, user:, state:, label:, author:, assignee:, mentions:, etc.), and type filters (is:issue, is:pr). Type filters cannot be used alone - they must be combined with at least one keyword or other qualifier. All other qualifiers work independently. The @me shorthand (e.g., assignee:@me, mentions:@me) is automatically resolved to your username. Logical operators (AND, OR, NOT) are supported but limited to a maximum of 5 operators total per query."
      },
      {
        "slug": "GITHUB_SEARCH_LABELS",
        "name": "Search labels",
        "description": "Searches for labels within a GitHub repository by keywords in their names or descriptions."
      },
      {
        "slug": "GITHUB_SEARCH_REPOSITORIES",
        "name": "Search repositories",
        "description": "Searches GitHub repositories using a flexible query (keywords, qualifiers) with sorting, ordering, and pagination. IMPORTANT: The 'q' parameter (search query) is REQUIRED and must always be provided."
      },
      {
        "slug": "GITHUB_SEARCH_TOPICS",
        "name": "Search topics",
        "description": "Finds topics on GitHub using keywords and qualifiers with GitHub's search syntax, supporting pagination."
      },
      {
        "slug": "GITHUB_SEARCH_USERS",
        "name": "Search users",
        "description": "Searches for users on GitHub by criteria like username, email, location, followers, or repository associations, using a flexible query string `q`."
      },
      {
        "slug": "GITHUB_SET_ADMIN_BRANCH_PROTECTION",
        "name": "Set admin branch protection",
        "description": "Enables administrator enforcement on a branch, making existing protection rules also apply to administrators; branch protection rules must already be configured."
      },
      {
        "slug": "GITHUB_SET_APP_ACCESS_RESTRICTIONS",
        "name": "Set app access restrictions",
        "description": "Replaces the list of GitHub Apps permitted to push to a protected branch. This action completely replaces the existing list of apps with push access - it does not add to or merge with the current list. Requirements: - The branch must already have protection rules enabled with push restrictions configured - Apps must be installed on the repository and have 'contents' write permission - Push restrictions are only available for organization-owned repositories with GitHub Team or Enterprise Cloud plans"
      },
      {
        "slug": "GITHUB_SET_A_REPOSITORY_SUBSCRIPTION",
        "name": "Set a repository subscription",
        "description": "Sets the authenticated user's notification subscription for a repository."
      },
      {
        "slug": "GITHUB_SET_A_THREAD_SUBSCRIPTION",
        "name": "Set a thread subscription",
        "description": "Sets whether a GitHub notification thread is ignored (muted) or unignored (unmuted), for a `thread_id` that must identify an existing notification thread."
      },
      {
        "slug": "GITHUB_SET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_AN_ORGANIZATION",
        "name": "Set default workflow permissions for an organization",
        "description": "Updates an organization's default GITHUB_TOKEN permissions for workflows and whether GitHub Actions can approve pull requests; note that allowing Actions to approve pull requests (`can_approve_pull_request_reviews: true`) is a security risk."
      },
      {
        "slug": "GITHUB_SET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_A_REPOSITORY",
        "name": "Set default workflow permissions for a repository",
        "description": "Sets the default permissions for the GITHUB_TOKEN within a repository and configures whether GitHub Actions can approve pull requests."
      },
      {
        "slug": "GITHUB_SET_EMAIL_VISIBILITY",
        "name": "Set primary email visibility",
        "description": "Sets the visibility ('public' or 'private') of the authenticated user's primary email address on GitHub, if one is configured."
      },
      {
        "slug": "GITHUB_SET_GITHUB_ACTIONS_PERMISSIONS_FOR_AN_ORGANIZATION",
        "name": "Set GitHub Actions permissions for an organization",
        "description": "Sets the GitHub Actions permissions policy for an organization, specifying which repositories can run Actions and which actions/workflows are allowed; if 'selected' is chosen for either, manage the specific lists via other endpoints."
      },
      {
        "slug": "GITHUB_SET_GITHUB_ACTIONS_PERMISSIONS_FOR_A_REPOSITORY",
        "name": "Set github actions permissions for a repository",
        "description": "Sets GitHub Actions permissions for a repository, enabling/disabling Actions and defining the policy for allowed actions and reusable workflows."
      },
      {
        "slug": "GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_AN_ORGANIZATION",
        "name": "Set interaction restrictions for an organization",
        "description": "Limits interactions (comments, new issues, PRs) in an organization's public repositories by user type and duration, typically to mitigate high traffic or unwanted activity."
      },
      {
        "slug": "GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORY",
        "name": "Set interaction restrictions for a repository",
        "description": "Temporarily limits which GitHub users (e.g., existing_users, contributors_only) can interact (comment, open issues, create pull requests) in a repository for a specified duration."
      },
      {
        "slug": "GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_YOUR_PUBLIC_REPOS",
        "name": "Set interaction restrictions for your public repositories",
        "description": "Sets or updates temporary interaction restrictions for all public repositories owned by the authenticated user, overriding any repository-specific limits."
      },
      {
        "slug": "GITHUB_SET_LABELS_FOR_AN_ISSUE",
        "name": "Set labels for an issue",
        "description": "Replaces all existing labels on a GitHub issue with a new set of labels."
      },
      {
        "slug": "GITHUB_SET_OIDC_SUBJECT_CLAIM_TEMPLATE",
        "name": "Set custom OIDC subject claim template",
        "description": "Sets the OpenID Connect (OIDC) subject claim template for a GitHub repository, allowing use of the default template or a custom one defined by `include_claim_keys` if `use_default` is `false`."
      },
      {
        "slug": "GITHUB_SET_ORG_ALLOWED_ACTIONS",
        "name": "Set allowed actions and workflows for an organization",
        "description": "Sets the GitHub Actions permissions for an existing organization, specifying allowed GitHub-owned actions, verified creator actions, and action/workflow patterns from public repositories."
      },
      {
        "slug": "GITHUB_SET_ORG_RUNNER_LABELS",
        "name": "Set custom labels for a self-hosted runner for an organization",
        "description": "Sets the custom labels for a self-hosted runner in an organization; this operation does not affect default system-assigned labels (e.g., 'self-hosted', 'linux', 'x64')."
      },
      {
        "slug": "GITHUB_SET_REPO_ALLOWED_ACTIONS",
        "name": "Set repo allowed actions",
        "description": "Sets allowed GitHub Actions and reusable workflows for a repository, managing permissions for GitHub-owned, verified creator, or specific pattern-matched actions/workflows (note: `patterns_allowed` applies only to public repositories)."
      },
      {
        "slug": "GITHUB_SET_REPO_RUNNER_LABELS",
        "name": "Set custom labels for repo runner",
        "description": "Replaces all custom labels for a specific self-hosted runner in a repository; an empty list for `labels` removes all existing custom labels."
      },
      {
        "slug": "GITHUB_SET_SELECTED_REPOS_FOR_ORG_VARIABLE",
        "name": "Set selected repositories for an organization variable",
        "description": "Replaces the list of repositories that can access an organization-level variable; the variable's visibility must be 'selected'."
      },
      {
        "slug": "GITHUB_SET_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_SECRET",
        "name": "Set selected repositories for an organization secret",
        "description": "Replaces the list of repositories that can access an organization secret; only effective if the secret's visibility is 'selected'. Prerequisites: - The organization secret must already exist - The secret's visibility must be set to 'selected' (not 'all' or 'private') - Requires admin:org scope or actions secrets fine-grained permission This action completely replaces the repository access list. To add or remove individual repositories without affecting others, use the dedicated add/remove repository actions instead."
      },
      {
        "slug": "GITHUB_SET_SELECTED_REPOSITORIES_FOR_A_USER_SECRET",
        "name": "Set selected repositories for a user secret",
        "description": "Defines the list of repositories permitted to access a specific Codespaces secret for the authenticated user."
      },
      {
        "slug": "GITHUB_SET_STATUS_CHECK_CONTEXTS",
        "name": "Set status check contexts",
        "description": "Replaces required status check contexts for a protected branch, requiring admin permissions; an empty `contexts` array removes all checks."
      },
      {
        "slug": "GITHUB_SET_TEAM_ACCESS_RESTRICTIONS",
        "name": "Set team access restrictions",
        "description": "Replaces the list of teams with push access to a protected branch. This action sets (replaces) the teams that have push access to a protected branch. Unlike 'Add team access restrictions' (POST), this action replaces the entire list rather than adding to it. Use an empty list to remove all team restrictions. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository access"
      },
      {
        "slug": "GITHUB_SET_USER_ACCESS_RESTRICTIONS",
        "name": "Set user access restrictions",
        "description": "Replaces the list of users with push access to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - This REPLACES (not adds to) the existing list of users with push access - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 items - To add users without replacing, use the 'add_user_access_restrictions' action instead"
      },
      {
        "slug": "GITHUB_SET_USER_INTERACTION_LIMIT_GRAPH_QL",
        "name": "Set User Interaction Limit (GraphQL)",
        "description": "Tool to set interaction limits on a user's public repositories using GraphQL. Use when you need to temporarily restrict who can comment, open issues, or create pull requests. Limits apply to the authenticated user or a specified user."
      },
      {
        "slug": "GITHUB_SET_WORKFLOW_EXTERNAL_ACCESS",
        "name": "Set workflow access level outside repository",
        "description": "Sets the access level for workflows outside a repository to use actions and reusable workflows within that repository."
      },
      {
        "slug": "GITHUB_STAR_A_GIST",
        "name": "Star a gist",
        "description": "Stars a GitHub gist identified by `gist_id`; this action is idempotent and returns a 204 No Content status upon success, even if the gist is already starred."
      },
      {
        "slug": "GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER",
        "name": "Star a specified repository (requires owner and repo)",
        "description": "Stars a specified repository (identified by owner and repo name) for the authenticated user; this action is idempotent and succeeds even if the repository is already starred. Requires explicit repository identification via owner and repo parameters."
      },
      {
        "slug": "GITHUB_START_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
        "name": "Start a codespace for the authenticated user",
        "description": "Initiates the startup process for an existing GitHub Codespace (identified by `codespace_name`) if it's in a startable state like 'Available' or 'Stopped'."
      },
      {
        "slug": "GITHUB_STOP_A_CODESPACE_FOR_AN_ORGANIZATION_USER",
        "name": "Stop a codespace for an organization user",
        "description": "Stops a running codespace for an organization member. This action allows organization administrators to stop a codespace that belongs to a member of their organization. The codespace must be in a running state (e.g., 'Available') to be stopped. Required permissions: - OAuth/PAT: admin:org scope - Fine-grained tokens: 'Organization codespaces' (write) or 'Codespaces lifecycle admin' (write) Common HTTP responses: - 200: Codespace successfully stopped, returns codespace object - 304: Not modified (codespace already stopped) - 401: Authentication required - 403: Insufficient permissions (need admin:org) - 404: Organization, user, or codespace not found"
      },
      {
        "slug": "GITHUB_STOP_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
        "name": "Stop a codespace for the authenticated user",
        "description": "Stops a running or available Codespace for the authenticated user, pausing its execution and billing."
      },
      {
        "slug": "GITHUB_SUBMIT_A_REVIEW_FOR_A_PULL_REQUEST",
        "name": "Submit a review for a pull request",
        "description": "Finalizes a pending pull request review (identified by `review_id`) with a required `event` (APPROVE, REQUEST_CHANGES, COMMENT) and an optional `body`."
      },
      {
        "slug": "GITHUB_SYNC_FORK_BRANCH_WITH_UPSTREAM",
        "name": "Sync a fork branch with the upstream repository",
        "description": "Synchronizes a branch in a forked GitHub repository with its upstream counterpart, assuming the repository is a fork, the branch exists, an upstream is configured, and the merge is conflict-free."
      },
      {
        "slug": "GITHUB_TEST_REPOSITORY_WEBHOOK",
        "name": "Test the push repository webhook",
        "description": "Triggers a simulated push event to test a repository's push webhook; a test event is only delivered if the webhook is subscribed to 'push' events, otherwise, it returns 204 No Content without sending a POST."
      },
      {
        "slug": "GITHUB_TRANSFER_A_REPOSITORY",
        "name": "Transfer a repository",
        "description": "Initiates a repository transfer to a new owner (who must accept the request); if the new owner is an organization, it must be configured to allow transfers."
      },
      {
        "slug": "GITHUB_UNBLOCK_A_USER",
        "name": "Unblock a user",
        "description": "Unblocks a GitHub user, provided they are currently blocked by the authenticated user."
      },
      {
        "slug": "GITHUB_UNBLOCK_USER_FROM_ORGANIZATION",
        "name": "Unblock a user from an organization",
        "description": "Unblocks a user from an organization, allowing renewed interaction with its resources, provided the user is currently blocked (otherwise, a 404 error may occur)."
      },
      {
        "slug": "GITHUB_UNFOLLOW_A_USER",
        "name": "Unfollow a user",
        "description": "Unfollows an existing GitHub user; this action is idempotent, succeeding even if the authenticated user is not currently following them."
      },
      {
        "slug": "GITHUB_UNFOLLOW_ORGANIZATION",
        "name": "Unfollow organization",
        "description": "Tool to unfollow a GitHub organization using GraphQL. Use when you need to stop following a specific organization on GitHub."
      },
      {
        "slug": "GITHUB_UNFOLLOW_USER",
        "name": "Unfollow user",
        "description": "Tool to unfollow a GitHub user using GraphQL. Use when you need to stop following a specific user on GitHub."
      },
      {
        "slug": "GITHUB_UNLOCK_AN_ISSUE",
        "name": "Unlock an issue",
        "description": "Unlocks a currently locked GitHub issue in the specified repository, allowing new comments and interactions."
      },
      {
        "slug": "GITHUB_UNLOCK_ORGANIZATION_REPOSITORY",
        "name": "Unlock an organization repository",
        "description": "Unlocks a repository that was locked for migration within a GitHub organization. This action is part of the organization migrations workflow. When you start a migration with `lock_repositories=true`, the source repositories are locked to prevent changes during export. After the migration is complete and applied to the target instance, use this action to unlock the repositories so they can be accessed or deleted. Requirements: - You must be an organization owner to unlock repositories - The repository must be currently locked as part of the specified migration - This endpoint does not work with GitHub App tokens or fine-grained personal access tokens Typical workflow: 1. Start an organization migration with POST /orgs/{org}/migrations 2. Wait for the migration to complete (state: \"exported\") 3. Apply the migration to your target instance 4. Unlock each migrated repository using this action 5. Delete the source repositories if no longer needed"
      },
      {
        "slug": "GITHUB_UNLOCK_USER_REPOSITORY",
        "name": "Unlock a user repository",
        "description": "Unlocks a repository (`repo_name`) that was locked as part of a user migration (`migration_id`), making it usable or deletable; this action requires the repository to be currently locked."
      },
      {
        "slug": "GITHUB_UNSTAR_A_GIST",
        "name": "Unstar a gist",
        "description": "Removes a star from the specified gist; the action is idempotent and will not error if the gist was not previously starred by the user."
      },
      {
        "slug": "GITHUB_UNSTAR_REPOSITORY",
        "name": "Unstar a repository",
        "description": "Removes the authenticated user's star from a specified repository, which must already be starred by the user."
      },
      {
        "slug": "GITHUB_UPDATE_A_CHECK_RUN",
        "name": "Update a check run",
        "description": "Updates an existing check run for a specific commit in a repository, allowing modifications to its status, conclusion, output, and other details. NOTE: This endpoint requires GitHub App authentication with 'checks:write' permission - OAuth tokens and personal access tokens cannot update check runs."
      },
      {
        "slug": "GITHUB_UPDATE_A_CODE_SCANNING_ALERT",
        "name": "Update a code scanning alert",
        "description": "Updates a specific code scanning alert in a GitHub repository, primarily to change its state (e.g., 'open' or 'dismissed')."
      },
      {
        "slug": "GITHUB_UPDATE_A_COMMIT_COMMENT",
        "name": "Update a commit comment",
        "description": "Changes the body of an existing commit comment."
      },
      {
        "slug": "GITHUB_UPDATE_A_CUSTOM_ORGANIZATION_ROLE",
        "name": "Update a custom organization role",
        "description": "Updates an existing custom role in an organization by modifying its name, description, or permissions; at least one of these fields must be provided."
      },
      {
        "slug": "GITHUB_UPDATE_A_DEPLOYMENT_BRANCH_POLICY",
        "name": "Update a deployment branch policy",
        "description": "Updates the name pattern of an existing deployment branch policy for a specific environment in a repository."
      },
      {
        "slug": "GITHUB_UPDATE_A_DISCUSSION",
        "name": "Update a discussion",
        "description": "Updates the title and/or body of a specific team discussion within an organization."
      },
      {
        "slug": "GITHUB_UPDATE_A_DISCUSSION_COMMENT",
        "name": "Update a discussion comment",
        "description": "Updates the body of a comment in a team's discussion within an organization."
      },
      {
        "slug": "GITHUB_UPDATE_A_GIST",
        "name": "Update a gist",
        "description": "Updates a gist's description, and/or its files (including content, filename changes, or deletion)."
      },
      {
        "slug": "GITHUB_UPDATE_A_GIST_COMMENT",
        "name": "Update a gist comment",
        "description": "Updates an existing comment on a specified gist."
      },
      {
        "slug": "GITHUB_UPDATE_A_LABEL",
        "name": "Update a label",
        "description": "Updates an existing label's name, color, or description within a specified repository."
      },
      {
        "slug": "GITHUB_UPDATE_A_MILESTONE",
        "name": "Update a milestone",
        "description": "Updates a milestone in a repository, identified by `owner`, `repo`, and `milestone_number`, by allowing modification of its `title`, `state`, `description`, or `due_on`; at least one of these four attributes must be provided to perform an update."
      },
      {
        "slug": "GITHUB_UPDATE_AN_ENVIRONMENT_VARIABLE",
        "name": "Update an environment variable",
        "description": "Updates an existing environment variable's name and/or value in a specific GitHub repository environment; requires providing either a new name or a new value."
      },
      {
        "slug": "GITHUB_UPDATE_AN_ISSUE",
        "name": "Update an issue",
        "description": "Updates an existing GitHub issue's title, body, state, milestone, labels, or assignees; `state_reason` is only processed if `state` also changes, and use `null` or `[]` to clear applicable fields."
      },
      {
        "slug": "GITHUB_UPDATE_AN_ISSUE_COMMENT",
        "name": "Update an issue comment",
        "description": "Updates an existing comment on an issue or pull request within a specified repository. You can only update comments that the authenticated user has permission to edit. The comment_id can be obtained from the list_issue_comments or get_an_issue_comment actions."
      },
      {
        "slug": "GITHUB_UPDATE_AN_ORGANIZATION",
        "name": "Update an organization",
        "description": "Updates an organization's settings; changing security-related fields requires admin, owner, or security manager permissions."
      },
      {
        "slug": "GITHUB_UPDATE_AN_ORGANIZATION_VARIABLE",
        "name": "Update an organization variable",
        "description": "Updates an existing GitHub Actions organization variable's name, value, or visibility (`all`, `private`, `selected`), requiring `selected_repository_ids` with valid repository IDs if visibility is `selected`."
      },
      {
        "slug": "GITHUB_UPDATE_AN_ORGANIZATION_WEBHOOK",
        "name": "Update an organization webhook",
        "description": "Updates the configuration (URL, content type, secret, SSL verification), subscribed events, active status, or name of an existing webhook for a specified organization."
      },
      {
        "slug": "GITHUB_UPDATE_A_PROJECT",
        "name": "Update a project",
        "description": "Updates an existing GitHub project (V2) attributes like title, description, visibility, and state. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed. At least one field to update must be provided."
      },
      {
        "slug": "GITHUB_UPDATE_A_PULL_REQUEST",
        "name": "Update a pull request",
        "description": "Updates an existing pull request, allowing changes to attributes like title, body, state, base branch, and maintainer modification settings."
      },
      {
        "slug": "GITHUB_UPDATE_A_PULL_REQUEST_BRANCH",
        "name": "Update a pull request branch",
        "description": "Updates an open pull request's head branch by merging the latest changes from its base branch, if mergeable and repository merging is enabled; operates asynchronously."
      },
      {
        "slug": "GITHUB_UPDATE_A_REFERENCE",
        "name": "Update a reference",
        "description": "Updates an existing Git reference (e.g., a branch or tag) to point to a specific commit SHA. By default, only allows fast-forward updates (where the new commit is a descendant of the current one). Set `force=true` to allow non-fast-forward updates that rewrite history. IMPORTANT: The reference must already exist - use 'Create a reference' action to create new refs."
      },
      {
        "slug": "GITHUB_UPDATE_A_RELEASE",
        "name": "Update a release",
        "description": "Updates an existing release in a GitHub repository, allowing modification of its attributes; if linking a discussion, the `discussion_category_name` must refer to an existing category in the repository."
      },
      {
        "slug": "GITHUB_UPDATE_A_RELEASE_ASSET",
        "name": "Update a release asset",
        "description": "Updates the name, label, or state of a release asset in a GitHub repository, requiring at least one of these properties to be provided for modification."
      },
      {
        "slug": "GITHUB_UPDATE_A_REPOSITORY",
        "name": "Update a repository",
        "description": "Updates settings for an existing GitHub repository, such as name, description, visibility, merge strategies, and security configurations."
      },
      {
        "slug": "GITHUB_UPDATE_A_REPOSITORY_INVITATION",
        "name": "Update a repository invitation",
        "description": "Updates an active repository invitation to modify the invited user's permissions; the specified repository and invitation must exist."
      },
      {
        "slug": "GITHUB_UPDATE_A_REPOSITORY_RULESET",
        "name": "Update a repository ruleset",
        "description": "Updates an existing repository ruleset, identified by `ruleset_id` for a given repository, allowing partial updates to its configuration such as name, target, enforcement, bypass actors, conditions, and rules."
      },
      {
        "slug": "GITHUB_UPDATE_A_REPOSITORY_VARIABLE",
        "name": "Update a repository variable",
        "description": "Updates the name and/or value of an existing GitHub Actions variable in a repository."
      },
      {
        "slug": "GITHUB_UPDATE_A_REPOSITORY_WEBHOOK",
        "name": "Update a repository webhook",
        "description": "Updates the URL, content type, secret, SSL verification, events, or active status for an existing repository webhook, specified by `owner`, `repo`, and `hook_id`."
      },
      {
        "slug": "GITHUB_UPDATE_A_TEAM",
        "name": "Update a team",
        "description": "Updates a team's settings (e.g., name, description, privacy, parent team) within a GitHub organization, identified by its slug and organization name."
      },
      {
        "slug": "GITHUB_UPDATE_BRANCH_PROTECTION",
        "name": "Update branch protection",
        "description": "Updates the protection settings for an existing branch in a repository, which must not contain wildcard characters."
      },
      {
        "slug": "GITHUB_UPDATE_CODE_SCANNING_DEFAULT_SETUP",
        "name": "Update a code scanning default setup configuration",
        "description": "Updates the default setup configuration for code scanning in a repository; GitHub Advanced Security must be enabled for the repository."
      },
      {
        "slug": "GITHUB_UPDATE_CODESPACE",
        "name": "Update a codespace for the authenticated user",
        "description": "Updates an existing GitHub Codespace's machine type, display name, or recent folders for the authenticated user; machine type changes take effect on the next start."
      },
      {
        "slug": "GITHUB_UPDATE_GIT_LFS_PREFERENCE",
        "name": "Update Git LFS Preference",
        "description": "Sets the Git Large File Storage (LFS) preference for a repository during a source import. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports."
      },
      {
        "slug": "GITHUB_UPDATE_ISSUE_TYPE",
        "name": "Update issue type",
        "description": "Update an existing issue type for a GitHub organization. Requires the authenticated user to be an organization administrator. OAuth tokens need admin:org scope."
      },
      {
        "slug": "GITHUB_UPDATE_ORGANIZATION_WEBHOOK_CONFIGURATION",
        "name": "Update a webhook configuration for an organization",
        "description": "Updates the configuration (URL, content type, secret, SSL verification) for an existing webhook within a specified organization."
      },
      {
        "slug": "GITHUB_UPDATE_PROJECT_CARD",
        "name": "Update an existing project card (Classic - Deprecated)",
        "description": "Updates an existing project card's note and/or archived status (GitHub Classic Projects). DEPRECATION NOTICE: GitHub Projects (classic) and its REST API were sunset on April 1, 2025. This action will return 404 for most requests on GitHub.com. However, it may still work on GitHub Enterprise Server instances where classic projects are enabled. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/"
      },
      {
        "slug": "GITHUB_UPDATE_PROJECT_COLUMN",
        "name": "Update an existing project column (Classic - Deprecated)",
        "description": "Updates the name of an existing column, identified by `column_id`, in a GitHub project (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/"
      },
      {
        "slug": "GITHUB_UPDATE_PULL_REQUEST_REVIEW",
        "name": "Update a review for a pull request",
        "description": "Updates the body text of an existing pull request review."
      },
      {
        "slug": "GITHUB_UPDATE_PULL_REQUEST_REVIEW_COMMENT",
        "name": "Update a review comment for a pull request",
        "description": "Updates the body of an existing review comment on a pull request."
      },
      {
        "slug": "GITHUB_UPDATE_PULL_REQUEST_REVIEW_PROTECTION",
        "name": "Update pull request review protection",
        "description": "Updates pull request review protection settings (e.g., required approvals, review dismissal, bypass allowances) for a branch; branch protection features must be available for the repository."
      },
      {
        "slug": "GITHUB_UPDATE_REPOSITORY_PREFERENCES_FOR_CHECK_SUITES",
        "name": "Update repository preferences for check suites",
        "description": "Updates repository preferences for automatic Check Suite creation on code pushes, allowing configuration for specific GitHub Apps that must be installed on the repository with `checks:write` permission."
      },
      {
        "slug": "GITHUB_UPDATE_REPOSITORY_WEBHOOK_CONFIGURATION",
        "name": "Update a webhook configuration for a repository",
        "description": "Updates the configuration (e.g., payload URL, content type, secret, SSL verification) for an existing webhook in a specified repository."
      },
      {
        "slug": "GITHUB_UPDATE_RESOURCE_ACCESS_WITH_TOKENS",
        "name": "Update resource access with tokens",
        "description": "Revokes organization access for the personal access tokens identified by `pat_ids`; this action must be performed by a GitHub App, and `pat_ids` must be valid and associated with the organization. AUTHENTICATION REQUIREMENT: This endpoint requires GitHub App authentication with 'Personal access tokens' organization permissions (write). Standard personal access tokens CANNOT use this endpoint. The GitHub App must also have access to the organization."
      },
      {
        "slug": "GITHUB_UPDATE_STATUS_CHECK_PROTECTION",
        "name": "Update status check protection",
        "description": "Updates required status checks for a branch, optionally requiring it to be up-to-date before merging."
      },
      {
        "slug": "GITHUB_UPDATE_SUBSCRIPTION",
        "name": "Update Subscription",
        "description": "Tool to update notification subscription state for issues, pull requests, or discussions. Use when you need to subscribe, unsubscribe, or ignore notifications for a specific GitHub item."
      },
      {
        "slug": "GITHUB_UPDATE_THE_AUTHENTICATED_USER",
        "name": "Update the authenticated user",
        "description": "Updates the authenticated user's GitHub profile; a new public email must be verified, and existing private emails remain private even if specified."
      },
      {
        "slug": "GITHUB_UPDATE_TOKEN_ORG_ACCESS",
        "name": "Revoke Token Organization Access",
        "description": "Revokes a fine-grained personal access token's access to an organization. IMPORTANT: This endpoint can ONLY be called by GitHub Apps with 'Personal access tokens' organization permissions (write). Personal access tokens (PATs) cannot use this endpoint. Use GITHUB_LIST_ORG_RESOURCE_ACCESS_TOKENS to get valid pat_id values for tokens that have access to your organization."
      },
      {
        "slug": "GITHUB_UPDATE_USER_LIST",
        "name": "Update User List",
        "description": "Tool to update an existing GitHub user list. Use when you need to modify the name, description, or privacy settings of a user list."
      },
      {
        "slug": "GITHUB_UPDATE_USER_LISTS_FOR_ITEM",
        "name": "Update user lists for item",
        "description": "Tool to update which of the viewer's lists an item belongs to on GitHub. Use when you need to add an item (repository, issue, pull request, etc.) to specific user lists or move it between lists."
      },
      {
        "slug": "GITHUB_UPDATE_USER_PROJECT_ITEM",
        "name": "Update Project V2 Item for User",
        "description": "Tool to update a field value for an item in a user's GitHub ProjectV2. Use when you need to modify a field value of an existing project item."
      },
      {
        "slug": "GITHUB_UPDATE_USER_STATUS",
        "name": "Change User Status",
        "description": "Tool to update your status on GitHub. Use when you need to set or clear your GitHub profile status with an emoji, message, and availability indicator."
      },
      {
        "slug": "GITHUB_UPLOAD_RELEASE_ASSET",
        "name": "Upload a release asset",
        "description": "Tool to upload a binary asset to an existing GitHub release. Use when you need to attach files like installers or backups to a release programmatically."
      },
      {
        "slug": "GITHUB_UPLOAD_SARIF_ANALYSIS",
        "name": "Upload an analysis as sarif data",
        "description": "Uploads a gzipped and Base64 encoded SARIF file to a GitHub repository for a specific commit and reference; use `checkout_uri` if SARIF paths are absolute."
      },
      {
        "slug": "GITHUB_UPSERT_REPO_CUSTOM_PROPERTY_VALUES",
        "name": "Create or update repository custom property values",
        "description": "Creates or updates up to 30 custom property values for a repository; custom properties must be predefined at the organization or repository level, and setting a property's value to `null` removes it."
      },
      {
        "slug": "GITHUB_VALIDATE_CREDENTIAL",
        "name": "Validate credential",
        "description": "Validates GitHub API credentials by checking if they can successfully authenticate. Use this action when you need to verify that API credentials are valid and have not expired or been revoked. Returns whether the credentials are valid along with the authenticated user's username."
      },
      {
        "slug": "GITHUB_VERIFY_DEV_CONTAINER_PERMISSIONS_ACCEPTED",
        "name": "Verify dev container permissions accepted",
        "description": "Verifies if the authenticated user has accepted permissions for a specific devcontainer configuration in a repository, typically to ensure awareness before a codespace is created or used."
      }
    ],
    "triggers": [
      {
        "slug": "GITHUB_ARTIFACT_CREATED_TRIGGER",
        "name": "New Workflow Artifact Created",
        "description": "Triggers when a new workflow artifact is created in a GitHub repository.\n\nMonitors for newly created GitHub Actions workflow artifacts. Optionally\nfilters by artifact name to restrict monitoring to specific artifacts."
      },
      {
        "slug": "GITHUB_BRANCH_CHANGED_TRIGGER",
        "name": "Branch Changed",
        "description": "Triggers when a GitHub branch changes.\n\nMonitors a specific branch for:\n- New commits pushed (head commit SHA changes)\n- Protection status toggled (branch becomes protected or unprotected)\n- Protection settings changed, including: required status checks and their\n  enforcement level, admin enforcement, required pull request reviews\n  (dismiss stale reviews, code owner reviews, approving review count,\n  last push approval), required linear history, force push allowance,\n  deletion allowance, conversation resolution, branch locking, and fork\n  syncing."
      },
      {
        "slug": "GITHUB_BRANCH_CREATED_TRIGGER",
        "name": "New Branch Created",
        "description": "Triggers when a new branch is created in a GitHub repository.\n\nDetects newly created branches. Deleted branches do not fire events."
      },
      {
        "slug": "GITHUB_CHECK_RUN_STATUS_CHANGED_TRIGGER",
        "name": "Check Run Status / Conclusion Changed",
        "description": "Triggers when a specific GitHub check run changes its status or conclusion.\n\nMonitors a single check run for changes to: status (queued, in_progress,\ncompleted, etc.), conclusion (success, failure, neutral, cancelled, skipped,\ntimed_out, action_required), started_at, and completed_at."
      },
      {
        "slug": "GITHUB_CHECK_SUITE_STATUS_CHANGED_TRIGGER",
        "name": "Check Suite Status / Conclusion Changed",
        "description": "Triggers when a GitHub check suite changes its status or conclusion for a given ref.\n\nMonitors all check suites associated with a git reference (branch, tag, or\ncommit SHA) for changes to status (queued, in_progress, completed, etc.) and\nconclusion (success, failure, neutral, cancelled, skipped, timed_out,\naction_required, startup_failure, stale). Optionally filters by GitHub App ID."
      },
      {
        "slug": "GITHUB_CODE_SCANNING_ALERT_CREATED_TRIGGER",
        "name": "New Code Scanning Alert Created",
        "description": "Triggers when a new code scanning alert is created in a repository.\n\nFires an event for each newly created code scanning alert detected in\nthe configured repository. Alerts can be filtered by Git reference,\nscanning tool, state, and severity. The payload includes the alert\nnumber, rule details, tool information, state, severity, and the\nlocation of the most recent instance."
      },
      {
        "slug": "GITHUB_COLLABORATOR_ADDED_TRIGGER",
        "name": "New Repository Collaborator Added",
        "description": "Triggers when a new collaborator is added to a GitHub repository.\n\nMonitors the full list of collaborators on a repository and fires an event\nfor each newly added collaborator. The payload includes the collaborator's\nGitHub username, account ID, profile URL, avatar URL, permission flags\n(pull, triage, push, maintain, admin), and assigned role name."
      },
      {
        "slug": "GITHUB_COMMIT_EVENT",
        "name": "Commit Event",
        "description": "Triggered when a new commit is pushed to a repository."
      },
      {
        "slug": "GITHUB_DEPLOYMENT_CREATED_TRIGGER",
        "name": "New Deployment Created",
        "description": "Triggers when a new deployment is created in a GitHub repository.\n\nFires an event for each newly created deployment detected in the\nconfigured repository. Deployments can optionally be filtered by target\nenvironment. The payload includes the deployment ID, commit SHA, ref,\ntask, environment, creator details, and timestamps."
      },
      {
        "slug": "GITHUB_DEPLOYMENT_STATE_CHANGED_TRIGGER",
        "name": "GitHub Deployment State Changed",
        "description": "Triggers when a specific GitHub deployment's fields change.\n\nMonitors the following aspects of a single deployment:\n- ``environment`` -- the target environment name\n- ``original_environment`` -- the original environment name before normalization\n- ``description`` -- the human-readable deployment description\n- ``task`` -- the deployment task name\n- ``sha`` -- the commit SHA being deployed\n- ``ref`` -- the branch, tag, or SHA reference being deployed\n- ``updated_at`` -- the last-updated timestamp\n- ``transient_environment`` -- whether the environment is temporary\n- ``production_environment`` -- whether this is a production deployment\n\nWhen any of these fields change, an event is emitted containing the full\ncurrent deployment details and a list of which fields changed."
      },
      {
        "slug": "GITHUB_DEPLOYMENT_STATUS_CREATED",
        "name": "New Deployment Status Created",
        "description": "Triggers when a new deployment status is created for a specific deployment.\n\nFires an event for each newly created deployment status on the monitored\ndeployment. Deployment statuses represent state transitions such as\npending, in_progress, success, failure, error, inactive, and queued.\nThe payload includes the status state, creator, environment, description,\ntimestamps, and relevant URLs."
      },
      {
        "slug": "GITHUB_FOLLOWER_EVENT",
        "name": "Follower Changes",
        "description": "Triggers when new followers are detected on your GitHub account."
      },
      {
        "slug": "GITHUB_GIT_REFERENCE_CREATED_TRIGGER",
        "name": "New Git Reference Created",
        "description": "Triggers when a new Git reference (branch or tag) matching a specified\nprefix is created in a repository.\n\nFires an event for each newly created branch or tag whose name matches\nthe configured prefix. Use ``ref_prefix`` to control what is monitored:\n- ``heads/`` to watch all branches\n- ``heads/feature/`` to watch only feature branches\n- ``tags/`` to watch all tags\n- ``tags/v`` to watch tags starting with 'v'\n\nThe payload includes the full reference name, node ID, the SHA and type\nof the Git object the reference points to, and the reference API URL."
      },
      {
        "slug": "GITHUB_ISSUE_ADDED_EVENT",
        "name": "Issue Added Event",
        "description": "Triggered when a new issue is added to the repository."
      },
      {
        "slug": "GITHUB_ISSUE_ASSIGNED_TO_ME_TRIGGER",
        "name": "New Issue Assigned to Me",
        "description": "Triggers when a new issue is assigned to the authenticated user.\n\nFires an event for each GitHub issue that is newly assigned to the\nauthenticated user. Pull requests are automatically excluded -- only\ntrue issues are emitted. Issues can optionally be filtered by labels\nand state. The payload includes the issue number, title, body, state,\nlabels, assignees, creator, repository details, and timestamps."
      },
      {
        "slug": "GITHUB_ISSUE_COMMENT_CHANGED_TRIGGER",
        "name": "GitHub Issue Comment Changed",
        "description": "Triggers when a specific GitHub issue comment changes.\n\nMonitors the following fields for changes:\n\n- ``body`` -- the text content of the comment (detects edits)\n- ``updated_at`` -- the last-updated timestamp\n- ``reactions_*`` -- all individual reaction counts (thumbs up/down,\n  laugh, confused, heart, hooray, eyes, rocket) and the total count\n\nWhen a change is detected, the payload includes the full current comment\ndata plus a ``changed_fields`` list indicating exactly which fields\nwere modified."
      },
      {
        "slug": "GITHUB_ISSUE_COMMENT_CREATED_TRIGGER",
        "name": "New GitHub Issue Comment",
        "description": "Triggers when a new comment is added to a specific GitHub issue.\n\nOnly genuinely new comments are emitted; edits to existing comments do\nnot produce duplicate events.  The payload includes the comment ID, text\nbody, author details, timestamps, and direct links to the comment on\nGitHub."
      },
      {
        "slug": "GITHUB_ISSUE_CREATED_TRIGGER",
        "name": "New Issue Created",
        "description": "Triggers when a new issue is created in a GitHub repository.\n\nPull requests are automatically excluded -- only true issues produce events.\nResults can be filtered by labels, assignee, creator, and mentioned user.\n\nThe payload includes the issue number, title, body, state, labels, assignees,\ncomment count, creator details, timestamps, and direct links to the issue on\nGitHub."
      },
      {
        "slug": "GITHUB_ISSUE_EVENT_OCCURRED_TRIGGER",
        "name": "New Issue Event",
        "description": "Triggers when a new issue event occurs in a GitHub repository.\n\nCovers all issue timeline events such as issues being closed, reopened,\nassigned, unassigned, labeled, unlabeled, milestoned, demilestoned,\nrenamed, locked, or unlocked.  Events can optionally be filtered by type.\n\nThe payload includes the event type, timestamp, the actor who triggered\nthe event, the affected issue details, and any associated commit\nreferences."
      },
      {
        "slug": "GITHUB_ISSUE_LABEL_CHANGED_TRIGGER",
        "name": "GitHub Issue Labels Changed",
        "description": "Triggers when the labels on a specific GitHub issue change.\n\nFires whenever a label is added to, removed from, or has its metadata\n(color, description) modified on the monitored issue.  The payload\nincludes:\n\n- ``current_labels`` -- the full set of labels currently on the issue\n- ``added_labels`` -- labels that were newly added\n- ``removed_label_names`` -- names of labels that were removed\n- ``changed_label_names`` -- labels whose metadata changed without\n  being added or removed"
      },
      {
        "slug": "GITHUB_ISSUE_STATE_CHANGED_TRIGGER",
        "name": "Issue State / Properties Changed",
        "description": "Triggers when a specific GitHub issue changes any of its tracked properties.\n\nMonitored properties: state (open/closed), state_reason, title, body,\nassignees, labels, milestone, lock status, active_lock_reason, comment\ncount, and closed_at timestamp.\n\nWhen a change is detected, the payload includes the full current issue\ndetails, the list of changed field names, and their previous values."
      },
      {
        "slug": "GITHUB_ISSUE_UPDATED_TRIGGER",
        "name": "Issue Updated",
        "description": "Triggers when an existing issue is updated in a GitHub repository.\n\nMonitors issues for any changes such as title edits, body edits, label changes,\nassignee changes, state transitions (opening, closing, reopening), milestone\nupdates, and comment additions. Only pre-existing issues that receive updates\nare emitted; newly created issues are excluded. Pull requests are also excluded\n-- only true issues fire events."
      },
      {
        "slug": "GITHUB_LABEL_ADDED_EVENT",
        "name": "Label Added Event",
        "description": "Triggered when a new label is added to a pull request."
      },
      {
        "slug": "GITHUB_NEW_STARGAZER_ADDED_TRIGGER",
        "name": "New Stargazer Added",
        "description": "Triggers when a new user stars a GitHub repository.\n\nEmits an event for each new stargazer detected on the monitored repository."
      },
      {
        "slug": "GITHUB_PR_REVIEW_COMMENT_CREATED_TRIGGER",
        "name": "New Pull Request Review Comment",
        "description": "Triggers when a new inline review comment is added to a specific GitHub\npull request.\n\nMonitors all review comments across all reviews on the specified pull request\nand emits an event for each newly created comment. Edits to existing comments\ndo not fire new events."
      },
      {
        "slug": "GITHUB_PULL_REQUEST_COMMIT_ADDED_TRIGGER",
        "name": "New Commit Added to Pull Request",
        "description": "Triggers when a new commit is pushed to a specific pull request.\n\nMonitors all commits on the specified pull request and emits an event for\neach newly added commit. This covers force-pushes and additional commits\npushed to the PR's head branch."
      },
      {
        "slug": "GITHUB_PULL_REQUEST_CREATED",
        "name": "New Pull Request Created",
        "description": "Triggers when a new pull request is created in GitHub, matching the\noptional configured filters.\n\nEmits an event for each newly created pull request. Supports filtering by\nrepository, owner/organisation, author, assignee, label, state, base branch,\nhead branch, and draft status."
      },
      {
        "slug": "GITHUB_PULL_REQUEST_EVENT",
        "name": "Pull Request Event",
        "description": "Triggered when a pull request is opened, closed, or synchronized."
      },
      {
        "slug": "GITHUB_PULL_REQUEST_REVIEWERS_CHANGED_TRIGGER",
        "name": "GitHub Pull Request Reviewers Changed",
        "description": "Triggers when the list of requested reviewers (users or teams) for a pull\nrequest changes — for example when a reviewer is added, removed, or\nre-requested.\n\nThe payload includes the full current reviewer list (users and teams with\ndetails), which reviewers were added, which were removed, and the previous\nreviewer list for reference."
      },
      {
        "slug": "GITHUB_PULL_REQUEST_REVIEW_SUBMITTED_TRIGGER",
        "name": "Pull Request Review Submitted",
        "description": "Triggers when a new review is submitted for a GitHub pull request.\n\nEmits an event for each newly submitted review on the monitored pull request,\ncovering all review types: APPROVED, CHANGES_REQUESTED, COMMENTED, and\nDISMISSED."
      },
      {
        "slug": "GITHUB_PULL_REQUEST_STATE_CHANGED_TRIGGER",
        "name": "Pull Request State / Properties Changed",
        "description": "Triggers when a specific GitHub pull request changes any of these tracked\nproperties: state (open/closed), title, body, draft status, lock status,\nmerge status, assignees, labels, requested reviewers, or milestone.\n\nThe payload includes the full current PR details, the list of changed field\nnames, and their previous values."
      },
      {
        "slug": "GITHUB_PULL_REQUEST_UPDATED",
        "name": "Pull Request Updated",
        "description": "Triggers when an existing pull request is updated in a GitHub repository.\n\nUpdates include title edits, description changes, label changes, assignee\nchanges, reviewer requests, draft status changes, base branch changes, being\nclosed, merged, or reopened. Only pre-existing PRs that receive an update\nwill fire the trigger; newly created PRs are excluded.\n\nSupports optional filters: state, base branch, head branch, author, label,\nand draft status."
      },
      {
        "slug": "GITHUB_README_CHANGED_TRIGGER",
        "name": "GitHub Repository README Changed",
        "description": "Triggers when the README file in a specific repository directory changes.\n\nMonitors the README in a configurable directory and branch/tag/commit. The\npayload includes the current README metadata (filename, path, SHA, size,\nURLs), the previous and current git blob SHAs, and a list of which tracked\nfields changed."
      },
      {
        "slug": "GITHUB_RELEASE_ASSET_ADDED_TRIGGER",
        "name": "New GitHub Release Asset Added",
        "description": "Triggers when a new asset is added to a specific GitHub release.\n\nMonitors a single release (identified by release ID) for newly uploaded\nassets such as binaries, archives, or checksum files. One event is emitted\nper new asset, containing full asset metadata."
      },
      {
        "slug": "GITHUB_RELEASE_STATE_CHANGED_TRIGGER",
        "name": "GitHub Release State Changed",
        "description": "Triggers when a specific GitHub release (identified by tag name) changes.\n\nMonitors the release title, body/notes, draft flag, prerelease flag,\npublished timestamp, target branch/commit, and the set of attached assets.\nThe payload includes the full current release details, a list of which\nfields changed, and the previous values for comparison."
      },
      {
        "slug": "GITHUB_REPOSITORY_CONTENT_CHANGED_TRIGGER",
        "name": "Repository Content Changed",
        "description": "Triggers when the content of a file or directory in a GitHub repository\nchanges.\n\nMonitors a specified path within a repository on a given branch or tag.\nFor a single file, fires ``content_changed`` when the file is modified.\nFor a directory, fires ``content_changed``, ``content_added``, or\n``content_removed`` for modified, new, or deleted entries respectively.\n\ncontent."
      },
      {
        "slug": "GITHUB_REPOSITORY_NOTIFICATION_RECEIVED_TRIGGER",
        "name": "Repository Notification Received",
        "description": "Triggers when a new or newly updated notification thread appears for a\nspecific GitHub repository.\n\nMonitors notifications for issues, pull requests, commits, releases,\ncheck suites, security alerts, and other repository activity. Supports\nfiltering by read/unread status and by direct participation.\n\nRequires a Personal Access Token (classic) with the ``notifications``"
      },
      {
        "slug": "GITHUB_REPOSITORY_TAG_CREATED_TRIGGER",
        "name": "New Repository Tag Created",
        "description": "Triggers when a new tag is created in a GitHub repository.\n\nMonitors the repository's tags and fires an event for each newly created\ntag. The payload includes the tag name, the commit SHA and URL it points\nto, and archive download URLs."
      },
      {
        "slug": "GITHUB_SECRET_SCANNING_ALERT_DETECTED_TRIGGER",
        "name": "New Secret Scanning Alert Detected",
        "description": "Triggers when a new secret scanning alert is detected in a GitHub repository.\n\nMonitors open secret scanning alerts and fires an event for each newly\ndetected alert. Supports filtering by secret type (e.g., personal access\ntokens, AWS keys) and by token validity status (active, inactive, unknown).\n\nThe payload includes the alert number, secret type, validity status,\nresolution state, timestamps, URLs, and flags for push protection bypass,\npublic exposure, and multi-repo detection."
      },
      {
        "slug": "GITHUB_STAR_ADDED_EVENT",
        "name": "Star Added Event",
        "description": "Triggered when a new star is added to the repository."
      },
      {
        "slug": "GITHUB_WORKFLOW_ADDED_TRIGGER",
        "name": "New GitHub Actions Workflow Added",
        "description": "Triggers when a new GitHub Actions workflow is added to a repository.\n\nMonitors a repository's GitHub Actions workflows and fires an event for\neach newly added workflow. The payload includes the workflow's name, file\npath, state, creation and update timestamps, and URLs for the API, web\ninterface, and status badge."
      },
      {
        "slug": "GITHUB_WORKFLOW_JOB_ADDED_TRIGGER",
        "name": "New Workflow Job Added",
        "description": "Triggers when a new job appears in a specific GitHub Actions workflow run.\n\nThis is useful for detecting matrix-expanded jobs that are added after the\ninitial workflow run creation, or any other scenario where jobs are\ndynamically added to an existing run."
      },
      {
        "slug": "GITHUB_WORKFLOW_JOB_STATE_CHANGED",
        "name": "Workflow Job State Changed",
        "description": "Triggers when the status, conclusion, timestamps, runner assignment, or step\ndetails of a specific GitHub Actions workflow job change between polls.\n\nThe payload includes the full current job state, a list of which fields\nchanged, and the previous status/conclusion values for easy comparison."
      },
      {
        "slug": "GITHUB_WORKFLOW_RUN_ARTIFACT_ADDED",
        "name": "New Artifact Added to Workflow Run",
        "description": "Triggers when a new artifact is uploaded to a specific GitHub Actions workflow run.\n\nMonitors a single workflow run for newly added artifacts such as build outputs,\ntest results, or coverage reports. Each new artifact detected fires a separate\nevent."
      },
      {
        "slug": "GITHUB_WORKFLOW_RUN_CREATED",
        "name": "New Workflow Run Created",
        "description": "Triggers when a new workflow run is created in a GitHub repository.\n\nMonitors the repository for any new workflow runs and fires an event for\neach one. Optional filters allow narrowing to a specific branch, actor,\nor event type."
      },
      {
        "slug": "GITHUB_WORKFLOW_RUN_STATE_CHANGED_TRIGGER",
        "name": "GitHub Workflow Run State Changed",
        "description": "Triggers when a GitHub Actions workflow run's status or conclusion changes.\n\nMonitors a single workflow run and fires an event whenever it transitions\nbetween states (e.g., queued to in_progress, or in_progress to completed)\nor when its conclusion is set (e.g., success, failure, cancelled)."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "github_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "repo,user,gist,notifications,project,workflow,codespace"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "googlecalendar",
    "name": "Google Calendar",
    "logo": "https://logos.composio.dev/api/googlecalendar",
    "description": "Google Calendar is a time management tool providing scheduling features, event reminders, and integration with email and other apps for streamlined organization",
    "category": "scheduling & booking",
    "authSchemes": [
      "OAUTH2"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 49,
    "triggerCount": 7,
    "version": "20260902_00",
    "tools": [
      {
        "slug": "GOOGLECALENDAR_ACL_DELETE",
        "name": "Delete ACL Rule",
        "description": "Deletes an access control rule from a Google Calendar. Use when you need to remove sharing permissions for a user, group, or domain."
      },
      {
        "slug": "GOOGLECALENDAR_ACL_GET",
        "name": "Get ACL Rule",
        "description": "Retrieves a specific access control rule for a calendar. Use when you need to check permissions for a specific user, group, or domain."
      },
      {
        "slug": "GOOGLECALENDAR_ACL_INSERT",
        "name": "Create ACL Rule",
        "description": "Creates an access control rule for a calendar. Use when you need to grant sharing permissions to a user, group, or domain."
      },
      {
        "slug": "GOOGLECALENDAR_ACL_LIST",
        "name": "List ACL Rules",
        "description": "Retrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary 'rule_id' values required for updating specific ACL rules."
      },
      {
        "slug": "GOOGLECALENDAR_ACL_PATCH",
        "name": "Patch ACL Rule",
        "description": "Updates an existing access control rule for a calendar using patch semantics (partial update). This allows modifying specific fields without affecting other properties. IMPORTANT: The ACL rule must already exist on the calendar. This action cannot create new rules. If you receive a 404 Not Found error, the rule does not exist - use ACL insert to create it first, or use ACL list to verify available rules. Each patch request consumes three quota units. For domain-type ACL rules, if PATCH fails with 500 error, this action will automatically fallback to UPDATE method."
      },
      {
        "slug": "GOOGLECALENDAR_ACL_UPDATE",
        "name": "Update ACL Rule",
        "description": "Updates an access control rule for the specified calendar."
      },
      {
        "slug": "GOOGLECALENDAR_ACL_WATCH",
        "name": "Watch ACL Changes",
        "description": "Tool to watch for changes to ACL resources. Use when you need to set up real-time notifications for access control list modifications on a calendar."
      },
      {
        "slug": "GOOGLECALENDAR_BATCH_EVENTS",
        "name": "Batch Events",
        "description": "Execute up to 1000 event mutations (create/patch/delete) in one Google Calendar HTTP batch request with per-item status/results. Use this to materially reduce round-trips for bulk operations like migrations, cleanup, or large-scale updates."
      },
      {
        "slug": "GOOGLECALENDAR_CALENDAR_LIST_DELETE",
        "name": "Remove Calendar from List",
        "description": "Tool to remove a calendar from the user's calendar list. Use when you need to unsubscribe from or hide a calendar from the user's list."
      },
      {
        "slug": "GOOGLECALENDAR_CALENDAR_LIST_GET",
        "name": "Get Single Calendar by ID",
        "description": "Retrieves metadata for a SINGLE specific calendar from the user's calendar list by its calendar ID. This action requires a calendarId parameter and returns details about that one calendar only. NOTE: This does NOT list all calendars. To list all calendars in the user's calendar list, use GOOGLECALENDAR_CALENDAR_LIST_LIST instead."
      },
      {
        "slug": "GOOGLECALENDAR_CALENDAR_LIST_INSERT",
        "name": "Insert Calendar into List",
        "description": "Inserts an existing calendar into the user's calendar list, making it visible in the UI. Calendars (e.g., newly created ones) won't appear in the list or UI until explicitly inserted."
      },
      {
        "slug": "GOOGLECALENDAR_CALENDAR_LIST_PATCH",
        "name": "Patch Calendar List Entry",
        "description": "Updates an existing calendar on the user's calendar list using patch semantics. This method allows partial updates, modifying only the specified fields."
      },
      {
        "slug": "GOOGLECALENDAR_CALENDAR_LIST_UPDATE",
        "name": "Update Calendar List Entry",
        "description": "Updates a calendar list entry's display/subscription settings (color, visibility, reminders, selection) for the authenticated user — does not modify the underlying calendar resource (title, timezone, etc.). To modify the calendar itself, use GOOGLECALENDAR_CALENDARS_UPDATE."
      },
      {
        "slug": "GOOGLECALENDAR_CALENDAR_LIST_WATCH",
        "name": "Watch Calendar List",
        "description": "Watch for changes to CalendarList resources using push notifications. Use this to receive real-time updates when calendar list entries are modified."
      },
      {
        "slug": "GOOGLECALENDAR_CALENDARS_DELETE",
        "name": "Delete Calendar",
        "description": "Deletes a secondary calendar that you own or have delete permissions on. Deletion is permanent and irreversible — verify the correct calendar_id before calling. You cannot delete your primary calendar or calendars you only have read/write access to. Use calendarList.list to find calendars with owner accessRole. For primary calendars, use calendars.clear instead. Parallel calls may trigger userRateLimitExceeded; sequence bulk deletions."
      },
      {
        "slug": "GOOGLECALENDAR_CALENDARS_UPDATE",
        "name": "Update Calendar",
        "description": "Full PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared. Use GOOGLECALENDAR_PATCH_CALENDAR to update only a subset of fields. Mutates the underlying calendar resource (title, description, timeZone, etc.); use GOOGLECALENDAR_CALENDAR_LIST_UPDATE to change per-user display properties like color."
      },
      {
        "slug": "GOOGLECALENDAR_CHANNELS_STOP",
        "name": "Stop Channel",
        "description": "Tool to stop watching resources through a notification channel. Use when you need to discontinue push notifications for a specific channel subscription."
      },
      {
        "slug": "GOOGLECALENDAR_CLEAR_CALENDAR",
        "name": "Clear Calendar",
        "description": "Clears a primary calendar by deleting all events from it. The calendar itself is preserved; only its events are removed. Primary calendars cannot be deleted entirely."
      },
      {
        "slug": "GOOGLECALENDAR_COLORS_GET",
        "name": "Get Color Definitions",
        "description": "Returns the color definitions for calendars and events. Use when you need to retrieve the available color palette for styling calendars or events."
      },
      {
        "slug": "GOOGLECALENDAR_CREATE_CALENDAR",
        "name": "Create a new calendar",
        "description": "Creates a new secondary Google Calendar with the specified title and optional settings. Use this action when you need to create a new calendar for organizing events separately from the primary calendar. The authenticated user becomes the owner of the newly created calendar. Optional parameters include description, location, and timezone."
      },
      {
        "slug": "GOOGLECALENDAR_CREATE_EVENT",
        "name": "Create Event",
        "description": "Create a Google Calendar event using start_datetime plus duration fields. The organizer is added as an attendee unless exclude_organizer is True. By default adds Google Meet link (works for Workspace, gracefully falls back for personal Gmail). Attendees can be email strings (required) or objects with email and optional fields. No conflict checking is performed; use GOOGLECALENDAR_FREE_BUSY_QUERY to detect overlaps before creating. Returns event id and htmlLink nested under data.response_data. Example: { \"start_datetime\": \"2025-01-16T13:00:00\", \"timezone\": \"America/New_York\", \"event_duration_hour\": 1, \"event_duration_minutes\": 30, \"summary\": \"Client sync\", \"attendees\": [\"[email protected]\", {\"email\": \"[email protected]\", \"optional\": true}] }"
      },
      {
        "slug": "GOOGLECALENDAR_DELETE_EVENT",
        "name": "Delete event",
        "description": "Deletes a specified event by `event_id` from a Google Calendar (`calendar_id`); idempotent — a 404 for an already-deleted event is a no-op. Bulk deletions may trigger `rateLimitExceeded` or `userRateLimitExceeded`; cap concurrency to 5–10 requests and apply exponential backoff."
      },
      {
        "slug": "GOOGLECALENDAR_DUPLICATE_CALENDAR",
        "name": "Create a calendar",
        "description": "Creates a new, empty Google Calendar with the specified title (summary). Newly created calendars default to UTC timezone; use GOOGLECALENDAR_PATCH_CALENDAR afterward to set the desired timeZone if needed."
      },
      {
        "slug": "GOOGLECALENDAR_EVENTS_GET",
        "name": "Get Event",
        "description": "Retrieves a SINGLE event by its unique event_id (REQUIRED). This action does NOT list or search events - it fetches ONE specific event when you already know its ID. If you want to list events within a time range, search for events, or filter by criteria like time_min/time_max, use GOOGLECALENDAR_EVENTS_LIST instead."
      },
      {
        "slug": "GOOGLECALENDAR_EVENTS_IMPORT",
        "name": "Import Event",
        "description": "Tool to import an event as a private copy to a calendar. Use when you need to add an existing event to a calendar using its iCalUID. Only events with eventType='default' can be imported."
      },
      {
        "slug": "GOOGLECALENDAR_EVENTS_INSTANCES",
        "name": "Get Event Instances",
        "description": "Returns instances of the specified recurring event. Use timeMin/timeMax to constrain the window; omitting bounds can return large result sets and is quota-heavy. On high-volume calls, 403 rateLimitExceeded or 429 too_many_requests may occur; apply exponential backoff (1s, 2s, 4s) before retrying."
      },
      {
        "slug": "GOOGLECALENDAR_EVENTS_LIST",
        "name": "List Events",
        "description": "Returns events on the specified calendar. TIMEZONE WARNING: When using timeMin/timeMax with UTC timestamps (ending in 'Z'), the time window is interpreted in UTC regardless of the calendar's timezone. For example, querying '2026-01-19T00:00:00Z' to '2026-01-20T00:00:00Z' on a calendar in America/Los_Angeles (UTC-8) covers 2026-01-18 4pm to 2026-01-19 4pm local time, potentially missing events on the intended local date. To query for a specific local date, use timestamps with the appropriate timezone offset in timeMin/timeMax (e.g., '2026-01-19T00:00:00-08:00' for PST)."
      },
      {
        "slug": "GOOGLECALENDAR_EVENTS_LIST_ALL_CALENDARS",
        "name": "List Events from All Calendars",
        "description": "Return a unified event list across all calendars in the user's calendar list for a given time range. Use when you need a single view of all events across multiple calendars. An inverted or incorrect time range silently returns empty results rather than an error. An empty `items` list means no events matched the filters—adjust `time_min`, `time_max`, or `q` before concluding no events exist."
      },
      {
        "slug": "GOOGLECALENDAR_EVENTS_MOVE",
        "name": "Move Event",
        "description": "Moves an event to another calendar, i.e., changes an event's organizer."
      },
      {
        "slug": "GOOGLECALENDAR_EVENTS_WATCH",
        "name": "Watch Events",
        "description": "Watch for changes to Events resources. Watch channels expire; persist the channel `id` per `calendarId` to re-establish watches after expiration or restarts."
      },
      {
        "slug": "GOOGLECALENDAR_FIND_EVENT",
        "name": "Find event",
        "description": "Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types. Ensure `timeMin` is not chronologically after `timeMax` if both are provided. Results may span multiple pages; always follow `nextPageToken` until absent to avoid silently missing events. Validate the correct match from results by checking summary, start.dateTime, and organizer.email before using event_id for mutations. An empty `items` array means no events matched — widen filters rather than treating it as an error."
      },
      {
        "slug": "GOOGLECALENDAR_FIND_FREE_SLOTS",
        "name": "Find free slots",
        "description": "Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range. If `time_min` is not provided, defaults to the current timestamp in the specified timezone. If `time_max` is not provided, defaults to 23:59:59 of the day specified in `time_min` (if provided), otherwise defaults to 23:59:59 of the current day in the specified timezone. Returns busy intervals and calculates free slots by finding gaps between busy periods; `time_min` must precede `time_max` if both are provided. This action retrieves free and busy time slots for the specified calendars over a given time period. It analyzes the busy intervals from the calendars and provides calculated free slots based on the gaps in the busy periods. Returned free slots are unfiltered by duration; callers must filter intervals to those fully containing the required meeting length. No event metadata (titles, descriptions, links) is returned; use GOOGLECALENDAR_EVENTS_LIST for event details."
      },
      {
        "slug": "GOOGLECALENDAR_FREE_BUSY_QUERY",
        "name": "Query Free/Busy Information (Deprecated)",
        "description": "DEPRECATED: Use GOOGLECALENDAR_FIND_FREE_SLOTS instead (though this tool provides wider secondary/shared calendar coverage). Returns opaque busy intervals only—no event titles or details; use GOOGLECALENDAR_EVENTS_LIST when event details are needed."
      },
      {
        "slug": "GOOGLECALENDAR_GET_CALENDAR",
        "name": "Get Google Calendar",
        "description": "Retrieves a specific Google Calendar, identified by `calendar_id`, to which the authenticated user has access. Response includes `timeZone` (IANA format, e.g., 'America/Los_Angeles') — use it directly when constructing `timeMin`/`timeMax` in other tools to avoid DST errors. An empty `defaultReminders` list is valid (no defaults configured). Insufficient `accessRole` may omit fields like `defaultReminders` and `colorId`."
      },
      {
        "slug": "GOOGLECALENDAR_GET_CALENDAR_PROFILE",
        "name": "Get Calendar Profile (Deprecated)",
        "description": "DEPRECATED: Use CalendarListGet instead. Tool to retrieve the authenticated user's primary calendar profile. Use when you need to get information about the user's main calendar, including timezone, settings, and preferences."
      },
      {
        "slug": "GOOGLECALENDAR_GET_CURRENT_DATE_TIME",
        "name": "Get current date and time",
        "description": "Gets the current date and time, allowing for a specific timezone offset. Call this tool first before computing relative dates (e.g., 'tomorrow', 'next Monday') to avoid off-by-one-day errors across timezones."
      },
      {
        "slug": "GOOGLECALENDAR_LIST_BUILDINGS",
        "name": "List Buildings",
        "description": "Lists all buildings for a Google Workspace customer account with full details including addresses, coordinates, and floor names. Use this action when you need to retrieve the complete list of physical building locations configured in Google Workspace Calendar resources. This is useful for workspace administrators managing conference room and resource scheduling across multiple office buildings. Requires Google Workspace administrator privileges with Directory API access."
      },
      {
        "slug": "GOOGLECALENDAR_LIST_CALENDAR_RESOURCES",
        "name": "List Calendar Resources",
        "description": "Retrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API. Use this action when you need to list available meeting rooms, conference spaces, or other bookable calendar resources in an organization. The action supports filtering by resource category, capacity, building location, and other criteria. IMPORTANT: This requires Admin SDK Directory API access and appropriate admin permissions - it is NOT available for personal Gmail accounts, only Google Workspace domains."
      },
      {
        "slug": "GOOGLECALENDAR_LIST_CALENDARS",
        "name": "List Google Calendars",
        "description": "Retrieves calendars from the user's Google Calendar list, with options for pagination and filtering. Loop through all pages using nextPageToken until absent to avoid missing calendars. Use the primary flag and accessRole field from the response to identify calendars — display names are not valid calendar_id values. Read access (listing) does not imply write OAuth scopes."
      },
      {
        "slug": "GOOGLECALENDAR_LIST_SETTINGS",
        "name": "List Calendar Settings (Deprecated)",
        "description": "DEPRECATED: Use GOOGLECALENDAR_SETTINGS_LIST instead. Tool to return all user settings for the authenticated user. Use when you need to retrieve calendar settings."
      },
      {
        "slug": "GOOGLECALENDAR_PATCH_CALENDAR",
        "name": "Patch Calendar",
        "description": "Partially updates (PATCHes) an existing Google Calendar, modifying only the fields provided. At least one of summary, description, location, or timezone must be provided. Empty strings for `description` or `location` clear them."
      },
      {
        "slug": "GOOGLECALENDAR_PATCH_EVENT",
        "name": "Patch Event",
        "description": "Update specified fields of an existing event in a Google Calendar using patch semantics (array fields like `attendees` are fully replaced if provided); ensure the `calendar_id` and `event_id` are valid and the user has write access to the calendar."
      },
      {
        "slug": "GOOGLECALENDAR_QUICK_ADD",
        "name": "Quick Add Event",
        "description": "Parses natural language text to quickly create a basic Google Calendar event with its title, date, and time, suitable for simple scheduling; does not support direct attendee addition or recurring events, and `calendar_id` must be valid if not 'primary'."
      },
      {
        "slug": "GOOGLECALENDAR_REMOVE_ATTENDEE",
        "name": "Remove attendee from event",
        "description": "Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist. Concurrent calls on the same event can overwrite attendee lists — apply changes sequentially per event."
      },
      {
        "slug": "GOOGLECALENDAR_SETTINGS_GET",
        "name": "Get Calendar Setting",
        "description": "Tool to return a single user setting for the authenticated user. Use when you need to retrieve a specific calendar setting value."
      },
      {
        "slug": "GOOGLECALENDAR_SETTINGS_LIST",
        "name": "List Settings",
        "description": "Returns all user settings for the authenticated user. Results include multiple settings keyed by id (e.g., `timeZone`); locate a specific setting by its `id` field. `timeZone` values are IANA identifiers (e.g., `America/New_York`) — use directly in datetime and event logic; align with `timeZone` from GOOGLECALENDAR_GET_CALENDAR for consistent notification times."
      },
      {
        "slug": "GOOGLECALENDAR_SETTINGS_WATCH",
        "name": "Watch Settings",
        "description": "Watch for changes to Settings resources."
      },
      {
        "slug": "GOOGLECALENDAR_SYNC_EVENTS",
        "name": "Sync Events (Deprecated)",
        "description": "DEPRECATED: Use GOOGLECALENDAR_EVENTS_LIST instead. EventsList already handles syncToken with automatic param stripping. Synchronizes Google Calendar events, performing a full sync if no `sync_token` is provided or if a 410 GONE error (due to an expired token) necessitates it, otherwise performs an incremental sync for events changed since the `sync_token` was issued."
      },
      {
        "slug": "GOOGLECALENDAR_UPDATE_EVENT",
        "name": "Update Google event",
        "description": "Updates an existing event in Google Calendar. REQUIRES event_id - you MUST first search for the event using GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to obtain the event_id. This is a full PUT replacement: omitted fields (including attendees, reminders, recurrence, conferencing) are cleared. Always provide the complete desired event state. Use GOOGLECALENDAR_PATCH_EVENT instead for partial edits."
      }
    ],
    "triggers": [
      {
        "slug": "GOOGLECALENDAR_ATTENDEE_RESPONSE_CHANGED_TRIGGER",
        "name": "Attendee Response Changed",
        "description": "Polling trigger that fires when any attendee's RSVP changes to\naccepted, declined, or tentative. Returns attendee info and current status."
      },
      {
        "slug": "GOOGLECALENDAR_EVENT_CANCELED_DELETED_TRIGGER",
        "name": "Event Canceled or Deleted",
        "description": "Triggers when a Google Calendar event is cancelled or deleted.\nReturns minimal data: event_id, summary (if available), and cancellation timestamp."
      },
      {
        "slug": "GOOGLECALENDAR_EVENT_STARTING_SOON_TRIGGER",
        "name": "Event Starting Soon",
        "description": "Triggers when a calendar event is within a configured number of minutes from starting.\nReturns event details, time remaining, attendees, and join links when available."
      },
      {
        "slug": "GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CHANGE_TRIGGER",
        "name": "Calendar Event Changes",
        "description": "**SOON TO BE DEPRECATED** - Use Calendar Event Sync (polling trigger) instead.\nReal-time webhook trigger for calendar event changes. Returns event metadata only.\nFor full event data, use Calendar Event Sync (polling trigger)."
      },
      {
        "slug": "GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CREATED_TRIGGER",
        "name": "Event Created",
        "description": "Polling trigger that fires when a new calendar event is created.\nReturns event ID, summary, start/end times, and organizer info."
      },
      {
        "slug": "GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_SYNC_TRIGGER",
        "name": "Calendar Event Sync",
        "description": "Polling trigger that returns full event data including details, attendees, and metadata.\nFor real-time notifications with basic info, use Calendar Event Changes (webhook)."
      },
      {
        "slug": "GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_UPDATED_TRIGGER",
        "name": "Event Updated",
        "description": "Triggers when an existing Google Calendar event is modified. Returns the event ID,\nchange type, and the specific fields that changed with their previous and new values."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "googlecalendar_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/calendar.events"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "notion",
    "name": "Notion",
    "logo": "https://logos.composio.dev/api/notion",
    "description": "Notion centralizes notes, docs, wikis, and tasks in a unified workspace, letting teams build custom workflows for collaboration and knowledge management",
    "category": "notes",
    "authSchemes": [
      "OAUTH2",
      "API_KEY"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 56,
    "triggerCount": 8,
    "version": "20260819_00",
    "tools": [
      {
        "slug": "NOTION_ADD_MULTIPLE_PAGE_CONTENT",
        "name": "Add multiple content blocks (bulk, user-friendly)",
        "description": "Bulk-add content blocks to Notion. Text >2000 chars auto-splits. Parses markdown formatting. ⚠️ PARENT BLOCK TYPES: Content is added AS CHILDREN of parent_block_id. - To add content AFTER a heading, use PAGE ID as parent + heading ID in 'after' param. - Headings CANNOT have children unless is_toggleable=True. Simplified format: {'content': 'text', 'block_property': 'paragraph'} Full format for code: {'type': 'code', 'code': {'rich_text': [...], 'language': 'python'}} Array format also supported (auto-normalized): [{\"parent_block_id\": \"...\"}, {block1}, {block2}] => proper request structure"
      },
      {
        "slug": "NOTION_ADD_PAGE_CONTENT",
        "name": "Add single content block to Notion page (Deprecated)",
        "description": "DEPRECATED: Use 'add_multiple_page_content' for better performance. Adds a single content block to a Notion page/block. CRITICAL: Notion API enforces a HARD LIMIT of 2000 characters per text.content field. Content exceeding 2000 chars is AUTOMATICALLY SPLIT into multiple sequential blocks. REQUIRED 'content' field for text blocks: paragraph, heading_1-3, callout, to_do, toggle, quote, list items. Parent blocks MUST be: Page, Toggle, To-do, Bulleted/Numbered List Item, Callout, or Quote. Common errors: - \"content.length should be ≤ 2000\": Text exceeds API limit (should be auto-handled) - \"Content is required for paragraph blocks\": Missing 'content' field for text blocks - \"object_not_found\": Invalid parent_block_id or no integration access For bulk operations, use 'add_multiple_page_content' instead."
      },
      {
        "slug": "NOTION_APPEND_BLOCK_CHILDREN",
        "name": "Append raw Notion blocks (advanced API)",
        "description": "DEPRECATED: Use NOTION_APPEND_TEXT_BLOCKS, NOTION_APPEND_TASK_BLOCKS, NOTION_APPEND_CODE_BLOCKS, NOTION_APPEND_MEDIA_BLOCKS, NOTION_APPEND_LAYOUT_BLOCKS, or NOTION_APPEND_TABLE_BLOCKS instead. Appends raw Notion API blocks to parent. Text limited to 2000 chars per text.content field. Each block MUST have 'object':'block' and 'type'. Use rich_text arrays for text blocks."
      },
      {
        "slug": "NOTION_APPEND_CODE_BLOCKS",
        "name": "Append code blocks (code, quote, equation)",
        "description": "Append code and technical blocks (code, quote, equation) to a Notion page. Use for: - Code snippets and programming examples (code) - Citations and highlighted quotes (quote) - Mathematical formulas and equations (equation) Supported block types: - code: Code with syntax highlighting (70+ languages including Python, JavaScript, Go, Rust, etc.) - quote: Block quotes for citations - equation: LaTeX/KaTeX mathematical expressions ⚠️ Code content is limited to 2000 characters per text.content field. For longer code, split into multiple code blocks. For other block types, use specialized actions: - append_text_blocks: paragraphs, headings, lists - append_task_blocks: to-do, toggle, callout - append_media_blocks: image, video, audio, files - append_layout_blocks: divider, columns, TOC - append_table_blocks: tables"
      },
      {
        "slug": "NOTION_APPEND_LAYOUT_BLOCKS",
        "name": "Append layout blocks (divider, TOC, columns)",
        "description": "Append layout blocks (divider, TOC, breadcrumb, columns) to a Notion page. Supported types: - divider: Horizontal line separator - table_of_contents: Auto-generated from headings - breadcrumb: Page hierarchy navigation - column_list: Multi-column layout (requires 2+ columns, each with 1+ child block) For multi-column layouts, create column_list with column children in one request. Each column must contain at least 1 child block. For other blocks, use: append_text_blocks, append_task_blocks, append_code_blocks, append_media_blocks, or append_table_blocks."
      },
      {
        "slug": "NOTION_APPEND_MEDIA_BLOCKS",
        "name": "Append media blocks (image, video, audio, files)",
        "description": "Append media blocks (image, video, audio, file, pdf, embed, bookmark) to a Notion page. Use for: - Images and screenshots (image) - YouTube/Vimeo videos or direct video URLs (video) - Audio files and podcasts (audio) - File downloads (file) - PDF documents (pdf) - Embedded content from Twitter, Figma, CodePen, etc. (embed) - Link previews with metadata (bookmark) All media blocks require external URLs. For other block types, use specialized actions: - append_text_blocks: paragraphs, headings, lists - append_task_blocks: to-do, toggle, callout - append_code_blocks: code, quote, equation - append_layout_blocks: divider, columns, TOC - append_table_blocks: tables"
      },
      {
        "slug": "NOTION_APPEND_TABLE_BLOCKS",
        "name": "Append table blocks",
        "description": "Append table blocks to a Notion page. Use for structured tabular data like spreadsheets, comparison charts, and status trackers. Example: { \"table_width\": 3, \"has_column_header\": true, \"rows\": [ {\"cells\": [[{\"type\": \"text\", \"text\": {\"content\": \"Col1\"}}], [...], [...]]} ] } ⚠️ Cell content limited to 2000 chars per text.content field."
      },
      {
        "slug": "NOTION_APPEND_TASK_BLOCKS",
        "name": "Append task blocks (to-do, toggle, callout)",
        "description": "Append task blocks (to-do, toggle, callout) to a Notion page or block. Supported block types: - to_do: Checkbox items (checkable/uncheckable) - toggle: Collapsible sections - callout: Highlighted boxes with emoji icons All three types support nested children (up to 2 levels of nesting). block_id must be a page or block that supports children (e.g., page, toggle, paragraph, list items, quote, callout, to_do). Blocks like divider, breadcrumb, equation do NOT support children. Limits: 2000 chars per text.content, max 100 blocks per request. For other blocks: append_text_blocks, append_code_blocks, append_media_blocks, append_layout_blocks, append_table_blocks."
      },
      {
        "slug": "NOTION_APPEND_TEXT_BLOCKS",
        "name": "Append text blocks (paragraphs, headings, lists)",
        "description": "Append text blocks (paragraphs, headings, lists) to a Notion page. This is the most commonly used action for adding content to Notion. Use for: documentation, notes, articles, outlines, lists. Supported block types: - paragraph: Regular text - heading_1, heading_2, heading_3: Section headers - bulleted_list_item: Bullet points - numbered_list_item: Numbered lists ⚠️ Text content is limited to 2000 characters per text.content field. For other block types, use specialized actions: - append_task_blocks: to-do, toggle, callout - append_code_blocks: code, quote, equation - append_media_blocks: image, video, audio, files - append_layout_blocks: divider, columns, TOC - append_table_blocks: tables"
      },
      {
        "slug": "NOTION_ARCHIVE_NOTION_PAGE",
        "name": "Archive Notion Page",
        "description": "Archives (moves to trash) or unarchives (restores from trash) a specified Notion page. Limitation: Workspace-level pages (top-level pages with no parent page or database) cannot be archived via the API and must be archived manually in the Notion UI."
      },
      {
        "slug": "NOTION_CREATE_COMMENT",
        "name": "Create comment",
        "description": "Adds a comment to a Notion page (via `parent_page_id`) OR to an existing discussion thread (via `discussion_id`); cannot create new discussion threads on specific blocks (inline comments)."
      },
      {
        "slug": "NOTION_CREATE_DATABASE",
        "name": "Create Notion Database",
        "description": "Creates a new Notion database as a subpage under a specified parent page with a defined properties schema. IMPORTANT NOTES: - The parent page MUST be shared with your integration, otherwise you'll get a 404 error - If you encounter conflict errors (409), retry the request as Notion may experience temporary save conflicts - For relation properties, you MUST provide the database_id of the related database - Parent ID must be a valid UUID format (with or without hyphens), not a template variable Use this action exclusively for creating new databases."
      },
      {
        "slug": "NOTION_CREATE_FILE_UPLOAD",
        "name": "Create Notion file upload",
        "description": "Tool to create a Notion FileUpload object and retrieve an upload URL. Use when you need to automate attaching local or external files directly into Notion without external hosting."
      },
      {
        "slug": "NOTION_CREATE_NOTION_PAGE",
        "name": "Create Notion page",
        "description": "Creates a new page in a Notion workspace under a specified parent page or database. Supports creating pages with markdown content using the native markdown parameter, or as an empty page that can be populated later. PREREQUISITES: - Parent page/database must exist and be accessible in your Notion workspace - Use search_pages or list_databases first to obtain valid parent IDs LIMITATIONS: - Cannot create root-level pages (must have a parent) - May encounter conflicts if creating pages too quickly - Title-based parent search is less reliable than using UUIDs - The markdown parameter is mutually exclusive with children/content parameters"
      },
      {
        "slug": "NOTION_CREATE_VIEW",
        "name": "Create Notion view",
        "description": "Create a Notion view."
      },
      {
        "slug": "NOTION_CREATE_VIEW_QUERY",
        "name": "Create Notion view query",
        "description": "Create a Notion view query and return the first page of page references."
      },
      {
        "slug": "NOTION_DELETE_BLOCK",
        "name": "Delete a block",
        "description": "Archives a Notion block, page, or database using its ID, which sets its 'archived' property to true (like moving to \"Trash\" in the UI) and allows it to be restored later. Note: This operation will fail if the block has an archived parent or ancestor in the hierarchy. You must unarchive the ancestor before archiving/deleting its descendants. IMPORTANT LIMITATION: Workspace-level pages (top-level pages that are direct children of the workspace, not contained within other pages or databases) cannot be archived via the Notion API. This is a documented Notion API restriction. Only pages that are children of other pages or databases can be deleted through this action."
      },
      {
        "slug": "NOTION_DELETE_VIEW",
        "name": "Delete Notion view",
        "description": "Delete a Notion view."
      },
      {
        "slug": "NOTION_DELETE_VIEW_QUERY",
        "name": "Delete Notion view query",
        "description": "Delete a cached Notion view query."
      },
      {
        "slug": "NOTION_DUPLICATE_PAGE",
        "name": "Duplicate page",
        "description": "Duplicates a Notion page, including all its content, properties, and nested blocks, under a specified parent page or workspace."
      },
      {
        "slug": "NOTION_FETCH_ALL_BLOCK_CONTENTS",
        "name": "Fetch All Notion Block Contents",
        "description": "Tool to fetch all child blocks for a given Notion block. Use when you need a complete listing of a block's children beyond a single page; supports optional recursive expansion of nested blocks."
      },
      {
        "slug": "NOTION_FETCH_BLOCK_CONTENTS",
        "name": "Fetch Notion Block Children",
        "description": "Retrieves a paginated list of direct, first-level child block objects along with contents for a given parent Notion block or page ID; use block IDs from the response for subsequent calls to access deeply nested content."
      },
      {
        "slug": "NOTION_FETCH_BLOCK_METADATA",
        "name": "Fetch Notion block metadata",
        "description": "Fetches metadata for a Notion block (including pages, which are special blocks) using its UUID. Returns block type, properties, and basic info but not child content. Prerequisites: 1) Block/page must be shared with your integration, 2) Use valid block_id from API responses (not URLs). For child blocks, use fetch_block_contents instead. Common 404 errors mean the block isn't accessible to your integration."
      },
      {
        "slug": "NOTION_FETCH_COMMENTS",
        "name": "Fetch comments",
        "description": "Fetches unresolved comments for a specified Notion block or page ID. The block/page must be shared with your Notion integration and the integration must have 'Read comments' capability enabled, otherwise a 404 error will be returned."
      },
      {
        "slug": "NOTION_FETCH_DATA",
        "name": "Fetch Notion Data",
        "description": "Fetches Notion items (pages and/or databases) from the Notion workspace, use this to get minimal data about the items in the workspace with a query or list all items in the workspace with minimal data"
      },
      {
        "slug": "NOTION_FETCH_DATABASE",
        "name": "Fetch Database",
        "description": "Fetches a Notion database's structural metadata (properties, title, etc.) via its `database_id`, not the data entries; `database_id` must reference an existing database."
      },
      {
        "slug": "NOTION_FETCH_ROW",
        "name": "Fetch database row",
        "description": "Retrieves a Notion database row's properties and metadata; use fetch_block_contents for page content blocks."
      },
      {
        "slug": "NOTION_GET_ABOUT_ME",
        "name": "Get About Me (Deprecated)",
        "description": "DEPRECATED: Use GetAboutUser instead. Retrieves the User object for the bot associated with the current Notion integration token, typically to obtain the bot's user ID for other API operations."
      },
      {
        "slug": "NOTION_GET_ABOUT_USER",
        "name": "Get about user",
        "description": "Retrieves detailed information about a specific Notion user, such as their name, avatar, and email, based on their unique user ID."
      },
      {
        "slug": "NOTION_GET_PAGE_MARKDOWN",
        "name": "Get page markdown",
        "description": "Retrieve a Notion page's full content rendered as Notion-flavored Markdown in a single API call. Use when you need the readable content of a page without recursive block-children fetching."
      },
      {
        "slug": "NOTION_GET_PAGE_PROPERTY_ACTION",
        "name": "Get page property",
        "description": "Call this to get a specific property from a Notion page when you have a valid `page_id` and `property_id`; handles pagination for properties returning multiple items."
      },
      {
        "slug": "NOTION_GET_VIEW_QUERY_RESULTS",
        "name": "Get Notion view query results",
        "description": "Get a page of results from a cached Notion view query."
      },
      {
        "slug": "NOTION_INSERT_ROW_DATABASE",
        "name": "Insert row database",
        "description": "Creates a new page (row) in a specified Notion database. Prerequisites: - Database must be shared with your integration - Property names AND types must match schema exactly (case-sensitive) - Use NOTION_FETCH_DATA with fetch_type='databases' first to get exact property names and types - Each database has ONE 'title' property; other text fields are 'rich_text' - Database must NOT have multiple data sources (synced databases are not supported) Common Errors: - 404: Database not shared with integration - 400 \"not a property\": Wrong property name - 400 \"expected to be X\": Wrong property type - 400 \"multiple_data_sources\": Database uses multiple data sources (not supported) Note: Rich text content in child_blocks is automatically truncated to 2000 characters per Notion API limits."
      },
      {
        "slug": "NOTION_INSERT_ROW_FROM_NL",
        "name": "Insert Row From Natural Language",
        "description": "Creates a new row (page) in a Notion database from a natural language description. Fetches the database schema at runtime, uses an LLM to generate the correctly-formatted property payload, and creates the page."
      },
      {
        "slug": "NOTION_LIST_DATA_SOURCE_TEMPLATES",
        "name": "List data source templates",
        "description": "Tool to list all templates for a Notion data source. Use when needing to discover template IDs/names for bulk page creation. Use after confirming the data_source_id."
      },
      {
        "slug": "NOTION_LIST_FILE_UPLOADS",
        "name": "List Notion file uploads",
        "description": "Tool to retrieve file uploads for the current bot integration, sorted by most recent first. Use when you need to list all file uploads or paginate through file upload history."
      },
      {
        "slug": "NOTION_LIST_USERS",
        "name": "List users",
        "description": "Retrieves a paginated list of users (excluding guests) from the Notion workspace; the number of users returned per page may be less than the requested `page_size`."
      },
      {
        "slug": "NOTION_LIST_VIEWS",
        "name": "List Notion views",
        "description": "List Notion views for a database or data source."
      },
      {
        "slug": "NOTION_MOVE_PAGE",
        "name": "Move Page",
        "description": "Tool to move a Notion page to a new parent (page or database). Use when you need to reorganize page hierarchy. Important: To move to a database, use data_source_id (NOT database_id). Get the data source ID from the database object using NOTION_FETCH_DATABASE."
      },
      {
        "slug": "NOTION_QUERY_DATABASE",
        "name": "Query database",
        "description": "Queries a Notion database to retrieve pages (rows). In Notion, databases are collections where each row is a page and columns are properties. Returns paginated results with metadata. Important requirements: - The database must be shared with your integration - Property names in sorts must match existing database properties exactly (case-sensitive) - For timestamp sorting, use 'created_time' or 'last_edited_time' (case-insensitive) - The start_cursor must be the opaque value from a previous response's next_cursor field - Database IDs must be valid 32-character UUIDs (with or without hyphens) Use this action to: - Retrieve all or filtered database entries - Sort results by database properties or page timestamps - Paginate through large result sets - Get database content for processing or display"
      },
      {
        "slug": "NOTION_QUERY_DATABASE_WITH_FILTER",
        "name": "Query database with filter",
        "description": "Tool to query a Notion database with server-side filtering, sorting, and pagination. Use when you need to retrieve a subset of rows by property, date, status, or other conditions."
      },
      {
        "slug": "NOTION_QUERY_DATA_SOURCE",
        "name": "Query data source",
        "description": "Tool to query a Notion data source. Use when you need to retrieve pages or child data sources with filters, sorts, and pagination. Make paginated requests using cursors and optional property filters for efficient data retrieval."
      },
      {
        "slug": "NOTION_REPLACE_PAGE_CONTENT",
        "name": "Replace page content (with backup)",
        "description": "Safely replaces a page's child blocks by optionally backing up current content, deleting existing children, then appending new children in batches. Use when you need to rebuild a page without leaving partial states. Notion does not provide atomic transactions; this tool orchestrates a multi-step workflow with optional backup to reduce risk."
      },
      {
        "slug": "NOTION_RETRIEVE_COMMENT",
        "name": "Retrieve Comment",
        "description": "Tool to retrieve a specific comment by its ID. Use when you have a comment ID and need to fetch its details."
      },
      {
        "slug": "NOTION_RETRIEVE_DATABASE_PROPERTY",
        "name": "Retrieve Database Property",
        "description": "Tool to retrieve a specific property object of a Notion database. Use when you need to get details about a single database column/property."
      },
      {
        "slug": "NOTION_RETRIEVE_FILE_UPLOAD",
        "name": "Retrieve Notion file upload",
        "description": "Tool to retrieve details of a Notion File Upload object by its identifier. Use when you need to check the status or details of an existing file upload."
      },
      {
        "slug": "NOTION_RETRIEVE_PAGE",
        "name": "Retrieve page",
        "description": "Retrieve a Notion page's properties/metadata (not block content) by page_id. Use when you have a page URL/ID and need to access its properties; for page content use block-children tools."
      },
      {
        "slug": "NOTION_RETRIEVE_VIEW",
        "name": "Retrieve Notion view",
        "description": "Retrieve a Notion view and its configuration."
      },
      {
        "slug": "NOTION_SEARCH_NOTION_PAGE",
        "name": "Search Notion pages and databases",
        "description": "Searches Notion pages and databases by title. Use specific search terms to find items by title (primary approach). KNOWN LIMITATIONS: (1) Search indexing is not immediate - recently shared items may not appear. (2) Search is not exhaustive - results may be incomplete. (3) Database pages return all custom properties with full nested structures, which can create large responses for databases with many properties - use filter_properties to reduce response size. FALLBACK STRATEGY: If a specific title search returns empty results despite knowing items exist, try an empty query to list all accessible items and filter client-side."
      },
      {
        "slug": "NOTION_SEND_FILE_UPLOAD",
        "name": "Send file upload",
        "description": "Tool to transmit file contents to Notion for a file upload object. Use after creating a file upload object to send the actual file data."
      },
      {
        "slug": "NOTION_UPDATE_BLOCK",
        "name": "Update block",
        "description": "Updates existing Notion block's text content. ⚠️ CRITICAL: Content limited to 2000 chars. Cannot change block type or archive blocks. Content exceeding 2000 chars will fail with validation error. For longer content, split across multiple blocks using add_multiple_page_content."
      },
      {
        "slug": "NOTION_UPDATE_PAGE",
        "name": "Update Page",
        "description": "Update page properties, icon, cover, or archive status. IMPORTANT: Property names are workspace-specific and case-sensitive. Use NOTION_FETCH_ROW or NOTION_FETCH_DATABASE first to discover exact property names and valid select/status options. Common errors: - \"X is not a property that exists\": Discover properties with NOTION_FETCH_ROW - \"Invalid status option\": Check valid options with NOTION_FETCH_DATABASE - \"should be defined\": Wrap values: {'Field': {'type': value}} Property formats: title/rich_text use {'text': {'content': 'value'}}, select/status use {'name': 'option'}"
      },
      {
        "slug": "NOTION_UPDATE_ROW_DATABASE",
        "name": "Update Database Row (Page)",
        "description": "Updates a specific row/page within a Notion database by its page UUID (row_id). IMPORTANT CLARIFICATION: This action updates INDIVIDUAL ROWS (pages) in a database, NOT the database structure. - To update a ROW/PAGE: Use THIS action with `row_id` (the page UUID) - To update DATABASE SCHEMA (columns, properties, title): Use NOTION_UPDATE_SCHEMA_DATABASE with `database_id` REQUIRED: `row_id` is MANDATORY. This is the UUID of the specific page/row to update. Do NOT pass `database_id` to this action - that parameter does not exist here. Common issues: (1) Use UUID from page URL, not the full URL (2) Ensure page is shared with integration (3) Match property names exactly as in database (4) Use 'status' type for Status properties, not 'select' (5) Retry on 409 Conflict errors (concurrent updates) Supports updating properties, icon, cover, or archiving the row."
      },
      {
        "slug": "NOTION_UPDATE_SCHEMA_DATABASE",
        "name": "Update database schema",
        "description": "Updates an existing Notion database's schema including title, description, and/or properties (columns). IMPORTANT NOTES: - At least one update (title, description, or properties) must be provided - The database must be shared with your integration - Property names are case-sensitive and must match exactly - When changing a property to 'relation' type, you MUST provide the database_id of the target database - Removing properties will permanently delete that column and its data - Use NOTION_FETCH_DATA first to get the exact property names and database structure Common errors: - 'database_id' missing: Ensure you're passing the database_id parameter (not page_id) - 'data_source_id' undefined: When changing to relation type, database_id is required in PropertySchemaUpdate - Property name mismatch: Names must match exactly including case and special characters"
      },
      {
        "slug": "NOTION_UPDATE_VIEW",
        "name": "Update Notion view",
        "description": "Update a Notion view."
      },
      {
        "slug": "NOTION_UPSERT_ROW_DATABASE",
        "name": "Upsert database rows",
        "description": "Tool to upsert rows in a Notion database by querying for existing rows and creating or updating them. Use when you need to sync data to Notion without creating duplicates. Each item is matched by a filter, then either created (if no match) or updated (if match found). Supports bulk operations with per-item error handling."
      }
    ],
    "triggers": [
      {
        "slug": "NOTION_COMMENT_CREATED",
        "name": "Comment Created",
        "description": "Triggers when a new comment is created in Notion.\n\nOptional `page_id` filter scopes to comments on a specific page. When\nomitted, fires for any new comment in the workspace the integration\nhas access to.\n\nRequires the 'Read comments' capability on the Notion integration. If\na connection was authorized before that capability was enabled, the\nuser must re-authorize the connection for comment events to flow."
      },
      {
        "slug": "NOTION_DATABASE_CREATED",
        "name": "Database Created",
        "description": "Triggers when a new Notion database (the container) is created.\n\nA database is the post-2025-09-03 container that holds one or more data\nsources. This trigger fires for the container's creation event\n(`database.created`), distinct from `NOTION_DATASOURCE_CREATED` which\nfires when a new data source is added to an existing database.\n\nMost customers calling Notion's `POST /v1/databases` (the legacy API)\nor creating a database via the Notion UI will see this event. Adding a\nnew data source to an existing database fires `data_source.created`\ninstead — use `NOTION_DATASOURCE_CREATED` for that.\n\nNotion's payload puts `entity.type: \"block\"` (the container is a\n`child_database` block in the content tree) and `entity.id` is the\ndatabase id."
      },
      {
        "slug": "NOTION_DATASOURCE_CREATED",
        "name": "Data Source Created",
        "description": "Triggers when a new Notion data source is created.\n\nFires workspace-wide. The payload's `data.parent` carries the data\nsource's tree parent (typically the teamspace) for downstream\nfiltering.\n\nA single template-based database creation can fire multiple\n`data_source.created` events at once — one per data source the\ntemplate instantiates."
      },
      {
        "slug": "NOTION_DATASOURCE_SCHEMA_UPDATED",
        "name": "Data Source Schema Updated",
        "description": "Triggers when a Notion data source's schema is updated.\n\nFires on column add / remove / rename. Payload includes\n`data.updated_properties: [{id, name, action}]` so consumers can\ndiscriminate the kind of change downstream.\n\nOptional `data_source_id` filter scopes to schema changes on a single\ndata source. When omitted, fires for any schema change in the\nworkspace the integration has access to.\n\nNote: adding a column also fires `page.properties_updated` once per\nexisting row in the data source. Customers wanting a single\nstructural-change signal should use this trigger."
      },
      {
        "slug": "NOTION_PAGE_CONTENT_UPDATED",
        "name": "Page Content Updated",
        "description": "Triggers when the body content of a Notion page is updated.\n\nCustomer optionally scopes with at most one of:\n  - data_source_id: any row in this data source\n  - page_id: this specific page\n  - parent_page_id: any page whose immediate parent is this page\n\nWith none set, fires for any page content edit in the workspace the\nintegration has access to. Notion aggregates content edits within a\nshort window (~60s typical)."
      },
      {
        "slug": "NOTION_PAGE_CREATED",
        "name": "Page Created",
        "description": "Triggers when a new Notion page is created.\n\nCustomer optionally scopes with at most one of:\n  - data_source_id: new row in this data source\n  - parent_page_id: new sub-page under this page (immediate parent only)\n\nWith neither set, fires for any new page in the workspace the\nintegration has access to. Notion sends ~60s aggregation latency on\nmost events."
      },
      {
        "slug": "NOTION_PAGE_PROPERTIES_UPDATED",
        "name": "Page Properties Updated",
        "description": "Triggers when properties of a Notion page are updated.\n\nCustomer optionally scopes with at most one of:\n  - data_source_id: any row in this data source\n  - page_id: this specific page\n  - parent_page_id: any page whose immediate parent is this page\n\nWith none set, fires for any property change in the workspace the\nintegration has access to. Adding a column to a data source fires this\ntrigger once per existing row. Customers can branch on\n`data.updated_properties` (array of property IDs) to filter downstream."
      },
      {
        "slug": "NOTION_VIEW_CREATED",
        "name": "View Created",
        "description": "Triggers when a new Notion view is created.\n\nFires workspace-wide. The payload includes `data.view_type`\n(`table`, `board`, `gallery`, `calendar`, `list`, `timeline`, `gantt`)\nand `data.parent` pointing at the view's tree parent (typically the\nteamspace), so customers can filter downstream."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "notion_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": ""
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      },
      {
        "mode": "API_KEY",
        "name": "notion_api_key",
        "fields": {
          "auth_config_creation": {
            "required": [],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "generic_api_key",
                "displayName": "API Key",
                "type": "string",
                "description": "Your Notion integration secret (starts with 'ntn_' or 'secret_'). Create one at notion.so/profile/integrations, then share your pages with the integration.",
                "required": true,
                "default": null
              }
            ],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "googlesheets",
    "name": "Google Sheets",
    "logo": "https://logos.composio.dev/api/googlesheets",
    "description": "Google Sheets is a cloud-based spreadsheet tool enabling real-time collaboration, data analysis, and integration with other Google Workspace apps",
    "category": "spreadsheets",
    "authSchemes": [
      "OAUTH2"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 53,
    "triggerCount": 16,
    "version": "20260902_00",
    "tools": [
      {
        "slug": "GOOGLESHEETS_ADD_SHEET",
        "name": "Add Sheet to Existing Spreadsheet",
        "description": "Adds a new sheet to a spreadsheet. Supports three sheet types: GRID, OBJECT, and DATA_SOURCE. SHEET TYPES: - GRID (default): Standard spreadsheet with rows/columns. Use properties to set dimensions, tab color, etc. - OBJECT: Sheet containing a chart. Requires objectSheetConfig with chartSpec (basicChart or pieChart). - DATA_SOURCE: Sheet connected to BigQuery. Requires dataSourceConfig with bigQuery spec and bigquery.readonly OAuth scope. OTHER NOTES: - Sheet names must be unique; use forceUnique=true to auto-append suffix (_2, _3) if name exists - For tab colors, use EITHER rgbColor OR themeColor, not both - Avoid 'index' when creating sheets in parallel (causes errors) - OBJECT sheets are created via addChart with position.newSheet=true - DATA_SOURCE sheets require bigquery.readonly OAuth scope Use cases: Add standard grid sheet, create chart on dedicated sheet, connect to BigQuery data source."
      },
      {
        "slug": "GOOGLESHEETS_AGGREGATE_COLUMN_DATA",
        "name": "Aggregate Column Data",
        "description": "Searches for rows where a specific column matches a value and performs mathematical operations on data from another column."
      },
      {
        "slug": "GOOGLESHEETS_APPEND_DIMENSION",
        "name": "Append Dimension",
        "description": "Tool to append new rows or columns to a sheet, increasing its size. Use when you need to add empty rows or columns to an existing sheet."
      },
      {
        "slug": "GOOGLESHEETS_AUTO_RESIZE_DIMENSIONS",
        "name": "Auto-Resize Rows or Columns",
        "description": "Auto-fit column widths or row heights for a dimension range using batchUpdate.autoResizeDimensions. Use when you need to automatically adjust row heights or column widths to fit content after writing data."
      },
      {
        "slug": "GOOGLESHEETS_BATCH_CLEAR_VALUES_BY_DATA_FILTER",
        "name": "Batch Clear Values By Data Filter",
        "description": "Clears one or more ranges of values from a spreadsheet using data filters. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc..) are kept."
      },
      {
        "slug": "GOOGLESHEETS_BATCH_GET",
        "name": "Batch get spreadsheet",
        "description": "Retrieves data from specified cell ranges in a Google Spreadsheet."
      },
      {
        "slug": "GOOGLESHEETS_BATCH_UPDATE",
        "name": "Batch update spreadsheet (Deprecated)",
        "description": "DEPRECATED: Use GOOGLESHEETS_VALUES_UPDATE instead. Write values to ONE range in a Google Sheet, or append as new rows if no start cell is given. IMPORTANT - This tool does NOT accept the Google Sheets API's native batch format: - WRONG: {\"data\": [{\"range\": \"...\", \"values\": [[...]]}], ...} - CORRECT: {\"sheet_name\": \"...\", \"values\": [[...]], \"first_cell_location\": \"...\", ...} To update MULTIPLE ranges, make SEPARATE CALLS to this tool for each range. Features: - Auto-expands grid for large datasets (prevents range errors) - Set first_cell_location to write at a specific position (e.g., \"A1\", \"B5\") - Omit first_cell_location to append values as new rows at the end Requirements: Target sheet must exist and spreadsheet must contain at least one worksheet."
      },
      {
        "slug": "GOOGLESHEETS_BATCH_UPDATE_VALUES_BY_DATA_FILTER",
        "name": "Batch Update Values by Data Filter",
        "description": "Tool to update values in ranges matching data filters. Use when you need to update specific data in a Google Sheet based on criteria rather than fixed cell ranges."
      },
      {
        "slug": "GOOGLESHEETS_CLEAR_BASIC_FILTER",
        "name": "Clear Basic Filter",
        "description": "Tool to clear the basic filter from a sheet. Use when you need to remove an existing basic filter from a specific sheet within a Google Spreadsheet."
      },
      {
        "slug": "GOOGLESHEETS_CLEAR_VALUES",
        "name": "Clear spreadsheet values",
        "description": "Clears cell content (preserving formatting and notes) from a specified A1 notation range in a Google Spreadsheet; the range must correspond to an existing sheet and cells."
      },
      {
        "slug": "GOOGLESHEETS_CREATE_CHART",
        "name": "Create Chart in Google Sheets",
        "description": "Create a chart in a Google Sheets spreadsheet using the specified data range and chart type. Conditional requirements: - Provide either a simple chart via chart_type + data_range (basicChart), OR supply a full chart_spec supporting all chart types. Exactly one approach should be used. - When using chart_spec, set exactly one of the union fields (basicChart | pieChart | bubbleChart | candlestickChart | histogramChart | waterfallChart | treemapChart | orgChart | scorecardChart)."
      },
      {
        "slug": "GOOGLESHEETS_CREATE_GOOGLE_SHEET1",
        "name": "Create a Google Sheet",
        "description": "Creates a new Google Spreadsheet in Google Drive. If a title is provided, the spreadsheet will be created with that name. If no title is provided, Google will create a spreadsheet with a default name like 'Untitled spreadsheet'. Optionally create the spreadsheet in a specific folder by providing either: - folder_id: The Google Drive folder ID (preferred, unambiguous) - folder_name: The folder name (searches for exact match; if multiple folders match, returns choices) If neither folder_id nor folder_name is provided, the spreadsheet is created in the root Drive folder."
      },
      {
        "slug": "GOOGLESHEETS_CREATE_SPREADSHEET_COLUMN",
        "name": "Create spreadsheet column",
        "description": "Creates a new column in a Google Spreadsheet. Specify the target sheet using sheet_id (numeric) or sheet_name (text). If neither is provided, defaults to the first sheet (sheet_id=0)."
      },
      {
        "slug": "GOOGLESHEETS_CREATE_SPREADSHEET_ROW",
        "name": "Create spreadsheet row",
        "description": "Inserts a new, empty row into a specified sheet of a Google Spreadsheet at a given index, optionally inheriting formatting from the row above."
      },
      {
        "slug": "GOOGLESHEETS_DELETE_CHART",
        "name": "Delete Chart from Google Sheets",
        "description": "Delete an existing chart from a Google Sheets spreadsheet. Use this action when you need to remove a chart that is no longer needed or needs to be replaced. This action is irreversible — once a chart is deleted, it cannot be recovered. The chart data source (the cells containing the data) remains unchanged; only the chart visualization is removed."
      },
      {
        "slug": "GOOGLESHEETS_DELETE_DIMENSION",
        "name": "Delete Dimension (Rows/Columns)",
        "description": "Tool to delete specified rows or columns from a sheet in a Google Spreadsheet. Use when you need to remove a range of rows or columns."
      },
      {
        "slug": "GOOGLESHEETS_DELETE_SHEET",
        "name": "Delete Sheet",
        "description": "Tool to delete a sheet (worksheet) from a spreadsheet. Use when you need to remove a specific sheet from a Google Sheet document."
      },
      {
        "slug": "GOOGLESHEETS_EXECUTE_SQL",
        "name": "Execute SQL on Spreadsheet",
        "description": "DEPRECATED: Use direct Google Sheets actions instead: - GOOGLESHEETS_VALUES_GET / GOOGLESHEETS_BATCH_GET for reads - GOOGLESHEETS_VALUES_UPDATE / GOOGLESHEETS_UPDATE_VALUES_BATCH / GOOGLESHEETS_SPREADSHEETS_VALUES_APPEND for writes Execute SQL queries against Google Sheets tables. Supports SELECT, INSERT, UPDATE, DELETE operations and WITH clauses (CTEs) with familiar SQL syntax. Tables are automatically detected and mapped from the spreadsheet structure."
      },
      {
        "slug": "GOOGLESHEETS_FIND_REPLACE",
        "name": "Find and Replace in Spreadsheet",
        "description": "Tool to find and replace text in a Google Spreadsheet. Use when you need to fix formula errors, update values, or perform bulk text replacements across cells. Common use cases: - Fix #ERROR! cells by replacing with empty string or correct formula - Update old values with new ones across multiple cells - Fix formula references or patterns - Clean up data formatting issues"
      },
      {
        "slug": "GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE",
        "name": "Find worksheet by title (Deprecated)",
        "description": "DEPRECATED: Use GetSpreadsheetInfo instead. Finds a worksheet by its exact, case-sensitive title within a Google Spreadsheet; returns a boolean indicating if found and the matched worksheet's metadata when found, or None when not found."
      },
      {
        "slug": "GOOGLESHEETS_FORMAT_CELL",
        "name": "Format cell",
        "description": "Applies text and background cell formatting to a specified range in a Google Sheets worksheet."
      },
      {
        "slug": "GOOGLESHEETS_GET_BATCH_VALUES",
        "name": "Batch Get Spreadsheet Values (Deprecated)",
        "description": "DEPRECATED: Use GOOGLESHEETS_BATCH_GET instead. Tool to return one or more ranges of values from a spreadsheet. Use when you need to retrieve data from multiple ranges in a single request."
      },
      {
        "slug": "GOOGLESHEETS_GET_CONDITIONAL_FORMAT_RULES",
        "name": "Get conditional format rules",
        "description": "List conditional formatting rules for each sheet (or a selected sheet) in a normalized, easy-to-edit form. Use when you need to view, audit, or prepare to modify conditional format rules."
      },
      {
        "slug": "GOOGLESHEETS_GET_DATA_VALIDATION_RULES",
        "name": "Get Data Validation Rules",
        "description": "Tool to extract data validation rules from a Google Sheets spreadsheet. Use when you need to understand dropdown lists, allowed values, custom formulas, or other validation constraints for cells."
      },
      {
        "slug": "GOOGLESHEETS_GET_SHEET_NAMES",
        "name": "Get sheet names",
        "description": "Lists all worksheet names from a specified Google Spreadsheet (which must exist), useful for discovering sheets before further operations."
      },
      {
        "slug": "GOOGLESHEETS_GET_SPREADSHEET_BY_DATA_FILTER",
        "name": "Get Spreadsheet by Data Filter",
        "description": "Returns the spreadsheet at the given ID, filtered by the specified data filters. Use this tool when you need to retrieve specific subsets of data from a Google Sheet based on criteria like A1 notation, developer metadata, or grid ranges. Important: This action is designed for filtered data retrieval. While it accepts empty filters and returns full metadata in that case, GOOGLESHEETS_GET_SPREADSHEET_INFO is the recommended action for unfiltered spreadsheet retrieval."
      },
      {
        "slug": "GOOGLESHEETS_GET_SPREADSHEET_INFO",
        "name": "Get spreadsheet info",
        "description": "Retrieves metadata for a Google Spreadsheet using its ID. By default, returns essential information (ID, title, sheet properties) to avoid payload size issues. Use the fields parameter for comprehensive metadata or specific fields."
      },
      {
        "slug": "GOOGLESHEETS_GET_TABLE_SCHEMA",
        "name": "Get Table Schema",
        "description": "DEPRECATED: Use GOOGLESHEETS_GET_SHEET_NAMES and GOOGLESHEETS_GET_SPREADSHEET_INFO for sheet structure metadata, and GOOGLESHEETS_VALUES_GET for direct range inspection. This action is used to get the schema of a table in a Google Spreadsheet, call this action to get the schema of a table in a spreadsheet BEFORE YOU QUERY THE TABLE. Analyze table structure and infer column names, types, and constraints. Uses statistical analysis of sample data to determine the most likely data type for each column. Call this action after calling the LIST_TABLES action to get the schema of a table in a spreadsheet."
      },
      {
        "slug": "GOOGLESHEETS_INSERT_DIMENSION",
        "name": "Insert Dimension in Google Sheet",
        "description": "Tool to insert new rows or columns into a sheet at a specified location. Use when you need to add empty rows or columns within an existing Google Sheet."
      },
      {
        "slug": "GOOGLESHEETS_LIST_CHARTS",
        "name": "List Charts in Google Sheets",
        "description": "Lists all charts in a Google Sheets spreadsheet across all sheets, returning chart_id, sheet metadata, chart type, title, and position. Use this action when you need to discover what charts exist in a spreadsheet, retrieve chart IDs for update or delete operations, or inspect chart configurations. The default field mask in GOOGLESHEETS_GET_SPREADSHEET_INFO omits chart data, making this dedicated action necessary for chart discovery."
      },
      {
        "slug": "GOOGLESHEETS_LIST_TABLES",
        "name": "List Tables in Spreadsheet",
        "description": "DEPRECATED: Use GOOGLESHEETS_GET_SHEET_NAMES for tab discovery and GOOGLESHEETS_GET_SPREADSHEET_INFO for full sheet metadata. This action is used to list all tables in a Google Spreadsheet, call this action to get the list of tables in a spreadsheet. Discover all tables in a Google Spreadsheet by analyzing sheet structure and detecting data patterns. Uses heuristic analysis to find header rows, data boundaries, and table structures."
      },
      {
        "slug": "GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW",
        "name": "Look up spreadsheet row",
        "description": "Finds the first row in a Google Spreadsheet where a cell's entire content exactly matches the query string, searching within a specified A1 notation range or the first sheet by default."
      },
      {
        "slug": "GOOGLESHEETS_MOVE_CHART",
        "name": "Move or Resize Chart in Google Sheets",
        "description": "Move or resize an existing chart on a Google Sheets spreadsheet. Use this action when you need to reposition a chart to a different location on the same or different sheet, move it to a brand-new sheet, or change its size. This action wraps the updateEmbeddedObjectPosition batchUpdate request type and supports three positioning modes: moving to a new sheet, moving to an existing sheet, or repositioning via pixel-perfect overlay coordinates."
      },
      {
        "slug": "GOOGLESHEETS_MUTATE_CONDITIONAL_FORMAT_RULES",
        "name": "Mutate conditional format rules",
        "description": "Add, update, delete, or reorder conditional format rules on a Google Sheet. Use when you need to create, modify, or remove conditional formatting without manually building batchUpdate requests. Supports four operations: ADD (create new rule), UPDATE (replace existing rule), DELETE (remove rule), MOVE (reorder rules by changing index)."
      },
      {
        "slug": "GOOGLESHEETS_QUERY_TABLE",
        "name": "Query Spreadsheet Table",
        "description": "DEPRECATED: Use GOOGLESHEETS_VALUES_GET / GOOGLESHEETS_BATCH_GET for table reads and GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW for row lookup/filter workflows. Execute SQL-like SELECT queries against Google Spreadsheet tables. Table names correspond to sheet/tab names visible at the bottom of the spreadsheet. Use GOOGLESHEETS_LIST_TABLES first to discover available table names if unknown. Supports WHERE conditions, ORDER BY, LIMIT clauses."
      },
      {
        "slug": "GOOGLESHEETS_SEARCH_DEVELOPER_METADATA",
        "name": "Search Developer Metadata",
        "description": "Tool to search for developer metadata in a spreadsheet. Use when you need to find specific metadata entries based on filters."
      },
      {
        "slug": "GOOGLESHEETS_SEARCH_SPREADSHEETS",
        "name": "Search Spreadsheets",
        "description": "Search for Google Spreadsheets using various filters including name, content, date ranges, and more."
      },
      {
        "slug": "GOOGLESHEETS_SET_BASIC_FILTER",
        "name": "Set Basic Filter",
        "description": "Tool to set a basic filter on a sheet in a Google Spreadsheet. Use when you need to filter or sort data within a specific range on a sheet."
      },
      {
        "slug": "GOOGLESHEETS_SET_DATA_VALIDATION_RULE",
        "name": "Set Data Validation Rule",
        "description": "Tool to set or clear data validation rules (including dropdowns) on a range in Google Sheets. Use when you need to apply dropdown lists, range-based dropdowns, or custom formula validation to cells."
      },
      {
        "slug": "GOOGLESHEETS_SHEET_FROM_JSON",
        "name": "Create sheet from JSON",
        "description": "DEPRECATED: Use GOOGLESHEETS_CREATE_GOOGLE_SHEET1 + GOOGLESHEETS_UPDATE_VALUES_BATCH (or GOOGLESHEETS_VALUES_UPDATE / GOOGLESHEETS_SPREADSHEETS_VALUES_APPEND) instead. Creates a new Google Spreadsheet and populates its first worksheet from `sheet_json`. When data is provided, the first item's keys establish the headers. An empty list creates an empty worksheet."
      },
      {
        "slug": "GOOGLESHEETS_SORT_RANGE",
        "name": "Sort Range",
        "description": "Sorts data within a specified range in a Google Sheet based on one or more sort criteria. Use this action when you need to reorder rows in a range by column values, with support for multi-level (cascading) sorts."
      },
      {
        "slug": "GOOGLESHEETS_SPREADSHEETS_SHEETS_COPY_TO",
        "name": "Copy Sheet to Another Spreadsheet",
        "description": "Tool to copy a single sheet from a spreadsheet to another spreadsheet. Use when you need to duplicate a sheet into a different spreadsheet."
      },
      {
        "slug": "GOOGLESHEETS_SPREADSHEETS_VALUES_APPEND",
        "name": "Append Values to Spreadsheet",
        "description": "Tool to append values to a spreadsheet. Use when you need to add new data to the end of an existing table in a Google Sheet."
      },
      {
        "slug": "GOOGLESHEETS_SPREADSHEETS_VALUES_BATCH_CLEAR",
        "name": "Batch Clear Spreadsheet Values",
        "description": "Tool to clear one or more ranges of values from a spreadsheet. Use when you need to remove data from specific cells or ranges while keeping formatting and other properties intact."
      },
      {
        "slug": "GOOGLESHEETS_SPREADSHEETS_VALUES_BATCH_GET_BY_DATA_FILTER",
        "name": "Batch Get Spreadsheet Values by Data Filter",
        "description": "Tool to return one or more ranges of values from a spreadsheet that match the specified data filters. Use when you need to retrieve specific data sets based on filtering criteria rather than entire sheets or fixed ranges."
      },
      {
        "slug": "GOOGLESHEETS_UPDATE_CHART",
        "name": "Update Chart in Google Sheets",
        "description": "Update the specification of an existing chart in a Google Sheets spreadsheet. Use this action when you need to modify an existing chart's properties such as its title, chart type, data ranges, colors, axes, or other visual settings. This action updates the chart's specification but does not change its position or size on the sheet."
      },
      {
        "slug": "GOOGLESHEETS_UPDATE_DIMENSION_PROPERTIES",
        "name": "Update Dimension Properties (Hide/Unhide & Resize)",
        "description": "Tool to hide/unhide rows or columns and set row heights or column widths. Use when you need to change visibility or pixel sizing of dimensions in a Google Sheet."
      },
      {
        "slug": "GOOGLESHEETS_UPDATE_SHEET_PROPERTIES",
        "name": "Update Sheet Properties",
        "description": "Tool to update properties of a sheet (worksheet) within a Google Spreadsheet, such as its title, index, visibility, tab color, or grid properties. Use this when you need to modify the metadata or appearance of a specific sheet."
      },
      {
        "slug": "GOOGLESHEETS_UPDATE_SPREADSHEET_PROPERTIES",
        "name": "Update Spreadsheet Properties",
        "description": "Tool to update SPREADSHEET-LEVEL properties such as the spreadsheet's title, locale, time zone, or auto-recalculation settings. Use when you need to modify the overall configuration of a Google Spreadsheet. NOTE: To update individual SHEET properties (like renaming a specific sheet/tab), use GOOGLESHEETS_UPDATE_SHEET_PROPERTIES instead."
      },
      {
        "slug": "GOOGLESHEETS_UPDATE_VALUES_BATCH",
        "name": "Batch update spreadsheet values",
        "description": "Tool to set values in one or more ranges of a spreadsheet. Use when you need to update multiple ranges in a single operation for better performance."
      },
      {
        "slug": "GOOGLESHEETS_UPSERT_ROWS",
        "name": "Upsert Rows (Smart Update/Insert)",
        "description": "Upsert rows - update existing rows by key, append new ones. Automatically handles column mapping and partial updates. Use for: CRM syncs (match Lead ID), transaction imports (match Transaction ID), inventory updates (match SKU), calendar syncs (match Event ID). Features: - Auto-adds missing columns to sheet - Partial column updates (only update Phone + Status, preserve other columns) - Column order doesn't matter (auto-maps by header name) - Prevents duplicates by matching key column Example inputs: - Contact update: keyColumn='Email', headers=['Email','Phone','Status'], data=[['[email protected]','555-0101','Active']] - Inventory sync: keyColumn='SKU', headers=['SKU','Stock','Price'], data=[['WIDGET-001',50,9.99],['GADGET-002',30,19.99]] - CRM lead update: keyColumn='Lead ID', headers=['Lead ID','Score','Status'], data=[['L-12345',85,'Hot']] - Partial update: keyColumn='Email', headers=['Email','Phone'] (only updates Phone, preserves Name/Address/etc)"
      },
      {
        "slug": "GOOGLESHEETS_VALUES_GET",
        "name": "Get spreadsheet values",
        "description": "Returns a range of values from a spreadsheet. Use when you need to read data from specific cells or ranges in a Google Sheet."
      },
      {
        "slug": "GOOGLESHEETS_VALUES_UPDATE",
        "name": "Update spreadsheet values",
        "description": "Tool to set values in a range of a Google Spreadsheet. Use when you need to update or overwrite existing cell values in a specific range."
      }
    ],
    "triggers": [
      {
        "slug": "GOOGLESHEETS_AGGREGATE_METRIC_CHANGED_TRIGGER",
        "name": "Aggregate Metric Changed",
        "description": "Triggers when an aggregate metric (SUM/COUNT/AVG/MIN/MAX) changes in a Google Sheets spreadsheet.\nThis trigger monitors an aggregate calculation on a target column (optionally filtered by a search column/value)\nand fires when the calculated result changes."
      },
      {
        "slug": "GOOGLESHEETS_CELL_RANGE_VALUES_CHANGED_TRIGGER",
        "name": "Cell Range Values Changed",
        "description": "Triggers when values in a specified A1 range change in Google Sheets.\nThis trigger monitors a specific cell or range of cells and fires when any values change."
      },
      {
        "slug": "GOOGLESHEETS_CONDITIONAL_FORMAT_RULE_CHANGED_TRIGGER",
        "name": "Conditional Format Rule Changed",
        "description": "Triggers when conditional formatting rules change in a Google Spreadsheet.\nDetects when rules are added, updated, or removed.\nUses snapshot-based diffing to detect changes between polls."
      },
      {
        "slug": "GOOGLESHEETS_DATA_VALIDATION_RULE_CHANGED_TRIGGER",
        "name": "Data Validation Rule Changed",
        "description": "Triggers when data validation rules change (added/updated/removed) in a Google Spreadsheet.\nUses snapshot-based diffing to detect changes between polls."
      },
      {
        "slug": "GOOGLESHEETS_DEVELOPER_METADATA_CHANGED_TRIGGER",
        "name": "Developer Metadata Changed",
        "description": "Triggers when developer metadata entries change (new/updated/removed) in a Google Spreadsheet.\nUses snapshot-based diffing to detect changes between polls."
      },
      {
        "slug": "GOOGLESHEETS_FILTERED_RANGE_VALUES_CHANGED_TRIGGER",
        "name": "Filtered Range Values Changed",
        "description": "Polling trigger that monitors Google Sheets filtered ranges for value changes.\nUses snapshot-based diffing to detect when values matching a data filter change.\nEmits the matched values when changes are detected."
      },
      {
        "slug": "GOOGLESHEETS_NEW_ROWS_TRIGGER",
        "name": "New Rows in Google Sheet",
        "description": "Simple polling trigger that monitors Google Sheets for new rows.\nDetects when new rows are added and returns the complete row data.\nPerfect for triggering any workflow based on new sheet entries."
      },
      {
        "slug": "GOOGLESHEETS_NEW_SHEET_ADDED_TRIGGER",
        "name": "New Sheet Added in Google Spreadsheet",
        "description": "Polling trigger that detects when a new sheet is added to a Google Spreadsheet."
      },
      {
        "slug": "GOOGLESHEETS_NEW_SPREADSHEET_CREATED_TRIGGER",
        "name": "New Spreadsheet Created",
        "description": "Triggers when a new Google Spreadsheet is created.\nThis trigger monitors Google Spreadsheets and fires when new spreadsheets are detected.\nUses timestamp filtering to efficiently detect newly created spreadsheets."
      },
      {
        "slug": "GOOGLESHEETS_SPREADSHEET_METADATA_CHANGED_TRIGGER",
        "name": "Spreadsheet Metadata Changed",
        "description": "Polling trigger that detects when a Google Spreadsheet's metadata changes.\nUses snapshot-based diffing to detect any changes in spreadsheet properties,\nsheets, named ranges, developer metadata, data sources, etc."
      },
      {
        "slug": "GOOGLESHEETS_SPREADSHEET_PROPERTIES_CHANGED_TRIGGER",
        "name": "Spreadsheet Properties Changed",
        "description": "Polling trigger that detects when a Google Spreadsheet's top-level properties change.\nMonitors properties such as title, locale, timeZone, and autoRecalc settings."
      },
      {
        "slug": "GOOGLESHEETS_SPREADSHEET_ROW_CHANGED_TRIGGER",
        "name": "Spreadsheet Row Changed",
        "description": "Triggers when a looked-up spreadsheet row changes.\nThis trigger monitors a specific row (located by searching for a query value within a user-specified range)\nand fires when the row's values change, when the row appears, or when the row disappears."
      },
      {
        "slug": "GOOGLESHEETS_SPREADSHEET_SEARCH_MATCH_TRIGGER",
        "name": "Spreadsheet Search Match",
        "description": "Triggers when a new spreadsheet appears that matches a saved search.\nThis trigger uses snapshot-based diffing to detect when spreadsheets matching\nthe search criteria are newly created or become visible to the user."
      },
      {
        "slug": "GOOGLESHEETS_TABLE_QUERY_RESULT_CHANGED_TRIGGER",
        "name": "Table Query Result Changed",
        "description": "Triggers when the result set of a saved table query changes in Google Sheets.\nDetects rows added, removed, or updated in the query output.\nThis trigger monitors the result of a SQL query against a Google Sheets table\nand fires when changes are detected."
      },
      {
        "slug": "GOOGLESHEETS_TABLE_SCHEMA_CHANGED_TRIGGER",
        "name": "Table Schema Changed",
        "description": "Polling trigger that detects when a table's schema changes in Google Sheets.\nMonitors columns added/removed/renamed and inferred type/format changes.\nUses snapshot-based diffing to compare schemas between polls."
      },
      {
        "slug": "GOOGLESHEETS_WORKSHEET_NAMES_CHANGED_TRIGGER",
        "name": "Worksheet Names Changed",
        "description": "Triggers when the set of worksheet/tab names changes in a Google Spreadsheet.\nDetects when sheets are added, deleted, or renamed."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "google_sheets_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/spreadsheets,https://www.googleapis.com/auth/userinfo.email"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "slack",
    "name": "Slack",
    "logo": "https://logos.composio.dev/api/slack",
    "description": "Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work - all within a secure, enterprise-grade environment.",
    "category": "team chat",
    "authSchemes": [
      "OAUTH2"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 167,
    "triggerCount": 9,
    "version": "20260826_00",
    "tools": [
      {
        "slug": "SLACK_ADD_CALL_PARTICIPANTS",
        "name": "Add call participants",
        "description": "Registers new participants added to a Slack call."
      },
      {
        "slug": "SLACK_ADD_EMOJI",
        "name": "Add emoji",
        "description": "Adds a custom emoji to a Slack workspace given a unique name and an image URL; subject to workspace emoji limits."
      },
      {
        "slug": "SLACK_ADD_EMOJI_ALIAS",
        "name": "Add an emoji alias",
        "description": "Adds an alias for an existing custom emoji in a Slack Enterprise Grid organization."
      },
      {
        "slug": "SLACK_ADD_ENTERPRISE_USER_TO_WORKSPACE",
        "name": "Add Enterprise user to workspace",
        "description": "Adds an Enterprise user to a workspace. Use when you need to assign an existing Enterprise Grid user to a specific workspace with optional guest restrictions."
      },
      {
        "slug": "SLACK_ADD_REACTION_TO_AN_ITEM",
        "name": "Add reaction to message",
        "description": "Adds a specified emoji reaction to an existing message in a Slack channel, identified by its timestamp; does not remove or retrieve reactions."
      },
      {
        "slug": "SLACK_ADD_REMOTE_FILE",
        "name": "Add a remote file",
        "description": "Adds a reference to an external file (e.g., Google Drive, Dropbox) to Slack for discovery and sharing, requiring a unique `external_id` and an `external_url` accessible by Slack."
      },
      {
        "slug": "SLACK_ADD_STAR",
        "name": "Add a star to an item",
        "description": "Stars a channel, file, file comment, or a specific message in Slack."
      },
      {
        "slug": "SLACK_ADMIN_CONVERSATIONS_SEARCH",
        "name": "Search for channels in Enterprise organization",
        "description": "Tool to search for public or private channels in an Enterprise organization. Use when you need to find channels by name, type, or other criteria within an Enterprise Grid workspace."
      },
      {
        "slug": "SLACK_API_TEST",
        "name": "Test Slack API connection",
        "description": "Tool to check API calling code by testing connectivity and authentication to the Slack API. Use when you need to verify that API credentials are valid and the connection is working properly."
      },
      {
        "slug": "SLACK_ARCHIVE_CONVERSATION",
        "name": "Archive a Slack conversation",
        "description": "Archives a Slack conversation by its ID, rendering it read-only and hidden while retaining history, ideal for cleaning up inactive channels; be aware that some channels (like #general or certain DMs) cannot be archived and this may impact connected integrations."
      },
      {
        "slug": "SLACK_ASSISTANT_SEARCH_CONTEXT",
        "name": "Real-time search",
        "description": "Search Slack messages, files, channels, and users via Real-time Search API. For queries referencing entities by name (users/channels/files), first resolve with content_types (users/channels/files) to get exact ID. If multiple matches, ask user to clarify before proceeding (e.g. ask for user email)."
      },
      {
        "slug": "SLACK_ASSISTANT_SEARCH_INFO",
        "name": "Check search capabilities",
        "description": "Check if semantic (AI-powered) search is available on the Slack workspace. Returns whether natural language queries will trigger semantic search in assistant.search.context calls."
      },
      {
        "slug": "SLACK_CHAT_POST_MESSAGE",
        "name": "Send message",
        "description": "(DEPRECATED: use `SLACK_SEND_MESSAGE`) Posts a message to a Slack channel, DM, or private group; requires at least one content field (`markdown_text`, `text`, `blocks`, or `attachments`) — omitting all causes a `no_text` error. Fails with `not_in_channel`, `channel_not_found`, or `channel_is_archived` if the bot lacks access. Body limit ~4000 characters. Rate-limited at ~1 req/sec (HTTP 429, honor `Retry-After`). Not idempotent — duplicate calls post duplicate messages."
      },
      {
        "slug": "SLACK_CLOSE_DM",
        "name": "Close conversation channel",
        "description": "Closes a Slack direct message (DM) or multi-person direct message (MPDM) channel, removing it from the user's sidebar without deleting history; this action affects only the calling user's view."
      },
      {
        "slug": "SLACK_CONVERT_CHANNEL_TO_PRIVATE",
        "name": "Convert public channel to private",
        "description": "Convert a public Slack channel to private using the Admin API. This is an Enterprise Grid only feature and requires an org-installed user token with admin.conversations:write scope."
      },
      {
        "slug": "SLACK_CREATE_A_REMINDER",
        "name": "Create a reminder",
        "description": "Creates a Slack reminder with specified text and time; time accepts Unix timestamps, seconds from now, or natural language (e.g., 'in 15 minutes', 'every Thursday at 2pm')."
      },
      {
        "slug": "SLACK_CREATE_CANVAS",
        "name": "Create Slack Canvas",
        "description": "Creates a new Slack Canvas with the specified title and optional content."
      },
      {
        "slug": "SLACK_CREATE_CHANNEL",
        "name": "Create channel",
        "description": "Initiates a public or private channel-based conversation in a Slack workspace. Immediately creates the channel; invoke only after explicit user confirmation."
      },
      {
        "slug": "SLACK_CREATE_CHANNEL_BASED_CONVERSATION",
        "name": "Create a channel-based conversation",
        "description": "Creates a new public or private Slack channel with a unique name; the channel can be org-wide, or team-specific if `team_id` is given (required if `org_wide` is false or not provided)."
      },
      {
        "slug": "SLACK_CREATE_ENTERPRISE_TEAM",
        "name": "Create Enterprise team",
        "description": "Tool to create an Enterprise team in Slack. Use when you need to create a new team (workspace) within an Enterprise Grid organization. Requires admin.teams:write scope."
      },
      {
        "slug": "SLACK_CREATE_SLACK_LIST",
        "name": "Create Slack List",
        "description": "Creates a new Slack List via `slackLists.create`. Provide a `name` and, optionally, a `description_blocks` description and a `schema` of typed columns. You can instead copy an existing List's structure with `copy_from_list_id` (and its rows via `include_copied_list_records`), or enable task-tracking columns with `todo_mode`. Returns the new List's `list_id`. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACK_CREATE_SLACK_LIST_ITEM",
        "name": "Create Slack List item",
        "description": "Creates a new item (row) in a Slack List via `slackLists.items.create`. Set initial cell values with `initial_fields`; text columns require Block Kit `rich_text` (a plain string is wrapped automatically). Optionally duplicate an existing row with `duplicated_item_id` or create a subtask with `parent_item_id`. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACK_CREATE_USER_GROUP",
        "name": "Create a Slack user group",
        "description": "Creates a new User Group (often referred to as a subteam) in a Slack workspace."
      },
      {
        "slug": "SLACK_CUSTOMIZE_URL_UNFURL",
        "name": "Customize URL unfurl",
        "description": "Customizes URL previews (unfurling) in a specific Slack message using a URL-encoded JSON in `unfurls` to define custom content or remove existing previews."
      },
      {
        "slug": "SLACK_DELETE_CANVAS",
        "name": "Delete Slack Canvas",
        "description": "Deletes a Slack Canvas permanently and irreversibly. Always confirm with the user before calling this tool."
      },
      {
        "slug": "SLACK_DELETE_CHANNEL",
        "name": "Delete a public or private channel",
        "description": "Permanently and irreversibly deletes a specified public or private channel, including all its messages and files, within a Slack Enterprise Grid organization."
      },
      {
        "slug": "SLACK_DELETE_FILE",
        "name": "Delete a file by ID",
        "description": "Permanently deletes an existing file from a Slack workspace using its unique file ID; this action is irreversible and also removes any associated comments or shares."
      },
      {
        "slug": "SLACK_DELETE_FILE_COMMENT",
        "name": "Delete file comment",
        "description": "Deletes a specific comment from a file in Slack; this action is irreversible."
      },
      {
        "slug": "SLACK_DELETE_MULTIPLE_SLACK_LIST_ITEMS",
        "name": "Delete multiple Slack List items",
        "description": "Deletes several items (rows) from a Slack List in one call via `slackLists.items.deleteMultiple`. This operation is ALL-OR-NOTHING: Slack returns a single `{\"ok\": true}` on success or `{\"ok\": false, \"error\": ...}` on failure, with NO per-item result array, so partial state cannot be reported. On failure, treat the whole batch as not deleted and retry the entire batch. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACK_DELETE_REMINDER",
        "name": "Delete a Slack reminder",
        "description": "Deletes an existing Slack reminder, typically when it is no longer relevant or a task is completed; this operation is irreversible."
      },
      {
        "slug": "SLACK_DELETES_A_MESSAGE_FROM_A_CHAT",
        "name": "Delete a message from a chat",
        "description": "Deletes a message, identified by its channel ID and timestamp, from a Slack channel, private group, or direct message conversation; the authenticated user or bot must be the original poster."
      },
      {
        "slug": "SLACK_DELETE_SCHEDULED_MESSAGE",
        "name": "Delete scheduled chat message",
        "description": "Deletes a pending, unsent scheduled message from the specified Slack channel, identified by its `scheduled_message_id`."
      },
      {
        "slug": "SLACK_DELETE_SLACK_LIST_ACCESS",
        "name": "Delete Slack List access",
        "description": "Revokes sharing access on a Slack List via `slackLists.access.delete`. Provide the `list_id` and EXACTLY ONE of `channel_ids` or `user_ids` (they are mutually exclusive) to remove access for those channels or users. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACK_DELETE_SLACK_LIST_ITEM",
        "name": "Delete Slack List item",
        "description": "Deletes an item (row) from a Slack List via `slackLists.items.delete`. Identify the List with `list_id` and the row to remove with `id`. Deletion is permanent and cannot be undone. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACK_DELETE_USER_PROFILE_PHOTO",
        "name": "Delete user profile photo",
        "description": "Deletes the Slack profile photo for the user identified by the token, reverting them to the default avatar; this action is irreversible and succeeds even if no custom photo was set."
      },
      {
        "slug": "SLACK_DISABLE_USER_GROUP",
        "name": "Disable a Slack user group",
        "description": "Disables a specified, currently enabled Slack User Group by its unique ID, effectively archiving it by setting its 'date_delete' timestamp; the group is not permanently deleted and can be re-enabled."
      },
      {
        "slug": "SLACK_DOWNLOAD_SLACK_FILE",
        "name": "Download Slack file",
        "description": "Tool to download Slack file content and convert it to a publicly accessible URL. Use when you need to retrieve and download files that have been shared in Slack channels or conversations."
      },
      {
        "slug": "SLACK_EDIT_CANVAS",
        "name": "Edit Slack Canvas",
        "description": "Edits a Slack Canvas with granular control over content placement. Supports replace, insert (before/after/start/end) operations for flexible content management."
      },
      {
        "slug": "SLACK_ENABLE_PUBLIC_SHARING_OF_A_FILE",
        "name": "Share file public url",
        "description": "Enables public sharing for an existing Slack file by generating a publicly accessible URL; this action does not create new files. Once enabled, the file is accessible to anyone with the URL — verify intent before sharing sensitive or confidential files."
      },
      {
        "slug": "SLACK_ENABLE_USER_GROUP",
        "name": "Enable a user group",
        "description": "Enables a disabled User Group in Slack using its ID, reactivating it for mentions and permissions; this action only changes the enabled status and cannot create new groups or modify other properties."
      },
      {
        "slug": "SLACK_END_CALL",
        "name": "End a call",
        "description": "Ends an ongoing Slack call, identified by its ID (obtained from `calls.add`), optionally specifying the call's duration."
      },
      {
        "slug": "SLACK_END_DND",
        "name": "End DND session",
        "description": "Ends the authenticated user's current Do Not Disturb (DND) session in Slack, affecting only DND status and making them available; if DND is not active, Slack acknowledges the request without changing status."
      },
      {
        "slug": "SLACK_END_SNOOZE",
        "name": "End snooze",
        "description": "Ends the current user's snooze mode immediately."
      },
      {
        "slug": "SLACK_FETCH_CONVERSATION_HISTORY",
        "name": "Fetch conversation history",
        "description": "Fetches a chronological list of messages and events from a specified Slack conversation, accessible by the authenticated user/bot, with options for pagination and time range filtering. IMPORTANT LIMITATION: This action only returns messages from the main channel timeline. Threaded replies are NOT returned by this endpoint. To retrieve threaded replies, use the SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION action (conversations.replies API) instead. The oldest/latest timestamp filters work reliably for filtering the main channel timeline, but cannot be used to retrieve individual threaded replies - even if you know the exact reply timestamp, setting oldest=latest to that timestamp will return an empty messages array. To get threaded replies: 1. Use this action to get parent messages (which include thread_ts, reply_count, latest_reply fields) 2. Use SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION with the parent's thread_ts to fetch all replies in that thread"
      },
      {
        "slug": "SLACK_FETCH_ITEM_REACTIONS",
        "name": "Fetch item reactions",
        "description": "Fetches reactions for a Slack message, file, or file comment. Exactly one identifier path must be provided: `channel`+`timestamp`, `file`, or `file_comment`. Mixing identifiers (e.g., providing both `channel`+`timestamp` and `file`) causes errors. If the response omits the `reactions` field, the item has zero reactions."
      },
      {
        "slug": "SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION",
        "name": "Retrieve conversation replies",
        "description": "Retrieves replies to a specific parent message in a Slack conversation, using the channel ID and the parent message's timestamp (`ts`). Note: The parent message in the response contains metadata (reply_count, reply_users, latest_reply) that indicates expected thread activity. If the returned messages array contains fewer replies than reply_count indicates, check: (1) has_more=true means pagination is needed, (2) recently posted replies may have timing delays, (3) some replies may be filtered by permissions or deleted. The composio_execution_message field will warn about any detected mismatches."
      },
      {
        "slug": "SLACK_FETCH_TEAM_INFO",
        "name": "Fetch team info",
        "description": "Fetches comprehensive metadata about the current Slack team, or a specified team if the provided ID is accessible."
      },
      {
        "slug": "SLACK_FIND_CHANNELS",
        "name": "Find channels",
        "description": "Find channels in a Slack workspace by any criteria - name, topic, purpose, or description. Returns channel IDs (C*/G* prefixed) required by most Slack tools — always resolve names to IDs here before passing to other tools. NOTE: This action searches channels and conversations visible to the authenticated user. Empty results may indicate: - No channels match the search query in name, topic, or purpose - The target private channel or DM is not accessible to the authenticated user because they are not a member - The connection lacks required read scopes (channels:read, groups:read, im:read, mpim:read). If empty, retry with exact_match=false or exclude_archived=false to avoid false negatives. In large workspaces, paginate using next_cursor to avoid missing matches. Check 'composio_execution_message' and 'total_channels_searched' in the response for details."
      },
      {
        "slug": "SLACK_FIND_USER_BY_EMAIL_ADDRESS",
        "name": "Lookup users by email",
        "description": "Retrieves the Slack user object for an active user by their registered email address; requires the users:read.email OAuth scope. Fails with 'users_not_found' if the email is unregistered, the user is inactive, the account is a guest, or the email is hidden by workspace privacy settings."
      },
      {
        "slug": "SLACK_FIND_USERS",
        "name": "Find users",
        "description": "Find users in a Slack workspace by any criteria - email, name, display name, or other text. Includes optimized email lookup for exact email matches. Zero results may reflect email visibility restrictions or workspace policies, not global absence. Repeated calls may trigger HTTP 429; honor the Retry-After header."
      },
      {
        "slug": "SLACK_GET_APP_PERMISSION_SCOPES",
        "name": "Get app permission scopes",
        "description": "DEPRECATED: Use SLACK_TEST_AUTH instead. Preflight a Slack token by calling auth.test and returning the token's currently granted OAuth scopes (from response headers) to detect missing permissions before attempting admin actions. Use when you need to verify token capabilities or check for specific scopes before making API calls that require elevated permissions."
      },
      {
        "slug": "SLACK_GET_AUDIT_ACTION_TYPES",
        "name": "Get Audit Action Types",
        "description": "Tool to retrieve information about action types available in the Slack Audit Logs API. Use when you need to know which action types can be used to filter audit logs or understand the categories of auditable actions in Slack."
      },
      {
        "slug": "SLACK_GET_AUDIT_SCHEMAS",
        "name": "Get Audit Schemas",
        "description": "Tool to retrieve object schema information from the Slack Audit Logs API. Use when you need to understand the types of objects returned by audit log endpoints. Returns a list of all object types with descriptions."
      },
      {
        "slug": "SLACK_GET_BOT_USER",
        "name": "Fetch bot user information",
        "description": "Fetches information for a specified, existing Slack bot user; will not work for regular user accounts or other integration types."
      },
      {
        "slug": "SLACK_GET_CALL_INFO",
        "name": "Retrieve call information",
        "description": "Retrieves a point-in-time snapshot of a specific Slack call's information."
      },
      {
        "slug": "SLACK_GET_CANVAS",
        "name": "Get Slack Canvas (Deprecated)",
        "description": "DEPRECATED: Use SLACK_RETRIEVE_DETAILED_INFORMATION_ABOUT_A_FILE instead. Retrieves a specific Slack Canvas by its ID, including its content and metadata."
      },
      {
        "slug": "SLACK_GET_CHANNEL_CONVERSATION_PREFERENCES",
        "name": "Get channel conversation preferences",
        "description": "Retrieves conversation preferences (e.g., who can post, who can thread) for a specified channel, primarily for use within Slack Enterprise Grid environments."
      },
      {
        "slug": "SLACK_GET_REMINDER",
        "name": "Get reminder information",
        "description": "Retrieves detailed information for an existing Slack reminder specified by its ID; this is a read-only operation."
      },
      {
        "slug": "SLACK_GET_REMOTE_FILE",
        "name": "Get remote file",
        "description": "Retrieve information about a remote file added to Slack via the files.remote API. Does not work for standard Slack-hosted file uploads."
      },
      {
        "slug": "SLACK_GET_SLACK_LIST_ITEM",
        "name": "Get Slack List item",
        "description": "Fetches a single item (row) from a Slack List via `slackLists.items.info`. Returns the row's `column_id`-keyed typed values along with metadata about the parent List. Set `include_is_subscribed` to also report whether the calling user is subscribed to the row. Requires a user token with the `lists:read` scope."
      },
      {
        "slug": "SLACK_GET_TEAM_PROFILE",
        "name": "Retrieve team profile details",
        "description": "Retrieves all profile field definitions for a Slack team, optionally filtered by visibility, to understand the team's profile structure."
      },
      {
        "slug": "SLACK_GET_UNREAD_MESSAGES_FROM_USER",
        "name": "Get unread messages from user",
        "description": "Retrieves unread direct messages from a specific user by opening their DM conversation, checking for unread messages, and fetching message history since the last read timestamp. Use this action when you need to check if a specific user has sent unread direct messages to the authenticated user, or when monitoring incoming DMs from particular users. Returns an empty messages array if there are no unread messages from the specified user. Note: This action only works for direct messages (DMs), not channel messages or group conversations."
      },
      {
        "slug": "SLACK_GET_USER_DND_STATUS",
        "name": "Get team DND status",
        "description": "Retrieves a user's current Do Not Disturb status."
      },
      {
        "slug": "SLACK_GET_USER_PRESENCE",
        "name": "Retrieve user presence",
        "description": "Retrieves a Slack user's current real-time presence (e.g., 'active', 'away') to determine their availability, noting this action does not provide historical data or status reasons."
      },
      {
        "slug": "SLACK_GET_WORKSPACE_CONNECTIONS_FOR_CHANNEL",
        "name": "Get workspace connections for channel",
        "description": "Tool to get all workspaces a channel is connected to within an Enterprise org. Use when you need to determine which workspaces have access to a specific public or private channel in an Enterprise Grid organization."
      },
      {
        "slug": "SLACK_GET_WORKSPACE_SETTINGS",
        "name": "Fetch workspace settings information",
        "description": "Retrieves detailed settings for a specific Slack workspace, primarily for administrators in an Enterprise Grid organization to view or audit workspace configurations."
      },
      {
        "slug": "SLACK_INVITE_USERS_TO_A_SLACK_CHANNEL",
        "name": "Invite users to a Slack channel",
        "description": "Invites users to an existing Slack channel using their valid Slack User IDs. Response is always HTTP 200; inspect `ok`, `error`, and `errors` fields to confirm users were added."
      },
      {
        "slug": "SLACK_INVITE_USER_TO_CHANNEL",
        "name": "Invite users to channel",
        "description": "Invites users to a specified Slack channel; this action is restricted to Enterprise Grid workspaces and requires the authenticated user to be a member of the target channel."
      },
      {
        "slug": "SLACK_INVITE_USER_TO_WORKSPACE",
        "name": "Invite user to workspace",
        "description": "Invites a user to a Slack workspace and specified channels by email; use `resend=True` to re-process an existing invitation for a user not yet signed up."
      },
      {
        "slug": "SLACK_JOIN_AN_EXISTING_CONVERSATION",
        "name": "Join conversation by channel id",
        "description": "Joins an existing Slack conversation (public channel, private channel, or multi-person direct message) by its ID, if the authenticated user has permission. Joining an already-joined channel returns a non-fatal no-op response. Private or restricted channel joins may fail with a permission error."
      },
      {
        "slug": "SLACK_LEAVE_A_CONVERSATION",
        "name": "Leave conversation channel",
        "description": "(DEPRECATED: use `SLACK_LEAVE_CONVERSATION`) Leaves a Slack conversation given its channel ID; fails if leaving as the last member of a private channel or if used on a Slack Connect channel."
      },
      {
        "slug": "SLACK_LEAVE_CONVERSATION",
        "name": "Leave conversation channel",
        "description": "Leaves a Slack conversation given its channel ID; fails if leaving as the last member of a private channel or if used on a Slack Connect channel."
      },
      {
        "slug": "SLACK_LIST_ADMIN_APPS_APPROVED",
        "name": "List approved apps",
        "description": "Tool to list approved apps for an Enterprise Grid organization or workspace. Use when you need to retrieve the list of apps that have been approved for installation by workspace admins. Requires admin.apps:read scope and a user token from an org owner/admin context."
      },
      {
        "slug": "SLACK_LIST_ADMIN_APPS_REQUESTS",
        "name": "List app requests",
        "description": "Tool to list pending app installation requests for a team/workspace. Use when you need to see which apps users have requested to install that haven't yet been approved or denied. Requires Enterprise Grid or Business+ plan with admin.apps:read scope."
      },
      {
        "slug": "SLACK_LIST_ADMIN_EMOJI",
        "name": "List admin emoji",
        "description": "List custom emoji across an Enterprise Grid organization. Use when you need to retrieve all custom emoji for an entire Enterprise Grid org (not just a single workspace). Requires admin.teams:read scope and an admin token. For single workspace emoji, use the regular emoji.list method instead."
      },
      {
        "slug": "SLACK_LIST_ALL_CHANNELS",
        "name": "List all channels",
        "description": "Lists conversations available to the user with various filters and search options. Always use resolved `channel_id` (not display names) for downstream operations, as names may be non-unique. The `created` field in results is a Unix epoch timestamp (UTC). Pagination across large workspaces may return HTTP 429 with a `Retry-After` header; honor the delay and resume from the last successful cursor."
      },
      {
        "slug": "SLACK_LIST_ALL_USERS",
        "name": "List all users",
        "description": "Retrieves a paginated list of all users with profile details, status, and team memberships in a Slack workspace; data may not be real-time. Filter response fields `is_bot`, `is_app_user`, and `deleted` to build human-only rosters. Profile fields like `email` and `phone` may be absent depending on OAuth scopes and workspace privacy settings. Guest/restricted accounts may be omitted based on scopes—do not treat results as a complete directory. High-frequency calls risk HTTP 429; honor the `Retry-After` header and throttle to ~1–2 requests/second. Use stable user IDs rather than display names for mapping. Prefer SLACK_FIND_USERS for targeted lookups; cache results to avoid full-workspace fetches."
      },
      {
        "slug": "SLACK_LIST_APPROVED_WORKSPACE_INVITE_REQUESTS",
        "name": "List approved workspace invite requests",
        "description": "List all approved workspace invite requests with pagination support. Use to review which invite requests have been approved and the details of each approval. Requires admin.invites:read scope and Enterprise Grid organization."
      },
      {
        "slug": "SLACK_LIST_AUTH_TEAMS",
        "name": "List authorized teams",
        "description": "Obtains a paginated list of workspaces your org-wide app has been approved for. Use when you need to discover all workspaces within an organization where the app is installed."
      },
      {
        "slug": "SLACK_LIST_AVAILABLE_WORKSPACES",
        "name": "List available workspaces",
        "description": "List Slack workspaces where both the connection and target user have access. Returns each workspace's team_id and name. Use this when: (1) the user references a workspace by name, (2) a user-specific tool requires team_id and you don't have one, or (3) a user-specific call fails with a team/workspace access error. Match the user's workspace name to a team_id from the results and pass that team_id to subsequent tools. If the name matches zero or multiple workspaces, ask the user to clarify. Only meaningful for org-level installs; single-workspace connections return the workspace only if the specified user's membership is visible to this token."
      },
      {
        "slug": "SLACK_LIST_CANVASES",
        "name": "List Slack Canvases (Deprecated)",
        "description": "DEPRECATED: Use SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK instead (pass types=\"canvas\" for equivalent behavior). Lists Slack Canvases with filtering by channel, user, timestamp, and page-based pagination. Uses Slack's files.list API with types=canvas filter. Only canvases accessible to the authenticated app are returned; missing canvases indicate permissions restrictions, not empty data. Use `paging.pages` in the response to determine total pages; iterate `page` with `count` to retrieve all results. Known limitations: - The 'user' filter may return canvases accessible to the specified user, not just canvases they created. - The 'ts_from' and 'ts_to' timestamp filters may not work reliably for canvas types. Consider client-side filtering on the 'created' field in the response if precise date filtering is required."
      },
      {
        "slug": "SLACK_LIST_CONVERSATIONS",
        "name": "List conversations",
        "description": "List conversations (channels/DMs) accessible to a specified user (or the authenticated user if no user ID is provided), respecting shared membership for non-public channels. Returns conversation IDs (C* for channels, G* for group DMs), not display names. Absence of private channels, DMs, or MPIMs from results indicates token scope or membership limits, not that the conversation is nonexistent."
      },
      {
        "slug": "SLACK_LIST_CUSTOM_EMOJIS",
        "name": "List team custom emojis",
        "description": "Retrieves all custom emojis for the Slack workspace (image URLs or aliases), not standard Unicode emojis; does not include usage statistics or creation dates."
      },
      {
        "slug": "SLACK_LIST_DENIED_WORKSPACE_INVITE_REQUESTS",
        "name": "List denied workspace invite requests",
        "description": "Tool to list all denied workspace invite requests with details about who denied them and when. Use when you need to review or audit denied invitation requests."
      },
      {
        "slug": "SLACK_LIST_ENTERPRISE_TEAMS",
        "name": "List Enterprise teams",
        "description": "List all teams (workspaces) in a Slack Enterprise Grid organization with pagination support. Use when you need to retrieve team IDs, names, domains, and metadata for all workspaces in an Enterprise. Requires admin.teams:read scope and Enterprise Grid organization."
      },
      {
        "slug": "SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK",
        "name": "List Slack files",
        "description": "Lists files and their metadata within a Slack workspace, filterable by user, channel, timestamp, or type; returns metadata only, not file content. Results are limited to files visible to the authenticated user — files in private channels or restricted to certain members require appropriate membership and permissions. For large workspaces, check `paging.pages` in the response to determine total pages when paginating."
      },
      {
        "slug": "SLACK_LIST_IDP_GROUPS_LINKED_TO_CHANNEL",
        "name": "List IDP groups linked to channel",
        "description": "Lists IDP groups that have restricted access to a private Slack channel. Use when you need to see which identity provider groups can access a specific channel."
      },
      {
        "slug": "SLACK_LIST_PENDING_WORKSPACE_INVITE_REQUESTS",
        "name": "List pending workspace invite requests",
        "description": "Tool to list all pending workspace invite requests. Use when you need to see who has been invited but hasn't joined yet. Requires admin.invites:read scope."
      },
      {
        "slug": "SLACK_LIST_PINNED_ITEMS",
        "name": "List pinned items in a channel",
        "description": "Retrieves all messages and files pinned to a specified channel; the caller must have access to this channel."
      },
      {
        "slug": "SLACK_LIST_REMINDERS",
        "name": "List reminders",
        "description": "Lists all reminders with their details for the authenticated Slack user; returns an empty array if no reminders exist (valid state, not an error). Reminder text is not unique—perform client-side matching on returned objects before extracting a reminder ID for use with SLACK_DELETE_A_SLACK_REMINDER."
      },
      {
        "slug": "SLACK_LIST_REMOTE_FILES",
        "name": "List remote files",
        "description": "Retrieve information about a team's remote files."
      },
      {
        "slug": "SLACK_LIST_RESTRICTED_APPS",
        "name": "List Restricted Apps",
        "description": "Tool to list restricted apps for an org or workspace. Use when you need to view apps that have been restricted from installation. Requires admin.apps:read scope and appropriate admin permissions."
      },
      {
        "slug": "SLACK_LIST_SCHEDULED_MESSAGES",
        "name": "List scheduled messages",
        "description": "Retrieves a list of pending (not yet delivered) messages scheduled in a specific Slack channel, or across all accessible channels if no channel ID is provided, optionally filtered by time and paginated."
      },
      {
        "slug": "SLACK_LIST_SLACK_LIST_ITEMS",
        "name": "List Slack List items",
        "description": "Lists the rows (items) in a Slack List via `slackLists.items.list`. Each row exposes `column_id`-keyed typed values (e.g. `rich_text`, `select`, `user`, `date`, `number`); the legacy `key`/`value` fields are deprecated. Results are cursor-paginated—you must paginate using `response_metadata.next_cursor` until it is empty, or rows are silently truncated to the first page. Set `archived=true` to return archived rows instead of active ones. Requires a user token with the `lists:read` scope."
      },
      {
        "slug": "SLACK_LIST_STARRED_ITEMS",
        "name": "List starred items",
        "description": "Lists items starred by a user. Returns classic starred items only — does not reflect Slack's 'saved for later' feature. Use SLACK_SEARCH_MESSAGES or SLACK_SEARCH_ALL for broader saved-content queries."
      },
      {
        "slug": "SLACK_LIST_UNREAD_CHANNEL_MESSAGES",
        "name": "List unread channel messages",
        "description": "Lists all unread messages in a specified Slack channel for the authenticated user. This action fetches messages that have been posted since the user's last read position in the channel. Use this action when you need to retrieve messages the user hasn't seen yet. The action determines the user's read position and returns all messages posted after that timestamp. Note: This only returns messages from the main channel timeline, not threaded replies. For threaded replies, use SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION."
      },
      {
        "slug": "SLACK_LIST_USER_GROUP_MEMBERS",
        "name": "List all users in a user group",
        "description": "Retrieves a list of all user IDs within a specified Slack user group, with an option to include users from disabled groups."
      },
      {
        "slug": "SLACK_LIST_USER_GROUPS",
        "name": "List user groups",
        "description": "Lists user groups in a Slack workspace, including user-created and default groups; results for large workspaces may be paginated."
      },
      {
        "slug": "SLACK_LIST_USER_REACTIONS",
        "name": "List user reactions",
        "description": "Lists all reactions added by a specific user to messages, files, or file comments in Slack, useful for engagement analysis when the item content itself is not required. Results are paginated; check `response_metadata.next_cursor` and iterate with the `cursor` parameter to retrieve complete reaction history."
      },
      {
        "slug": "SLACK_LIST_WORKSPACE_ADMINS",
        "name": "List workspace admins",
        "description": "Tool to list all admins on a given Slack workspace. Use when you need to identify workspace administrators. Requires Enterprise Grid organization and admin.teams:read scope."
      },
      {
        "slug": "SLACK_LIST_WORKSPACE_OWNERS",
        "name": "List workspace owners",
        "description": "Tool to list all owners on a given Slack workspace. Use when you need to identify workspace ownership or admin structure. Requires admin.teams:read scope."
      },
      {
        "slug": "SLACK_LIST_WORKSPACE_USERS",
        "name": "List admin users",
        "description": "Retrieves a paginated list of admin users for a specified Slack workspace."
      },
      {
        "slug": "SLACK_LOOKUP_CANVAS_SECTIONS",
        "name": "Lookup Canvas Sections",
        "description": "Looks up section IDs in a Slack Canvas for use with targeted edit operations. Section IDs are needed for insert_after, insert_before, delete, and section-specific replace operations."
      },
      {
        "slug": "SLACK_MANUALLY_SET_USER_PRESENCE",
        "name": "Set user presence",
        "description": "(DEPRECATED: use `SLACK_SET_USER_PRESENCE`) Manually sets a user's Slack presence, overriding automatic detection; this setting persists across connections but can be overridden by user actions or Slack's auto-away (e.g., after 10 mins of inactivity)."
      },
      {
        "slug": "SLACK_OPEN_DM",
        "name": "Open DM",
        "description": "Opens or resumes a Slack direct message (DM) or multi-person direct message (MPIM) by providing either user IDs or an existing channel ID. Returns `already_open=true` when the DM exists — treat as success and reuse the returned `channel.id` (starts with 'D') for subsequent SLACK_SEND_MESSAGE calls; passing a username, email, or user ID directly to SLACK_SEND_MESSAGE causes `channel_not_found`. Avoid redundant calls when an existing DM channel ID is available."
      },
      {
        "slug": "SLACK_PIN_ITEM",
        "name": "Pin an item to a channel",
        "description": "Pins a message to a specified Slack channel; the message must not already be pinned."
      },
      {
        "slug": "SLACK_READ_AUDIT_LOGS",
        "name": "Read Audit Logs",
        "description": "Read Slack Enterprise Grid Audit Logs (logins, admin changes, app installs, channel/privacy changes, etc.) with server-side filters and pagination. Requires Enterprise Grid organization with auditlogs:read scope and a user token (xoxp-...) from an owner/admin context."
      },
      {
        "slug": "SLACK_REMOVE_CALL_PARTICIPANTS",
        "name": "Remove call participants",
        "description": "Registers participants removed from a Slack call."
      },
      {
        "slug": "SLACK_REMOVE_EMOJI",
        "name": "Remove emoji",
        "description": "Tool to remove a custom emoji across an Enterprise Grid organization. Use when you need to delete a custom emoji from the entire organization."
      },
      {
        "slug": "SLACK_REMOVE_REACTION_FROM_ITEM",
        "name": "Remove reaction from item",
        "description": "Removes an emoji reaction from a message, file, or file comment in Slack. Provide exactly one targeting method: channel+timestamp together, file, or file_comment. Mixing methods or omitting all returns invalid_arguments."
      },
      {
        "slug": "SLACK_REMOVE_REMOTE_FILE",
        "name": "Remove remote file",
        "description": "Removes the Slack reference to an external file (which must have been previously added via the remote files API), specified by either its `external_id` or `file` ID (one of which is required), without deleting the actual external file."
      },
      {
        "slug": "SLACK_REMOVE_STAR",
        "name": "Remove a star from an item",
        "description": "Removes a star from a previously starred Slack item (message, file, file comment, channel, group, or DM), requiring identification via `file`, `file_comment`, `channel` (for channel/group/DM), or both `channel` and `timestamp` (for a message)."
      },
      {
        "slug": "SLACK_REMOVE_USER_FROM_CONVERSATION",
        "name": "Remove user from conversation",
        "description": "Removes a specified user from a Slack conversation (channel); the caller must have permissions to remove users and cannot remove themselves using this action."
      },
      {
        "slug": "SLACK_REMOVE_USER_FROM_WORKSPACE",
        "name": "Remove user from workspace",
        "description": "Tool to remove a user from a Slack workspace. Use when you need to revoke a user's access to a workspace."
      },
      {
        "slug": "SLACK_RENAME_CONVERSATION",
        "name": "Rename a conversation",
        "description": "Renames a Slack channel, automatically adjusting the new name to meet naming conventions (e.g., converting to lowercase), which may affect integrations using the old name."
      },
      {
        "slug": "SLACK_RENAME_EMOJI",
        "name": "Rename an emoji",
        "description": "Renames an existing custom emoji in a Slack workspace, updating all its instances."
      },
      {
        "slug": "SLACK_RESET_USER_SESSIONS",
        "name": "Reset user sessions",
        "description": "Tool to wipe all valid sessions on all devices for a given user. Use when you need to force a user to re-authenticate due to security concerns or account changes."
      },
      {
        "slug": "SLACK_RESTRICT_APP_INSTALLATION",
        "name": "Restrict app installation",
        "description": "Restrict an app for installation on a workspace. Use when you need to prevent an app from being installed on a specific workspace or enterprise organization."
      },
      {
        "slug": "SLACK_RETRIEVE_A_USER_S_IDENTITY_DETAILS",
        "name": "Retrieve a user's identity details",
        "description": "Retrieves the authenticated user's and their team's identity, with details varying based on OAuth scopes (e.g., `identity.basic`, `identity.email`, `identity.avatar`)."
      },
      {
        "slug": "SLACK_RETRIEVE_CONVERSATION_INFORMATION",
        "name": "Retrieve conversation information",
        "description": "Retrieves metadata for a Slack conversation by ID (e.g., name, purpose, creation date, with options for member count/locale), excluding message content. The `channel` parameter is effectively required. Private channels, DMs, or channels where the app lacks membership may return restricted data; check `is_archived` and `is_member` fields in the response to diagnose access issues. Bulk lookups may trigger HTTP 429 rate limiting; honor the `Retry-After` response header."
      },
      {
        "slug": "SLACK_RETRIEVE_CONVERSATION_MEMBERS_LIST",
        "name": "Get conversation members",
        "description": "Retrieves a paginated list of active member IDs (not names, emails, or presence) for a specified Slack public channel, private channel, DM, or MPIM. Returns only user IDs; use a user-lookup tool to enrich member data."
      },
      {
        "slug": "SLACK_RETRIEVE_CURRENT_USER_DND_STATUS",
        "name": "Retrieve user DND status",
        "description": "Retrieves a Slack user's current Do Not Disturb (DND) status to determine their availability before interaction; any specified user ID must be a valid Slack user ID."
      },
      {
        "slug": "SLACK_RETRIEVE_DETAILED_INFORMATION_ABOUT_A_FILE",
        "name": "Retrieve detailed file information",
        "description": "Retrieves detailed metadata and paginated comments for a specific Slack file ID; does not download file content."
      },
      {
        "slug": "SLACK_RETRIEVE_DETAILED_USER_INFORMATION",
        "name": "Retrieve detailed user information",
        "description": "Retrieves comprehensive information for a valid Slack user ID, excluding message history and channel memberships. Sensitive fields like `email` and `phone` require the `users:read.email` scope and may be silently omitted based on workspace privacy policies."
      },
      {
        "slug": "SLACK_RETRIEVE_MESSAGE_PERMALINK_URL",
        "name": "Retrieve message permalink",
        "description": "Retrieves a permalink URL for a specific message in a Slack channel or conversation; the permalink respects Slack's privacy settings."
      },
      {
        "slug": "SLACK_RETRIEVE_USER_PROFILE_INFORMATION",
        "name": "Retrieve user profile information",
        "description": "Retrieves profile information for a specified Slack user (defaults to the authenticated user if `user` ID is omitted); a provided `user` ID must be valid. Sensitive fields like email and phone may be silently omitted if required scopes (e.g., `users:read.email`) are not granted or workspace privacy policies restrict access."
      },
      {
        "slug": "SLACK_REVOKE_FILE_PUBLIC_SHARING",
        "name": "Revoke a file's public url",
        "description": "Revokes a Slack file's public URL, making it private; this is a no-op if not already public and is irreversible."
      },
      {
        "slug": "SLACK_RTM_CONNECT",
        "name": "Start RTM session",
        "description": "Starts a Real Time Messaging session and returns a WebSocket URL. Use when you need to establish a persistent RTM connection to receive real-time events from Slack."
      },
      {
        "slug": "SLACK_RTM_START",
        "name": "Start RTM session",
        "description": "Starts a Real Time Messaging API session for Slack. Use when you need to establish an RTM connection with additional options beyond rtm.connect. Note: RTM API is deprecated; consider Socket Mode for new apps."
      },
      {
        "slug": "SLACK_SCHEDULE_MESSAGE",
        "name": "Schedule message",
        "description": "Schedules a message to a Slack channel, DM, or private group for a future time (`post_at`), requiring `text`, `blocks`, or `attachments` for content; scheduling is limited to 120 days in advance."
      },
      {
        "slug": "SLACK_SCIM_GET_CONFIG",
        "name": "Get SCIM service provider configuration",
        "description": "Tool to retrieve SCIM service provider configuration from Slack. Use when you need to discover Slack's SCIM API capabilities including supported authentication schemes, bulk operations, filtering, and other service provider features."
      },
      {
        "slug": "SLACK_SEARCH_ALL",
        "name": "Search all content",
        "description": "Tool to search all messages and files. Use when you need unified content search across channels and files in one call. Results are scoped to content visible to the authenticated token; missing hits in private or restricted channels reflect permission/membership gaps. Response separates messages and files into distinct sections — explicitly read the files section for document results. Results are index-based and may lag several minutes behind real-time; use SLACK_FETCH_CONVERSATION_HISTORY for near-real-time per-channel coverage. Paginated searches exceeding ~1 req/sec may return HTTP 429 too_many_requests; honor the Retry-After header and resume from the last page."
      },
      {
        "slug": "SLACK_SEARCH_MESSAGES",
        "name": "Search messages",
        "description": "Workspace‑wide Slack message search with date ranges and filters. Use `query` modifiers (e.g., in:#channel, from:@user, before/after:YYYY-MM-DD), sorting (score/timestamp), and pagination."
      },
      {
        "slug": "SLACK_SEND_EPHEMERAL_MESSAGE",
        "name": "Send ephemeral message",
        "description": "Sends an ephemeral message visible only to the specified `user` in a channel; other channel members cannot see it. Both the bot and the target user must be members of the specified channel."
      },
      {
        "slug": "SLACK_SEND_ME_MESSAGE",
        "name": "Share a me message in a channel",
        "description": "Sends a 'me message' (e.g., '/me is typing') to a Slack channel, where it's displayed as a third-person user action; messages are plain text and the channel must exist and be accessible."
      },
      {
        "slug": "SLACK_SEND_MESSAGE",
        "name": "Send message",
        "description": "Posts a message to a Slack channel, DM, or private group. Provide exactly one visible content mode: `markdown_text` for normal Markdown content, or `blocks` for raw Slack Block Kit layouts. Use `fallback_text` only with `blocks`; it maps to Slack's top-level `text` fallback. Fails with `not_in_channel`, `channel_not_found`, or `channel_is_archived` if the bot lacks access. Rate-limited at ~1 req/sec (HTTP 429, honor `Retry-After`). Not idempotent — duplicate calls post duplicate messages."
      },
      {
        "slug": "SLACK_SET_ADMIN_USER",
        "name": "Set admin user",
        "description": "Promotes an existing workspace member (guest, regular user, or owner) to admin status. Use when you need to grant admin privileges to a user."
      },
      {
        "slug": "SLACK_SET_CONVERSATION_PREFS",
        "name": "Set conversation preferences",
        "description": "Sets the posting permissions for a public or private channel in Slack. Use this to control who can post messages, start threads, use @channel/@here mentions, and initiate huddles in a specific channel."
      },
      {
        "slug": "SLACK_SET_CONVERSATION_PURPOSE",
        "name": "Set a conversation's purpose",
        "description": "Sets the purpose (a short description of its topic/goal, displayed in the header) for a Slack conversation; the calling user must be a member."
      },
      {
        "slug": "SLACK_SET_DEFAULT_CHANNELS",
        "name": "Set default channels",
        "description": "Tool to set the default channels of a workspace. Use when you need to configure which channels new members automatically join."
      },
      {
        "slug": "SLACK_SET_DND_DURATION",
        "name": "Set DND duration",
        "description": "Turns on Do Not Disturb mode for the current user, or changes its duration."
      },
      {
        "slug": "SLACK_SET_PROFILE_PHOTO",
        "name": "Set profile photo",
        "description": "This method allows the user to set their profile image."
      },
      {
        "slug": "SLACK_SET_READ_CURSOR_IN_A_CONVERSATION",
        "name": "Set conversation read cursor",
        "description": "Marks a message, specified by its timestamp (`ts`), as the most recently read for the authenticated user in the given `channel`, provided the user is a member of the channel and the message exists within it."
      },
      {
        "slug": "SLACK_SET_SLACK_LIST_ACCESS",
        "name": "Set Slack List access",
        "description": "Grants or sets sharing access on a Slack List via `slackLists.access.set`. Grant `read`, `write`, or `owner` access to either channels (`channel_ids`) or users (`user_ids`) — exactly one of the two is required. The `owner` level is user-only and subject to additional server-side rules. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACK_SET_STATUS",
        "name": "Set Slack user profile information",
        "description": "(DEPRECATED: use `SLACK_SET_USER_PROFILE`) Updates a Slack user's profile, setting either individual fields or multiple fields via a JSON object."
      },
      {
        "slug": "SLACK_SET_THE_TOPIC_OF_A_CONVERSATION",
        "name": "Set conversation topic",
        "description": "Sets or updates the topic for a specified Slack conversation."
      },
      {
        "slug": "SLACK_SET_USER_ACTIVE",
        "name": "Mark user as active",
        "description": "Tool to mark a user as active in Slack. Note: This endpoint is deprecated and non-functional - it exists for backwards compatibility but does not perform any action."
      },
      {
        "slug": "SLACK_SET_USER_PRESENCE",
        "name": "Set user presence",
        "description": "Manually sets a user's Slack presence, overriding automatic detection; this setting persists across connections but can be overridden by user actions or Slack's auto-away (e.g., after 10 mins of inactivity)."
      },
      {
        "slug": "SLACK_SET_USER_PROFILE",
        "name": "Set Slack user profile information",
        "description": "Updates a Slack user's profile, setting either individual fields or multiple fields via a JSON object."
      },
      {
        "slug": "SLACK_SET_WORKSPACE_DESCRIPTION",
        "name": "Set workspace description",
        "description": "Set the description of a given workspace. Use when you need to update or change the description text displayed for a Slack workspace."
      },
      {
        "slug": "SLACK_SET_WORKSPACE_ICON",
        "name": "Set workspace icon",
        "description": "Sets the icon of a workspace. Use when you need to update or change the workspace icon image. The image must be publicly accessible and in a supported format (GIF, PNG, JPG, JPEG, HEIC, or HEIF)."
      },
      {
        "slug": "SLACK_SET_WORKSPACE_NAME",
        "name": "Set workspace name",
        "description": "Set the name of a given Slack workspace. Use when you need to update the display name for a workspace in an Enterprise Grid organization."
      },
      {
        "slug": "SLACK_SET_WORKSPACE_OWNER",
        "name": "Set workspace owner",
        "description": "Set an existing guest, regular user, or admin user to be a workspace owner. Use when you need to promote a workspace member to owner status. Requires an Enterprise Grid workspace."
      },
      {
        "slug": "SLACK_SET_WORKSPACES_FOR_CHANNEL",
        "name": "Set workspaces for channel",
        "description": "Set the workspaces in an Enterprise grid org that connect to a channel. Use when you need to share a public or private channel with specific workspaces in an Enterprise Grid organization."
      },
      {
        "slug": "SLACK_SHARE_REMOTE_FILE",
        "name": "Share a remote file in channels",
        "description": "Shares a remote file, which must already be registered with Slack, into specified Slack channels or direct message conversations."
      },
      {
        "slug": "SLACK_START_CALL",
        "name": "Start call",
        "description": "Registers a new call in Slack using `calls.add` for third-party call integration; `created_by` is required if not using a user-specific token."
      },
      {
        "slug": "SLACK_TEST_AUTH",
        "name": "Test authentication",
        "description": "Checks authentication and tells you who you are. Use to verify Slack API authentication is functional and to retrieve identity information about the authenticated user or bot."
      },
      {
        "slug": "SLACK_UNARCHIVE_CHANNEL",
        "name": "Unarchive channel",
        "description": "Reverses conversation archival."
      },
      {
        "slug": "SLACK_UNPIN_ITEM",
        "name": "Unpin message from channel",
        "description": "Unpins a message, identified by its timestamp, from a specified channel if the message is currently pinned there; this operation is destructive."
      },
      {
        "slug": "SLACK_UPDATE_CALL_INFO",
        "name": "Update call information",
        "description": "Updates the title, join URL, or desktop app join URL for an existing Slack call identified by its ID."
      },
      {
        "slug": "SLACK_UPDATE_REMOTE_FILE",
        "name": "Update an existing remote file",
        "description": "Updates metadata or content details for an existing remote file in Slack; this action cannot upload new files or change the fundamental file type."
      },
      {
        "slug": "SLACK_UPDATES_A_SLACK_MESSAGE",
        "name": "Update a Slack message",
        "description": "Updates a Slack message by timestamp. Provide exactly one visible content mode: `markdown_text` for normal Markdown content, or `blocks` for raw Slack Block Kit layouts. Use `fallback_text` only with `blocks`; it maps to Slack's top-level `text` fallback."
      },
      {
        "slug": "SLACK_UPDATE_SLACK_LIST",
        "name": "Update Slack List",
        "description": "Updates a Slack List's metadata via `slackLists.update`. Only the List's `name`, `description_blocks`, and `todo_mode` are editable here. The List to update is identified by its `id` (not `list_id`). Descriptions are rich text — a plain string is wrapped into a `rich_text` block automatically. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACK_UPDATE_SLACK_LIST_ITEM",
        "name": "Update Slack List item",
        "description": "Updates one or more cells in an EXISTING Slack List row via `slackLists.items.update`. Each cell is identified by `row_id` (an existing row ID matching `^Rec[A-Z0-9]{8,}$`) and `column_id` and carries a typed value; text columns require Block Kit `rich_text` (a plain string is wrapped automatically), and `select` takes the column's choice values (e.g. `[\"todo\"]`). Use it to UPDATE existing rows; the live API rejects `row_id_to_create` inside a cell (despite Slack's inline example), so to ADD a row use `create_slack_list_item`. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACK_UPDATE_USER_GROUP",
        "name": "Update Slack user group",
        "description": "Updates an existing Slack User Group, which must be specified by an existing `usergroup` ID, with new optional details such as its name, description, handle, or default channels."
      },
      {
        "slug": "SLACK_UPDATE_USER_GROUP_MEMBERS",
        "name": "Update user group members",
        "description": "Replaces all members of an existing Slack User Group with a new list of valid user IDs."
      },
      {
        "slug": "SLACK_UPLOAD_OR_CREATE_A_FILE_IN_SLACK",
        "name": "Upload or create a file in Slack",
        "description": "Upload files, images, screenshots, documents, or any media to Slack channels or threads. Supports all file types including images (PNG, JPG, JPEG, GIF), documents (PDF, DOCX, TXT), code files, and more. Can share files publicly in channels or as thread replies with optional comments. Large files may fail with `upload_too_large`; use SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICE for large uploads. If the API returns `ok=false` with `method_deprecated`, fall back to SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICE or SLACK_SEND_MESSAGE with a URL."
      }
    ],
    "triggers": [
      {
        "slug": "SLACK_CHANNEL_CREATED",
        "name": "New Channel Created Trigger",
        "description": "Triggered when a new channel is created in Slack."
      },
      {
        "slug": "SLACK_CHANNEL_MESSAGE_RECEIVED",
        "name": "Channel Message Received",
        "description": "Triggered when a message is posted in a Slack channel\n(public, private, or multi-party IM). Does NOT match direct messages."
      },
      {
        "slug": "SLACK_DIRECT_MESSAGE_RECEIVED",
        "name": "Direct Message Received",
        "description": "Triggered when a new direct message (DM) is sent to a user in Slack.\nCatches all DMs across all DM channels."
      },
      {
        "slug": "SLACK_MESSAGE_REACTION_ADDED",
        "name": "Message Reaction Added",
        "description": "Triggered when a reaction is added to a message in Slack.\nSupports optional filtering by channel and emoji name."
      },
      {
        "slug": "SLACK_MESSAGE_REACTION_REMOVED",
        "name": "Message Reaction Removed",
        "description": "Triggered when a reaction is removed from a message in Slack.\nSupports optional filtering by channel and emoji name."
      },
      {
        "slug": "SLACK_REACTION_ADDED",
        "name": "Reaction Added Trigger",
        "description": "DEPRECATED: use `SLACK_MESSAGE_REACTION_ADDED` instead.\n\nTriggered when a reaction is added to a message in Slack."
      },
      {
        "slug": "SLACK_REACTION_REMOVED",
        "name": "Reaction Removed Trigger",
        "description": "DEPRECATED: use `SLACK_MESSAGE_REACTION_REMOVED` instead.\n\nTriggered when a reaction is removed from a message."
      },
      {
        "slug": "SLACK_RECEIVE_BOT_MESSAGE",
        "name": "New Bot Message Received Trigger",
        "description": "DEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` with\n`is_bot_message=true` instead.\n\nTriggered when a new bot message is posted to a Slack channel."
      },
      {
        "slug": "SLACK_RECEIVE_MESSAGE",
        "name": "New Message Received Trigger",
        "description": "DEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` instead.\n\nTriggered when a new message is posted to a Slack channel."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "slack_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "User Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "calls:read,calls:write,channels:history,channels:read,channels:write,chat:write,dnd:read,dnd:write,emoji:read,files:read,files:write,groups:history,groups:read,groups:write,im:history,im:read,im:write,links:read,links:write,lists:read,lists:write,mpim:history,mpim:read,mpim:write,pins:read,pins:write,reactions:read,reactions:write,reminders:read,reminders:write,remote_files:read,remote_files:share,search:read,search:read.files,search:read.im,search:read.mpim,search:read.private,search:read.public,search:read.users,team:read,usergroups:read,usergroups:write,users.profile:read,users.profile:write,users:read,users:read.email,users:write"
              },
              {
                "name": "verification_token",
                "displayName": "Verification Token",
                "type": "string",
                "description": "Verification token required to verify the request is coming from slack. You can find it in the slack app settings just below the client id and secret. It is required to enable Slack triggers.",
                "required": false,
                "default": null
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": [
              {
                "name": "generic_id",
                "displayName": "Slack Team ID",
                "type": "string",
                "description": "Optional Slack workspace ID used to scope the OAuth authorize flow to a specific team. When provided, Slack will only allow installation in this workspace. Leave unset to let users pick any workspace they have access to.",
                "required": false,
                "default": null
              }
            ]
          }
        }
      }
    ]
  },
  {
    "slug": "supabase",
    "name": "Supabase",
    "logo": "https://logos.composio.dev/api/supabase",
    "description": "Supabase is an open-source backend-as-a-service providing a Postgres database, authentication, storage, and real-time subscription APIs for building modern applications",
    "category": "developer tools",
    "authSchemes": [
      "OAUTH2",
      "API_KEY"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 129,
    "triggerCount": 0,
    "version": "20260815_00",
    "tools": [
      {
        "slug": "SUPABASE_ALPHA_CREATE_API_KEY",
        "name": "Create project api key",
        "description": "Creates a 'publishable' or 'secret' API key for an existing Supabase project, optionally with a description; 'secret' keys can have customized JWT templates."
      },
      {
        "slug": "SUPABASE_ALPHA_DELETE_API_KEY",
        "name": "Delete an API key from the project",
        "description": "Permanently deletes a specific API key (identified by `id`) from a Supabase project (identified by `ref`), revoking its access."
      },
      {
        "slug": "SUPABASE_ALPHA_DELETE_THIRD_PARTY_AUTH_INTEGRATION",
        "name": "Delete third party auth config",
        "description": "Removes a third-party authentication provider (e.g., Google, GitHub) from a Supabase project's configuration; this immediately prevents users from logging in via that method."
      },
      {
        "slug": "SUPABASE_ALPHA_GET_THIRD_PARTY_INTEGRATION",
        "name": "Get a third-party integration",
        "description": "Retrieves the detailed configuration for a specific third-party authentication (TPA) provider, identified by `tpa_id`, within an existing Supabase project specified by `ref`."
      },
      {
        "slug": "SUPABASE_ALPHA_LIST_THIRD_PARTY_AUTH_INTEGRATIONS",
        "name": "List third-party auth integrations for project",
        "description": "Lists all configured third-party authentication provider integrations for an existing Supabase project (using its `ref`), suitable for read-only auditing or verifying current authentication settings."
      },
      {
        "slug": "SUPABASE_ALPHA_UPDATE_API_KEY",
        "name": "Update an API key for the project",
        "description": "Updates an existing Supabase project API key's `description` and/or `secret_jwt_template` (which defines its `role`); does not regenerate the key string."
      },
      {
        "slug": "SUPABASE_APPLY_A_MIGRATION",
        "name": "Apply a database migration",
        "description": "Tool to apply database migrations to a Supabase project. Use when you need to execute SQL schema changes, create tables, alter columns, or run other DDL/DML operations as part of a tracked migration. This is a Beta feature in the Supabase Management API."
      },
      {
        "slug": "SUPABASE_BETA_ACTIVATE_CUSTOM_HOSTNAME",
        "name": "Beta activate custom hostname for project",
        "description": "Activates a previously configured custom hostname for a Supabase project, assuming DNS settings are verified externally."
      },
      {
        "slug": "SUPABASE_BETA_ACTIVATE_VANITY_SUBDOMAIN",
        "name": "Activate vanity subdomain for project",
        "description": "Activates a vanity subdomain for the specified Supabase project (e.g., 'my-brand.supabase.co'). Important notes: - Vanity subdomains require a paid plan (Pro/Team/Enterprise) - Usage of vanity subdomains and custom domains is mutually exclusive - After activation, your project's auth services will no longer work on the original {project-ref}.supabase.co hostname - Schedule a downtime window to update client code and OAuth providers before activating"
      },
      {
        "slug": "SUPABASE_BETA_AUTHORIZE_USER_THROUGH_OAUTH",
        "name": "Authorize user through OAuth",
        "description": "Generates a Supabase OAuth 2.0 authorization URL for user redirection. IMPORTANT: This action requires a pre-registered OAuth client_id and a redirect_uri that matches one of the pre-registered URIs for that OAuth application. Without a valid registered OAuth application, this endpoint will return a 400 error. To use this action: 1. Register an OAuth application in the Supabase dashboard 2. Use the client_id from the registered application 3. Ensure redirect_uri matches one of the registered callback URLs"
      },
      {
        "slug": "SUPABASE_BETA_CHECK_VANITY_SUBDOMAIN_AVAILABILITY",
        "name": "Check vanity subdomain availability",
        "description": "Checks if a specific vanity subdomain is available for a Supabase project; this action does not reserve or assign the subdomain."
      },
      {
        "slug": "SUPABASE_BETA_CREATE_READ_REPLICA",
        "name": "Setup read replica for project",
        "description": "Provisions a read-only replica for a Supabase project in a specified, Supabase-supported AWS region to enhance read performance and reduce latency."
      },
      {
        "slug": "SUPABASE_BETA_ENABLE_DATABASE_WEBHOOKS",
        "name": "Enable project database webhooks",
        "description": "Enables database webhooks for the Supabase project `ref`, triggering real-time notifications for INSERT, UPDATE, or DELETE events."
      },
      {
        "slug": "SUPABASE_BETA_GET_PROJECT_CUSTOM_HOSTNAME_CONFIG",
        "name": "Beta get project's custom hostname config",
        "description": "Retrieves a Supabase project's custom hostname configuration, including its status, SSL certificate, and ownership verification, noting that availability may depend on the project's plan."
      },
      {
        "slug": "SUPABASE_BETA_GET_PROJECT_NETWORK_BANS",
        "name": "Retrieve network bans for project",
        "description": "Retrieves the list of banned IPv4 addresses for a Supabase project using its unique project reference string; this is a read-only operation."
      },
      {
        "slug": "SUPABASE_BETA_GET_PROJECT_NETWORK_RESTRICTIONS",
        "name": "Get project network restrictions",
        "description": "Retrieves the network restriction settings (IP allowlists) for a Supabase project. Use this action to: - Check which IPv4/IPv6 CIDR blocks are allowed to connect to the project's database - Verify if network restrictions are enabled (entitlement: \"allowed\") or disabled (\"disallowed\") - Audit current network security configuration - Check if network restrictions have been modified (old_config present) Note: Default values 0.0.0.0/0 (IPv4) and ::/0 (IPv6) mean all IPs are allowed. Network restrictions require a Pro, Team, or Enterprise plan."
      },
      {
        "slug": "SUPABASE_BETA_GET_PROJECT_PGSODIUM_CONFIG",
        "name": "Get project pgsodium config",
        "description": "Retrieves the PGSodium configuration, including the root encryption key, for an existing Supabase project identified by its `ref`."
      },
      {
        "slug": "SUPABASE_BETA_GET_PROJECT_SSL_ENFORCEMENT_CONFIG",
        "name": "Get project SSL enforcement configuration",
        "description": "Retrieves the SSL enforcement configuration for a specified Supabase project, indicating if SSL connections are mandated for its database."
      },
      {
        "slug": "SUPABASE_BETA_GET_VANITY_SUBDOMAIN_CONFIG",
        "name": "Get current vanity subdomain config",
        "description": "Fetches the current vanity subdomain configuration, including its status and custom domain name, for a Supabase project identified by its reference ID."
      },
      {
        "slug": "SUPABASE_BETA_REMOVE_NETWORK_BANS",
        "name": "Remove project network bans",
        "description": "Removes specified IPv4 addresses from a Supabase project's network ban list, granting immediate access; IPs not currently banned are ignored."
      },
      {
        "slug": "SUPABASE_BETA_REMOVE_READ_REPLICA",
        "name": "Remove read replica",
        "description": "Remove a read replica from a Supabase project (Pro plan or higher required). This beta endpoint initiates the removal of a specified read replica database. The operation is irreversible. Before removal, ensure all application traffic is redirected from the replica to the primary database. Requirements: - Project must be on Pro plan or higher - Bearer token with infra_read_replicas_write permission (FGA) - Valid read replica database identifier Note: Returns 201 on success with an empty response body."
      },
      {
        "slug": "SUPABASE_BETA_RUN_SQL_QUERY",
        "name": "Execute project database query",
        "description": "Executes a given SQL query against the project's database; use for advanced data operations or when standard API endpoints are insufficient, ensuring queries are valid PostgreSQL and sanitized. Use the get_table_schemas or generate_type_script_types tool to retrieve the table schema, then base your query on it."
      },
      {
        "slug": "SUPABASE_BETA_UPDATE_PROJECT_NETWORK_RESTRICTIONS",
        "name": "Beta update project network restrictions",
        "description": "Updates and applies network access restrictions (IPv4/IPv6 CIDR lists) for a Supabase project, which may terminate existing connections not matching the new rules."
      },
      {
        "slug": "SUPABASE_BETA_UPGRADE_PROJECT_POSTGRES_VERSION",
        "name": "Upgrade the project's PostgreSQL version",
        "description": "Initiates an asynchronous upgrade of a Supabase project's PostgreSQL database to a specified `target_version` from a selected `release_channel`, returning a `tracking_id` to monitor status; the `target_version` must be available in the chosen channel."
      },
      {
        "slug": "SUPABASE_COUNT_ACTION_RUNS",
        "name": "Count action runs",
        "description": "Counts the number of action runs for a Supabase project using a HEAD request. Use this when you need to retrieve the total count of action runs without fetching the full list of runs."
      },
      {
        "slug": "SUPABASE_CREATE_A_PROJECT",
        "name": "Create new project",
        "description": "Creates a new Supabase project, requiring a unique name (no dots) within the organization; project creation is asynchronous."
      },
      {
        "slug": "SUPABASE_CREATE_BULK_SECRETS",
        "name": "Bulk create secrets",
        "description": "Tool to bulk create secrets for a Supabase project. Use when you need to create multiple project secrets at once. Each secret name must not start with SUPABASE_."
      },
      {
        "slug": "SUPABASE_CREATE_DATABASE_BRANCH",
        "name": "Create a database branch",
        "description": "Creates a new, isolated database branch from an existing Supabase project (identified by `ref`), useful for setting up separate environments like development or testing, which can optionally be linked to a Git branch."
      },
      {
        "slug": "SUPABASE_CREATE_FUNCTION",
        "name": "Create a function",
        "description": "Creates a new serverless Edge Function for a Supabase project (identified by `ref`), requiring valid JavaScript/TypeScript in `body` and a project-unique `slug` identifier."
      },
      {
        "slug": "SUPABASE_CREATE_LOGIN_ROLE",
        "name": "Create CLI login role",
        "description": "Creates a temporary CLI login role for database access with specified permissions; use when setting up CLI authentication for development or administrative tasks."
      },
      {
        "slug": "SUPABASE_CREATE_ORGANIZATION",
        "name": "Create an organization",
        "description": "Creates a new Supabase organization, which serves as a top-level container for projects, billing, and team access."
      },
      {
        "slug": "SUPABASE_CREATE_PROJECT_SIGNING_KEY",
        "name": "Create project signing key",
        "description": "Create a new signing key for JWT authentication in a Supabase project. The key is created in standby status by default and must be activated separately."
      },
      {
        "slug": "SUPABASE_CREATE_SSO_PROVIDER",
        "name": "Create SSO provider configuration",
        "description": "Creates a new SAML 2.0 Single Sign-On (SSO) provider for a Supabase project, requiring either `metadata_xml` or `metadata_url` for SAML IdP configuration."
      },
      {
        "slug": "SUPABASE_CREATE_THIRD_PARTY_AUTH_INTEGRATION",
        "name": "Create a new third-party auth integration",
        "description": "Call this to add a new third-party authentication method (OIDC or JWKS) to a Supabase project for integrating external identity providers (e.g., for SSO); the API may also support `custom_jwks` if sent directly."
      },
      {
        "slug": "SUPABASE_DELETE_ALL_BRANCHES",
        "name": "Delete all branches",
        "description": "Disables preview branching for a Supabase project, which deletes all remaining branches. IMPORTANT: Before calling this endpoint, you must manually delete all non-default branches. The API will reject the request with a 422 error if non-default branches exist. Use this action when you need to completely disable the preview branching feature for a project. This action is irreversible - all branches will be permanently removed and preview branching will be disabled. Requirements: - Preview branching must be enabled on the project - All non-default branches must be deleted first - Project must be on Pro plan or above to have preview branching"
      },
      {
        "slug": "SUPABASE_DELETE_CUSTOM_HOSTNAME_CONFIG",
        "name": "Delete custom hostname config",
        "description": "Deletes an active custom hostname configuration for the project identified by `ref`, reverting to the default Supabase-provided hostname; this action immediately makes the project inaccessible via the custom domain and requires subsequent updates to client, OAuth, and DNS settings."
      },
      {
        "slug": "SUPABASE_DELETE_DATABASE_BRANCH",
        "name": "Delete branch by id",
        "description": "Permanently and irreversibly deletes a specific, non-default database branch by its `branch_id`, without affecting other branches."
      },
      {
        "slug": "SUPABASE_DELETE_EDGE_FUNCTION",
        "name": "Delete edge function",
        "description": "Deletes an Edge Function from a Supabase project by its slug. Use this action when you need to permanently remove a deployed Edge Function that is no longer needed or should be replaced. This action is irreversible — the function cannot be recovered once deleted, though you can redeploy it from source if needed."
      },
      {
        "slug": "SUPABASE_DELETE_FUNCTION",
        "name": "Delete an edge function by slug",
        "description": "Permanently deletes a specific Edge Function (by `function_slug`) from a Supabase project (by `ref`); this action is irreversible and requires prior existence of both project and function."
      },
      {
        "slug": "SUPABASE_DELETE_LOGIN_ROLES",
        "name": "Delete CLI login roles",
        "description": "[Beta] Deletes existing login roles used by the Supabase CLI for the specified project. Use when you need to remove CLI authentication roles that were previously created for project access."
      },
      {
        "slug": "SUPABASE_DELETE_PROJECT",
        "name": "Delete a project",
        "description": "Permanently and irreversibly deletes a Supabase project and all associated resources, including databases, storage, and configurations. This action is irreversible — the project cannot be recovered once deleted. Use when you need to completely remove a project from your organization."
      },
      {
        "slug": "SUPABASE_DELETE_PROJECT_VANITY_SUBDOMAIN",
        "name": "Delete vanity subdomain for project",
        "description": "Permanently and irreversibly deletes an active vanity subdomain configuration for the specified Supabase project, reverting it to its default Supabase URL."
      },
      {
        "slug": "SUPABASE_DELETE_SECRETS",
        "name": "Bulk delete secrets",
        "description": "Deletes one or more secrets from a Supabase project by their names. This action is irreversible - deleted secrets cannot be recovered. Use this action when you need to remove environment variables or configuration secrets that are no longer needed or should be replaced. Supports both single and bulk deletion operations through the same endpoint."
      },
      {
        "slug": "SUPABASE_DELETE_SSO_PROVIDER",
        "name": "Remove an SSO provider",
        "description": "Deletes a specific SSO provider by its ID (`provider_id`) from a Supabase project (`ref`), which disables it and returns its details; ensure this action will not inadvertently lock out users."
      },
      {
        "slug": "SUPABASE_DEPLOY_FUNCTION",
        "name": "Deploy function",
        "description": "Deploys Edge Functions to a Supabase project using multipart upload."
      },
      {
        "slug": "SUPABASE_DISABLE_PREVIEW_BRANCHING",
        "name": "Disable preview branching",
        "description": "Disables the preview branching feature for an existing Supabase project, identified by its unique reference ID (`ref`). Note: Preview branching must be enabled on the project for this operation to succeed. If the project does not have preview branching enabled, a 422 error will be returned."
      },
      {
        "slug": "SUPABASE_DISABLE_PROJECT_READONLY",
        "name": "Disable project readonly mode",
        "description": "Temporarily disables a Supabase project's read-only mode for 15 minutes to allow write operations (e.g., for maintenance or critical updates), after which it automatically reverts to read-only."
      },
      {
        "slug": "SUPABASE_EXCHANGE_OAUTH_TOKEN",
        "name": "Exchange auth code for access and refresh token",
        "description": "(Beta) Implements the OAuth 2.0 token endpoint to exchange an authorization code or refresh token for access/refresh tokens, based on `grant_type`. This is a standard OAuth 2.0 token endpoint that uses application/x-www-form-urlencoded content type as per OAuth 2.0 specification. Requires a valid registered OAuth application client_id and client_secret. For authorization_code grant type: - Requires valid authorization code obtained from the OAuth authorization flow - Optionally requires code_verifier if PKCE was used during authorization For refresh_token grant type: - Requires valid refresh_token from a previous token exchange"
      },
      {
        "slug": "SUPABASE_GENERATE_TYPESCRIPT_TYPES",
        "name": "Generate TypeScript types",
        "description": "Generates and retrieves TypeScript types from a Supabase project's database; any schemas specified in `included_schemas` must exist in the project."
      },
      {
        "slug": "SUPABASE_GET_ACTION_RUN",
        "name": "Get action run status",
        "description": "Retrieves the status and details of a specific action run, including its steps, timestamps, and configuration. Use this to monitor or check the progress of an action execution."
      },
      {
        "slug": "SUPABASE_GET_ACTION_RUN_LOGS",
        "name": "Get action run logs",
        "description": "Retrieves the execution logs for a specific action run by its ID. Use this to debug action executions, view output messages, and investigate errors that occurred during action runs."
      },
      {
        "slug": "SUPABASE_GET_AUTH_CONFIG",
        "name": "Get project auth config",
        "description": "Retrieves the complete authentication configuration for a Supabase project. Use this action when you need to inspect auth settings, OAuth provider configurations, MFA policies, email/SMS templates, security policies, or webhook hooks. Returns all auth configuration fields including enabled providers (Apple, Google, GitHub, etc.), JWT settings, rate limits, password requirements, session policies, and mailer configuration. This is a read-only operation that does not modify any settings."
      },
      {
        "slug": "SUPABASE_GET_AVAILABLE_REGIONS",
        "name": "Get Available Regions",
        "description": "Tool to get the list of available regions for creating a new Supabase project. Use when you need to determine which regions are available for project deployment, or to get region recommendations based on geographic location and instance size requirements. Note: This is a Beta endpoint."
      },
      {
        "slug": "SUPABASE_GET_BRANCH",
        "name": "Get a database branch",
        "description": "Retrieves detailed information about a specific database branch by its name and project reference. Use this to check branch status, configuration, and metadata before performing operations on the branch."
      },
      {
        "slug": "SUPABASE_GET_DATABASE_BRANCH_CONFIG",
        "name": "Get database branch config",
        "description": "Retrieves the read-only configuration and status for a Supabase database branch, typically for monitoring or verifying its settings."
      },
      {
        "slug": "SUPABASE_GET_DATABASE_METADATA",
        "name": "Get Database Metadata",
        "description": "Gets database metadata for the given project. Returns information about databases, schemas, and tables structure. Note: This endpoint is deprecated and may be removed in future versions."
      },
      {
        "slug": "SUPABASE_GET_FUNCTION",
        "name": "Retrieve a function",
        "description": "Retrieves detailed information, metadata, configuration, and status for a specific Edge Function using its project reference ID and function slug."
      },
      {
        "slug": "SUPABASE_GET_FUNCTION_BODY",
        "name": "Retrieve a function body",
        "description": "Retrieves the source code (body) for a specified serverless Edge Function using its project reference and function slug; this is a read-only operation that does not execute the function or return runtime logs."
      },
      {
        "slug": "SUPABASE_GET_HEALTH",
        "name": "Get API Health Status",
        "description": "Tool to check the health status of the Supabase API. Use when you need to verify API availability or troubleshoot connectivity issues."
      },
      {
        "slug": "SUPABASE_GET_JIT_ACCESS_CONFIG",
        "name": "Get JIT access config",
        "description": "[Beta] Retrieves the project's just-in-time (JIT) access configuration, including user roles and their expiration settings. Use this to check temporary access grants and their validity periods."
      },
      {
        "slug": "SUPABASE_GET_LEGACY_SIGNING_KEY",
        "name": "Get legacy signing key",
        "description": "Retrieves the signing key information for the JWT secret imported as signing key for this project. This endpoint is deprecated and will be removed in the future; check for HTTP 404 Not Found which indicates the endpoint is no longer available."
      },
      {
        "slug": "SUPABASE_GET_MIGRATION",
        "name": "Get a migration",
        "description": "Retrieves a specific database migration entry from the migration history using its version identifier. Use when you need to inspect migration details, SQL statements, or rollback commands for a specific migration version."
      },
      {
        "slug": "SUPABASE_GET_ORGANIZATION",
        "name": "Get information about an organization",
        "description": "Fetches comprehensive details for a specific Supabase organization using its unique slug."
      },
      {
        "slug": "SUPABASE_GET_PERFORMANCE_ADVISORS",
        "name": "Get performance advisors",
        "description": "Retrieves project performance advisors for a Supabase project. Returns a list of performance lints that identify potential issues and optimization opportunities. Note: This endpoint is deprecated."
      },
      {
        "slug": "SUPABASE_GET_PROJECT",
        "name": "Get project",
        "description": "Retrieves detailed information about a specific Supabase project by its unique reference ID. Use when you need to get comprehensive project details including status, database configuration, and metadata. Authentication: - Requires a valid Bearer token in the Authorization header. - Token format: 'Bearer <access_token>' where access_token is either: - A Personal Access Token (PAT) generated from https://supabase.com/dashboard/account/tokens - An OAuth2 access token with the 'project_admin_read' scope Required Scope: - project_admin_read: Allows retrieval of project information. Returns: Project object containing id, ref, name, organization details, region, status, database configuration, and created_at timestamp."
      },
      {
        "slug": "SUPABASE_GET_PROJECT_API_KEY",
        "name": "Get project API key",
        "description": "Retrieves details of a specific API key for a Supabase project by its UUID. Use when you need to inspect a single key's configuration, type, or metadata."
      },
      {
        "slug": "SUPABASE_GET_PROJECT_API_KEYS",
        "name": "Get project API keys",
        "description": "Retrieves all API keys for an existing Supabase project, specified by its unique reference ID (`ref`); this is a read-only operation."
      },
      {
        "slug": "SUPABASE_GET_PROJECT_LEGACY_API_KEYS",
        "name": "Get project legacy API keys status",
        "description": "Checks whether JWT-based legacy API keys (anon, service_role) are enabled for a Supabase project. This API endpoint is deprecated and may be removed in the future (returns HTTP 404 Not Found when unavailable)."
      },
      {
        "slug": "SUPABASE_GET_PROJECT_LOGS",
        "name": "Get project logs",
        "description": "Retrieves analytics logs for a Supabase project. Use this to fetch and analyze project logs including edge function logs, database logs, and API logs for monitoring and debugging."
      },
      {
        "slug": "SUPABASE_GET_PROJECT_PGBOUNCER_CONFIG",
        "name": "Get project PgBouncer config",
        "description": "Retrieves the active PgBouncer configuration (PostgreSQL connection pooler) for a Supabase project, used for performance tuning, auditing, or getting the connection string."
      },
      {
        "slug": "SUPABASE_GET_PROJECT_POSTGRES_CONFIG",
        "name": "Get project postgres config",
        "description": "Retrieves the current read-only PostgreSQL database configuration for a specified Supabase project's `ref`, noting that some advanced or security-sensitive details might be omitted from the response."
      },
      {
        "slug": "SUPABASE_GET_PROJECT_POSTGREST_CONFIG",
        "name": "Get project's PostgREST config",
        "description": "Retrieves the PostgREST configuration for a specific Supabase project."
      },
      {
        "slug": "SUPABASE_GET_PROJECT_READONLY_MODE_STATUS",
        "name": "Get project's read-only mode status",
        "description": "Retrieves the read-only mode status for a specified Supabase project to check its operational state; this action does not change the read-only state."
      },
      {
        "slug": "SUPABASE_GET_PROJECT_SIGNING_KEYS",
        "name": "Get project signing keys",
        "description": "Tool to list all signing keys for a Supabase project. Use when you need to retrieve JWT signing keys for authentication verification or rotation management."
      },
      {
        "slug": "SUPABASE_GET_PROJECT_SUPAVISOR_CONFIG",
        "name": "Get project Supavisor configuration",
        "description": "Retrieves the Supavisor (connection pooler) configuration for a specified Supabase project, identified by its reference ID."
      },
      {
        "slug": "SUPABASE_GET_PROJECT_UPGRADE_ELIGIBILITY",
        "name": "Get Project Upgrade Eligibility",
        "description": "Checks a Supabase project's eligibility for an upgrade, verifying compatibility and identifying potential issues; this action does not perform the actual upgrade."
      },
      {
        "slug": "SUPABASE_GET_PROJECT_UPGRADE_STATUS",
        "name": "Get project upgrade status",
        "description": "Retrieves the latest status of a Supabase project's database upgrade for monitoring purposes; does not initiate or modify upgrades."
      },
      {
        "slug": "SUPABASE_GET_RESUMABLE_UPLOAD_BASE_OPTIONS",
        "name": "Get TUS resumable upload base options",
        "description": "Handles OPTIONS request for TUS Resumable uploads to discover server capabilities. Use when preparing resumable upload requests to verify supported TUS protocol versions and extensions."
      },
      {
        "slug": "SUPABASE_GET_RESUMABLE_UPLOAD_OPTIONS",
        "name": "Get TUS resumable upload options",
        "description": "Handles OPTIONS request for TUS Resumable uploads to discover server capabilities. Use when preparing resumable upload requests to verify supported TUS protocol versions and extensions."
      },
      {
        "slug": "SUPABASE_GET_SECURITY_ADVISORS",
        "name": "Get Security Advisors",
        "description": "Retrieves security advisor findings and recommendations for a Supabase project. Use when you need to audit project security posture, identify SQL-based security issues, or get remediation guidance. Note: This endpoint is deprecated and may be removed in future API versions."
      },
      {
        "slug": "SUPABASE_GETS_PROJECT_S_AUTH_CONFIG",
        "name": "Get project's auth config",
        "description": "Retrieves the project's complete read-only authentication configuration, detailing all settings (e.g., providers, MFA, email/SMS, JWT, security policies) but excluding sensitive secrets."
      },
      {
        "slug": "SUPABASE_GETS_PROJECT_S_SERVICE_HEALTH_STATUS",
        "name": "Get project's service health status",
        "description": "Retrieves the current health status for a Supabase project, for specified services or all services if the 'services' list is omitted."
      },
      {
        "slug": "SUPABASE_GET_SQL_SNIPPET",
        "name": "Get a specific SQL snippet",
        "description": "Retrieves a specific SQL snippet by its unique identifier."
      },
      {
        "slug": "SUPABASE_GET_SSO_PROVIDER",
        "name": "Get a SSO provider by its UUID",
        "description": "Retrieves the configuration details for a specific Single Sign-On (SSO) provider (e.g., SAML, Google, GitHub, Azure AD), identified by its UUID, within a Supabase project."
      },
      {
        "slug": "SUPABASE_GET_TABLE_SCHEMAS",
        "name": "Get Table Schemas",
        "description": "Retrieves column details, types, and constraints for multiple database tables to help debug schema issues and write accurate SQL queries. Use the SUPABASE_LIST_TABLES action first to discover available tables, the fetch their detailed schemas."
      },
      {
        "slug": "SUPABASE_HANDLE_RESUMABLE_UPLOAD_SIGN_OPTIONS",
        "name": "OPTIONS for resumable upload sign",
        "description": "Handles CORS preflight OPTIONS request for TUS resumable upload signing. Use when preparing cross-origin resumable upload requests to verify allowed methods and headers."
      },
      {
        "slug": "SUPABASE_HANDLE_RESUMABLE_UPLOAD_SIGN_OPTIONS_WITH_ID",
        "name": "OPTIONS for resumable upload sign",
        "description": "Handles CORS preflight OPTIONS request for TUS resumable upload signing endpoints. Use when preparing cross-origin resumable upload requests to verify allowed methods and headers."
      },
      {
        "slug": "SUPABASE_INVOKE_EDGE_FUNCTION",
        "name": "Invoke Edge Function",
        "description": "Tool to invoke a deployed Supabase Edge Function over HTTPS. Use for testing and debugging Edge Functions with configurable method, headers, body, and authentication."
      },
      {
        "slug": "SUPABASE_LIST_ALL_ORGANIZATIONS",
        "name": "List all organizations",
        "description": "Lists all organizations (ID and name only) associated with the Supabase account, excluding project details within these organizations."
      },
      {
        "slug": "SUPABASE_LIST_ALL_PROJECTS",
        "name": "List all projects",
        "description": "Retrieves a list of all Supabase projects, including their ID, name, region, and status, for the authenticated user. Authentication: - Requires a valid Bearer token in the Authorization header. - Token format: 'Bearer <access_token>' where access_token is either: - A Personal Access Token (PAT) generated from https://supabase.com/dashboard/account/tokens - An OAuth2 access token with the 'Projects.Read' scope Required Scope: - Projects.Read: Allows retrieval of project metadata. Returns: List of Project objects containing id, name, organization_id, region, status, database info, and created_at."
      },
      {
        "slug": "SUPABASE_LIST_BACKUPS",
        "name": "List project database backups",
        "description": "Lists all database backups for a Supabase project, providing details on existing backups but not creating new ones or performing restores; availability may depend on plan and configuration."
      },
      {
        "slug": "SUPABASE_LIST_BRANCHES",
        "name": "List database branches",
        "description": "Lists all database branches for a specified Supabase project, providing information about each branch's status, configuration, and metadata. Use this action when you need to view all branches in a project, check branch statuses, or identify available branches before performing operations. Database branches are useful for isolated development and testing of schema changes."
      },
      {
        "slug": "SUPABASE_LIST_BUCKETS",
        "name": "List all buckets",
        "description": "Retrieves a list of all storage buckets for a Supabase project, without returning bucket contents or access policies."
      },
      {
        "slug": "SUPABASE_LIST_DATABASE_BRANCHES",
        "name": "List all database branches",
        "description": "Lists all database branches for a specified Supabase project, used for isolated development and testing of schema changes; ensure the project reference ID is valid."
      },
      {
        "slug": "SUPABASE_LIST_FUNCTIONS",
        "name": "List all functions",
        "description": "Lists metadata for all Edge Functions in a Supabase project (specified by 'ref'), excluding function code or logs; the project must exist."
      },
      {
        "slug": "SUPABASE_LIST_MIGRATION_HISTORY",
        "name": "List migration history",
        "description": "Retrieves the list of applied database migration versions for a Supabase project. Use this to track which migrations have been applied to the project's database. This is a read-only operation that requires the project reference ID."
      },
      {
        "slug": "SUPABASE_LIST_ORGANIZATION_MEMBERS",
        "name": "List members of an organization",
        "description": "Retrieves all members of a Supabase organization, identified by its unique slug, including their user ID, username, email, role, and MFA status."
      },
      {
        "slug": "SUPABASE_LIST_PROJECT_SECRETS",
        "name": "List project secrets",
        "description": "Retrieves all secrets (environment variables) for a Supabase project by its reference ID. Use this action when you need to view the secrets configured for a project, such as API keys, database URLs, or other environment variables. Note that secret values in the response may be masked for security reasons."
      },
      {
        "slug": "SUPABASE_LIST_SECRETS",
        "name": "List all secrets",
        "description": "Retrieves all secrets for a Supabase project using its reference ID; secret values in the response may be masked."
      },
      {
        "slug": "SUPABASE_LIST_SQL_SNIPPETS",
        "name": "List SQL snippets for the logged in user",
        "description": "Retrieves a list of SQL snippets for the logged-in user, optionally filtered by a specific Supabase project if `project_ref` is provided."
      },
      {
        "slug": "SUPABASE_LIST_SSO_PROVIDERS",
        "name": "List all SSO providers",
        "description": "Lists all configured Single Sign-On (SSO) providers for a Supabase project, requiring the project reference ID (`ref`) of an existing project."
      },
      {
        "slug": "SUPABASE_LIST_TABLES",
        "name": "List Database Tables",
        "description": "Lists all tables and views in specified database schemas, providing a quick overview of database structure to help identify available tables before fetching detailed schemas."
      },
      {
        "slug": "SUPABASE_MERGE_BRANCH",
        "name": "Merge a database branch",
        "description": "Merges a database branch, applying all schema changes and migrations from the branch to the target database. Use this action when you need to promote changes from a database branch to production or another target environment after testing and validation are complete. This operation is irreversible - once merged, the changes cannot be automatically rolled back."
      },
      {
        "slug": "SUPABASE_PATCH_MIGRATION",
        "name": "Patch a migration",
        "description": "[Beta] Patches an existing entry in the project's migration history, updating the name or rollback script. Use this to correct migration metadata after the migration has been created."
      },
      {
        "slug": "SUPABASE_PATCH_NETWORK_RESTRICTIONS",
        "name": "Patch project network restrictions",
        "description": "Updates project's network restrictions by incrementally adding or removing IPv4/IPv6 CIDR blocks. Use when you need to modify existing restrictions without replacing the entire configuration."
      },
      {
        "slug": "SUPABASE_PUSH_BRANCH",
        "name": "Push a database branch",
        "description": "Pushes a database branch, applying migrations and changes to the specified branch. Use when you need to deploy schema changes or migrations to a database branch."
      },
      {
        "slug": "SUPABASE_RESET_DATABASE_BRANCH",
        "name": "Reset a database branch",
        "description": "Resets an existing Supabase database branch, identified by `branch_id`, to its initial clean state, irreversibly deleting all its current data and schema changes."
      },
      {
        "slug": "SUPABASE_RESTORE_PITR_BACKUP",
        "name": "Restore database PITR backup",
        "description": "Restores a Supabase project's database to a specific Unix timestamp using Point-in-Time Recovery (PITR), overwriting the current state; requires a paid plan with PITR and physical backups enabled."
      },
      {
        "slug": "SUPABASE_RUN_READ_ONLY_QUERY",
        "name": "Execute read-only database query",
        "description": "[Beta] Run a SQL query as supabase_read_only_user. Use when you need to safely execute SELECT queries without risk of modifying data. Only read operations are allowed."
      },
      {
        "slug": "SUPABASE_SELECT_FROM_TABLE",
        "name": "Select From Table",
        "description": "Tool to select rows from a Supabase/PostgREST table. Use for read-only queries with filtering, sorting, and pagination."
      },
      {
        "slug": "SUPABASE_UPDATE_A_FUNCTION",
        "name": "Update a function",
        "description": "Updates an existing Supabase Edge Function's properties (like name, slug, source code, JWT settings, import map) identified by project `ref` and `function_slug`, supporting plain text code or ESZIP for the body. Use RETRIEVE_A_FUNCTION_BODY action first to get the current source code, as this action requires sending the complete function code, not just the changes."
      },
      {
        "slug": "SUPABASE_UPDATE_API_KEY",
        "name": "Update API key",
        "description": "Updates an existing Supabase project API key's metadata including name, description, and JWT template configuration. This action modifies key properties without regenerating the actual key value. Use this action when you need to change a key's display name, update its description for better organization, or modify the JWT role template for secret-type keys. Note: This does not rotate or regenerate the key string itself - the key value remains unchanged unless explicitly revealed with reveal=true."
      },
      {
        "slug": "SUPABASE_UPDATE_BRANCH",
        "name": "Update branch configuration",
        "description": "Updates the configuration of a Supabase database branch, allowing modification of its name, associated Git branch, notification URL, persistence settings, and status. Use this action when you need to modify branch settings after creation, such as linking to a different Git branch, changing the branch name, or updating persistence behavior. Note: Database branching requires a paid Supabase plan (Pro or higher)."
      },
      {
        "slug": "SUPABASE_UPDATE_DATABASE_BRANCH_CONFIG",
        "name": "Update database branch config",
        "description": "Updates the configuration of a Supabase database branch, allowing modification of its name, associated Git branch, reset-on-push behavior, persistence, and status. Note: Database branching requires a paid Supabase plan (Pro or higher). This action requires a valid branch_id which must be exactly 20 lowercase alphabetic characters. Authentication: - Requires a valid Bearer token in the Authorization header. - Token format: 'Bearer <access_token>' Required Scope: - Environment:Write"
      },
      {
        "slug": "SUPABASE_UPDATE_DATABASE_PASSWORD",
        "name": "Update database password",
        "description": "Updates the database password for a Supabase project. Use when needing to rotate credentials or recover database access."
      },
      {
        "slug": "SUPABASE_UPDATE_FUNCTIONS",
        "name": "Bulk update functions",
        "description": "Tool to bulk update Edge Functions in a Supabase project. Use when you need to update multiple functions at once with new configurations such as status, version, or other properties."
      },
      {
        "slug": "SUPABASE_UPDATE_JIT_ACCESS_CONFIG",
        "name": "Update JIT access config",
        "description": "[Beta] Update a Supabase project's just-in-time (JIT) access configuration. Use to enable or disable JIT access features for privileged operations on the project."
      },
      {
        "slug": "SUPABASE_UPDATE_PGSODIUM_CONFIG",
        "name": "Update pgsodium root key",
        "description": "Critically updates or initializes a Supabase project's pgsodium root encryption key for security setup or key rotation, requiring secure backup of the new key to prevent irreversible data loss."
      },
      {
        "slug": "SUPABASE_UPDATE_PROJECT",
        "name": "Update a project",
        "description": "Updates a Supabase project's configuration (currently supports updating the project name). Use when you need to rename an existing project."
      },
      {
        "slug": "SUPABASE_UPDATE_PROJECT_AUTH_CONFIG",
        "name": "Update project's auth config",
        "description": "Update Supabase project Auth configuration via the Management API. Use to fix misconfigured Auth redirects, SMTP settings, or other auth parameters. Only provided fields are updated; others remain unchanged. Before updating, confirm the Auth service status is ACTIVE_HEALTHY by checking project health."
      },
      {
        "slug": "SUPABASE_UPDATE_PROJECT_CUSTOM_HOSTNAME",
        "name": "Update project's custom hostname configuration",
        "description": "Updates the custom hostname for a Supabase project, requiring subsequent DNS changes to a user-controlled domain for SSL certificate issuance and domain ownership."
      },
      {
        "slug": "SUPABASE_UPDATE_PROJECT_LEGACY_API_KEYS",
        "name": "Update project legacy API keys",
        "description": "Tool to disable or re-enable JWT-based legacy API keys (anon, service_role) for a Supabase project. Use when you need to toggle legacy API key access for security or migration purposes. Note: This API endpoint may be removed in the future - check for HTTP 404 Not Found if the endpoint is no longer available."
      },
      {
        "slug": "SUPABASE_UPDATE_PROJECT_POSTGRES_CONFIG",
        "name": "Update project's postgres config",
        "description": "Updates specified PostgreSQL configuration parameters for an existing Supabase project (`ref`) to optimize database performance; note that unspecified parameters remain unchanged, and caution is advised as incorrect settings can impact stability or require a restart."
      },
      {
        "slug": "SUPABASE_UPDATE_PROJECT_POSTGREST_CONFIG",
        "name": "Update project's PostgREST config",
        "description": "Updates PostgREST configuration settings (e.g., `max_rows`, `db_pool`, `db_schema`, `db_extra_search_path`) for a Supabase project to fine-tune API performance, data exposure, and database resource usage."
      },
      {
        "slug": "SUPABASE_UPDATE_PROJECT_SUPAVISOR_CONFIG",
        "name": "Update database pooler config",
        "description": "Updates the Supavisor (database pooler) configuration, such as `default_pool_size`, for an existing Supabase project identified by `ref`; the `pool_mode` parameter in the request is deprecated and ignored."
      },
      {
        "slug": "SUPABASE_UPDATE_SSL_ENFORCEMENT_CONFIG",
        "name": "Update SSL enforcement config",
        "description": "Updates the SSL enforcement configuration (enable/disable) for a specified Supabase project's database."
      },
      {
        "slug": "SUPABASE_UPDATE_SSO_PROVIDER",
        "name": "Update an SSO provider by its UUID",
        "description": "Updates an existing SSO provider's SAML metadata, associated email domains, or attribute mappings for a Supabase project, identified by `ref` and `provider_id`."
      },
      {
        "slug": "SUPABASE_UPSERT_MIGRATION",
        "name": "Upsert migration",
        "description": "Tool to upsert a database migration without applying it. Use when you need to track migration changes for a project. [Beta] This endpoint stores migration metadata without executing the SQL."
      },
      {
        "slug": "SUPABASE_VERIFY_CUSTOM_HOSTNAME_DNS",
        "name": "Reverify custom hostname",
        "description": "Re-verifies DNS and SSL configurations for an existing custom hostname associated with a Supabase project."
      }
    ],
    "triggers": [],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "supabase_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "all"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "full",
                "displayName": "Base URL",
                "type": "string",
                "description": "The web address for the Supabase Management API. Most accounts can keep the default https://api.supabase.com — change it only if you self-host Supabase.",
                "required": true,
                "default": "https://api.supabase.com"
              }
            ],
            "optional": []
          }
        }
      },
      {
        "mode": "API_KEY",
        "name": "supabase_api_key",
        "fields": {
          "auth_config_creation": {
            "required": [],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "full",
                "displayName": "Base URL",
                "type": "string",
                "description": "The web address for the Supabase Management API. Most accounts can keep the default https://api.supabase.com — change it only if you self-host Supabase.",
                "required": true,
                "default": "https://api.supabase.com"
              },
              {
                "name": "bearer_token",
                "displayName": "Supabase Personal Token",
                "type": "string",
                "description": "A personal access token starting with 'sbp_'. Create one at https://supabase.com/dashboard/account/tokens — it's shown only once, so copy it right away.",
                "required": true,
                "default": null
              }
            ],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "outlook",
    "name": "Outlook",
    "logo": "https://logos.composio.dev/api/outlook",
    "description": "Outlook is Microsoft's email and calendaring platform integrating contacts and scheduling, enabling users to manage communications and events in a unified workspace",
    "category": "email",
    "authSchemes": [
      "OAUTH2",
      "S2S_OAUTH2"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 305,
    "triggerCount": 5,
    "version": "20260903_00",
    "tools": [
      {
        "slug": "OUTLOOK_ACCEPT_EVENT",
        "name": "Accept calendar event invite",
        "description": "Accepts or tentatively accepts a calendar meeting invite on behalf of a user. Use this action when a user has received a meeting invitation and wants to indicate their attendance status (either confirmed or tentative). The organizer will receive a notification of the acceptance unless send_response is set to false."
      },
      {
        "slug": "OUTLOOK_ADD_EVENT_ATTACHMENT",
        "name": "Add event attachment",
        "description": "Adds an attachment to a specific Outlook calendar event. Use when you need to attach a file or nested item to an existing event."
      },
      {
        "slug": "OUTLOOK_ADD_MAIL_ATTACHMENT",
        "name": "Add mail attachment",
        "description": "Tool to add an attachment to an email message. Use when you have a message ID and need to attach a small (<3 MB) file or reference."
      },
      {
        "slug": "OUTLOOK_BATCH_MOVE_MESSAGES",
        "name": "Batch move messages",
        "description": "Batch-move up to 20 Outlook messages to a destination folder in a single Microsoft Graph $batch call. Use when moving multiple messages to avoid per-message move API calls."
      },
      {
        "slug": "OUTLOOK_BATCH_UPDATE_MESSAGES",
        "name": "Batch update messages",
        "description": "Batch-update up to 20 Outlook messages per call using Microsoft Graph JSON batching. Use when marking multiple messages read/unread or updating other properties to avoid per-message PATCH calls."
      },
      {
        "slug": "OUTLOOK_CALENDAR_CREATE_EVENT",
        "name": "Create Calendar Event",
        "description": "Creates a new Outlook calendar event, ensuring `start_datetime` is chronologically before `end_datetime`."
      },
      {
        "slug": "OUTLOOK_CANCEL_CALENDAR_EVENT",
        "name": "Cancel user's calendar event",
        "description": "Tool to cancel an event in a specific calendar for a specified user and send cancellation notifications to all attendees. Use when you need to cancel a meeting or event in a specific calendar on behalf of a user."
      },
      {
        "slug": "OUTLOOK_CANCEL_CALENDAR_GROUP_CALENDAR_EVENT",
        "name": "Cancel user calendar group event",
        "description": "Tool to cancel an event in a user's calendar within a calendar group and send cancellation notifications to all attendees. Use when canceling a meeting or event for a specific user in a calendar that belongs to a calendar group."
      },
      {
        "slug": "OUTLOOK_CANCEL_EVENT",
        "name": "Cancel user calendar event",
        "description": "Tool to cancel a calendar event for a specified user and send cancellation notifications to all attendees. Use when you need to cancel a meeting or event on behalf of a specific user."
      },
      {
        "slug": "OUTLOOK_COPY_MAIL_FOLDER",
        "name": "Copy user's mail folder",
        "description": "Tool to copy a user's mail folder and its contents to another folder. Use when you need to duplicate a folder structure for a specific user's mailbox."
      },
      {
        "slug": "OUTLOOK_COPY_ME_MAIL_FOLDER",
        "name": "Copy child mail folder",
        "description": "Tool to copy a child mail folder to a destination folder. Use when you need to duplicate a folder structure."
      },
      {
        "slug": "OUTLOOK_COPY_MESSAGE",
        "name": "Copy message to folder",
        "description": "Tool to copy an email message to another folder within the user's mailbox. Use when duplicating messages to multiple folders for organization."
      },
      {
        "slug": "OUTLOOK_COPY_MESSAGE_FROM_CHILD_FOLDER",
        "name": "Copy message from child folder",
        "description": "Tool to copy an email message from a child folder (nested folder) to another folder within the user's mailbox. Use when duplicating messages from nested folder structures."
      },
      {
        "slug": "OUTLOOK_COPY_MESSAGE_FROM_MAIL_FOLDER",
        "name": "Copy user message from folder",
        "description": "Tool to copy a message from a specific user's mail folder to another folder. Use when you need to duplicate a message from a known source folder to a destination folder for a specific user."
      },
      {
        "slug": "OUTLOOK_CREATE_ATTACHMENT_UPLOAD_SESSION",
        "name": "Create attachment upload session",
        "description": "Tool to create an upload session for large (>3 MB) message attachments. Use when you need to upload attachments in chunks."
      },
      {
        "slug": "OUTLOOK_CREATE_ATTACHMENT_UPLOAD_SESSION_IN_CHILD_FOLDER",
        "name": "Create attachment upload session in child folder",
        "description": "Tool to create an upload session for large (>3 MB) message attachments in child mail folders. Use when you need to upload attachments to messages in nested folder structures."
      },
      {
        "slug": "OUTLOOK_CREATE_CALENDAR",
        "name": "Create calendar",
        "description": "Tool to create a new calendar in the signed-in user's mailbox. Use when organizing events into a separate calendar."
      },
      {
        "slug": "OUTLOOK_CREATE_CALENDAR_EVENT",
        "name": "Create Event in Calendar (Deprecated)",
        "description": "DEPRECATED: Use OUTLOOK_CREATE_USER_CALENDAR_CALENDAR_EVENT instead. Tool to create a new event in a specific Outlook calendar. Use when you need to add an event to a particular calendar by its ID."
      },
      {
        "slug": "OUTLOOK_CREATE_CALENDAR_EVENT_ATTACHMENT",
        "name": "Create calendar event attachment",
        "description": "Tool to create a new attachment for an event in a specific calendar. Use when you need to attach a file or item to an event within a particular calendar."
      },
      {
        "slug": "OUTLOOK_CREATE_CALENDAR_EVENT_ATTACHMENT_UPLOAD_SESSION",
        "name": "Create calendar event attachment upload session",
        "description": "Tool to create an upload session for large calendar event attachments in a specific calendar. Use when attaching files larger than 3 MB to Outlook calendar events in a specific calendar."
      },
      {
        "slug": "OUTLOOK_CREATE_CALENDAR_EVENT_IN_CALENDAR",
        "name": "Create event in specific calendar",
        "description": "Tool to create a new event in a specific calendar for a user. Use when you need to create events in a specific calendar (e.g., shared or secondary calendars)."
      },
      {
        "slug": "OUTLOOK_CREATE_CALENDAR_GROUP",
        "name": "Create calendar group",
        "description": "Tool to create a new calendar group for a user. Use when needing to organize calendars into groups."
      },
      {
        "slug": "OUTLOOK_CREATE_CALENDAR_GROUP_CALENDAR_EVENT_ATTACHMENT",
        "name": "Create user calendar group event attachment",
        "description": "Tool to create a new attachment for an event in a calendar within a calendar group for a specific user. Use when you need to attach a file or item to an event in a user's calendar group."
      },
      {
        "slug": "OUTLOOK_CREATE_CALENDAR_GROUP_CALENDAR_EVENT_EXTENSION",
        "name": "Create event extension",
        "description": "Tool to create a new open extension on a calendar event within a specific calendar group and calendar. Use when you need to store custom data with an event."
      },
      {
        "slug": "OUTLOOK_CREATE_CALENDAR_PERMISSION",
        "name": "Create Calendar Permission",
        "description": "Tool to create a calendar permission for a specific calendar in a calendar group. Use when granting access to a calendar for another user."
      },
      {
        "slug": "OUTLOOK_CREATE_CAL_GROUP_EVENT_ATTACH_UPLOAD",
        "name": "Create calendar group event attachment upload session",
        "description": "Tool to create an upload session for large calendar group event attachments. Use when attaching files larger than 3 MB to events in calendar groups."
      },
      {
        "slug": "OUTLOOK_CREATE_CONTACT",
        "name": "Create contact",
        "description": "Creates a new contact in a Microsoft Outlook user's contacts folder."
      },
      {
        "slug": "OUTLOOK_CREATE_CONTACT_FOLDER",
        "name": "Create contact folder",
        "description": "Tool to create a new contact folder in the user's mailbox. Use when needing to organize contacts into custom folders."
      },
      {
        "slug": "OUTLOOK_CREATE_CONTACT_FOLDER_CHILD_FOLDER",
        "name": "Create user contact folder child folder",
        "description": "Tool to create a child contact folder within a parent contact folder for a specific user. Use when you need to organize contacts into nested folder hierarchies for a given user."
      },
      {
        "slug": "OUTLOOK_CREATE_DRAFT",
        "name": "Create email draft",
        "description": "Creates a new Outlook email draft with subject, body, recipients, and an optional attachment. This action creates a standalone draft for new conversations. To create a draft reply to an existing conversation/message, use the OUTLOOK_CREATE_DRAFT_REPLY action instead."
      },
      {
        "slug": "OUTLOOK_CREATE_DRAFT_REPLY",
        "name": "Create a draft reply",
        "description": "Creates a draft reply in the specified user's Outlook mailbox to an existing message (identified by a valid `message_id`), optionally including a `comment` and CC/BCC recipients."
      },
      {
        "slug": "OUTLOOK_CREATE_EMAIL_RULE",
        "name": "Create Email Rule",
        "description": "Create email rule filter with conditions and actions"
      },
      {
        "slug": "OUTLOOK_CREATE_EVENT_ATTACHMENT",
        "name": "Create user calendar event attachment",
        "description": "Tool to create a new attachment for a user's calendar event. Use when you need to attach a file or item to an existing event in a specific user's calendar."
      },
      {
        "slug": "OUTLOOK_CREATE_EVENT_ATTACHMENT_UPLOAD_SESSION",
        "name": "Create event attachment upload session",
        "description": "Tool to create an upload session for large calendar event attachments. Use when attaching files larger than 3 MB to Outlook calendar events."
      },
      {
        "slug": "OUTLOOK_CREATE_FORWARD_DRAFT",
        "name": "Create user mail folder message forward draft",
        "description": "Tool to create a forward draft of an Outlook message for a specific user. Use when you need to prepare a forward email that can be edited before sending. The draft is created in the Drafts folder with the FW: prefix in the subject line."
      },
      {
        "slug": "OUTLOOK_CREATE_MAIL_FOLDER",
        "name": "Create mail folder",
        "description": "Tool to create a new mail folder. Use when you need to organize email into a new folder."
      },
      {
        "slug": "OUTLOOK_CREATE_MAIL_FOLDER_MESSAGE",
        "name": "Create message in mail folder",
        "description": "Tool to create a new message in a specific mail folder. Use when you need to create a draft message in a particular folder (e.g., drafts, custom folders)."
      },
      {
        "slug": "OUTLOOK_CREATE_MAIL_FOLDER_MESSAGE_ATTACHMENT",
        "name": "Create mail folder message attachment",
        "description": "Tool to add an attachment to a message in a specific mail folder. Use when you need to attach a file to a message located in a particular mail folder."
      },
      {
        "slug": "OUTLOOK_CREATE_MAIL_FOLDER_MESSAGE_ATTACHMENT_UPLOAD_SESSION",
        "name": "Create mail folder message attachment upload session",
        "description": "Tool to create an upload session for large (>3 MB) message attachments in a specific mail folder. Use when you need to upload attachments in chunks to a message located in a mail folder."
      },
      {
        "slug": "OUTLOOK_CREATE_MAIL_FOLDER_MESSAGE_RULE",
        "name": "Create User Mail Folder Message Rule",
        "description": "Tool to create a message rule in a user's mail folder. Use when automating message processing with filters and actions."
      },
      {
        "slug": "OUTLOOK_CREATE_MASTER_CATEGORY",
        "name": "Create master category (Deprecated)",
        "description": "DEPRECATED: Use OUTLOOK_CREATE_USER_MASTER_CATEGORY instead. Tool to create a new category in the user's master category list. Use after selecting a unique display name."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_CALENDAR_EVENT_EXTENSION",
        "name": "Create user calendar event extension",
        "description": "Tool to create a new open extension on a calendar event for a specific user. Use when you need to store custom data with an event."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_CALENDAR_PERMISSION",
        "name": "Create user calendar permission",
        "description": "Tool to create a new calendar permission for a specific user's calendar. Use when you need to share another user's calendar with someone or grant access with specific permission levels."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_CHILD_FOLDER_MESSAGE",
        "name": "Create message in user's child folder",
        "description": "Tool to create a new draft message in a child folder within a user's mail folder. Use when creating messages in nested folder structures for a specific user's mailbox."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_CONTACT_FOLDERS_CONTACTS",
        "name": "Create user contact in folder",
        "description": "Tool to create a new contact in a specific user's contact folder. Use when you need to add a contact to a particular folder for a specified user."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_CONTACT_FOLDERS_CONTACTS_EXTENSIONS",
        "name": "Create user contact extension",
        "description": "Tool to create a new open extension on a contact within a user's contact folder. Use when you need to store custom data with a contact."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_CONTACT_FOLDERS_EXTENSIONS",
        "name": "Create contact extension",
        "description": "Tool to create a new open extension on a contact within a child folder. Use when you need to store custom data with a contact."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_CONTACT_IN_CHILD_FOLDER",
        "name": "Create contact in child folder",
        "description": "Tool to create a new contact in a child folder within a contact folder. Use when you need to add a contact to a specific nested folder structure."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_EVENT",
        "name": "Create calendar event for user",
        "description": "Tool to create a new calendar event for a specific user. Use when you need to create events in a user's calendar."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_EVENT_ATTACHMENT_UPLOAD_SESSION",
        "name": "Create me event attachment upload session",
        "description": "Tool to create an upload session for large event attachments. Use when attaching files larger than 3 MB to the authenticated user's Outlook events."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_FORWARD_DRAFT",
        "name": "Create forward draft",
        "description": "Tool to create a draft forward of an existing message. Use when you need to prepare a forward that can be edited before sending. The draft can be updated with recipients and additional content before being sent."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_INFERENCE_CLASSIFICATION_OVERRIDE",
        "name": "Create user Focused Inbox override",
        "description": "Tool to create a Focused Inbox override for a sender identified by SMTP address for a specific user. Use when you need to configure messages from a specific sender to always be classified as focused or other for a particular user."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_MAIL_FOLDER_MESSAGE_REPLY_ALL_DRAFT",
        "name": "Create reply-all draft for mail folder message",
        "description": "Deprecated: Use OUTLOOK_CREATE_REPLY_ALL_DRAFT instead, which supports both /me and /users/{user_id} endpoints with timezone support."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_MESSAGE_REPLY_ALL_DRAFT",
        "name": "Create reply-all draft for user message",
        "description": "Tool to create a draft reply-all to a user's message. Use when you need to create a draft reply to the sender and all recipients of an email message in a user's mailbox."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_REPLY_ALL_DRAFT",
        "name": "Create reply-all draft for child folder message",
        "description": "Tool to create a draft reply-all to a message in a child folder. Use when you need to create a draft reply to the sender and all recipients of a message located in a subfolder within a mail folder."
      },
      {
        "slug": "OUTLOOK_CREATE_ME_REPLY_DRAFT",
        "name": "Create reply draft",
        "description": "Deprecated: Use OUTLOOK_CREATE_DRAFT_REPLY instead, which adds comment, cc_emails, and bcc_emails support."
      },
      {
        "slug": "OUTLOOK_CREATE_MESSAGE_ATTACHMENT",
        "name": "Create message attachment",
        "description": "Tool to create an attachment for a message. Use when you need to attach a file or item to an existing message. Supports file attachments, item attachments, and reference attachments."
      },
      {
        "slug": "OUTLOOK_CREATE_REPLY_ALL_DRAFT",
        "name": "Create reply-all draft in folder",
        "description": "Tool to create a reply-all draft for a message in a mail folder. Use when you need to create a draft reply to all recipients of an email."
      },
      {
        "slug": "OUTLOOK_CREATE_TASK",
        "name": "Create To Do task",
        "description": "Tool to create a new task in Microsoft To Do within a specified task list. Use when adding tasks with title, due dates, reminders, importance levels, descriptions, categories, and linked resources."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_CALENDAR_EVENT_ATTACHMENT",
        "name": "Create user calendar event attachment",
        "description": "Tool to create a new attachment for an event in a specific user's calendar. Use when you need to attach a file or item to an event within a particular user's calendar."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_CALENDAR_GROUP_CALENDAR",
        "name": "Create calendar in user's calendar group",
        "description": "Tool to create a new calendar in a calendar group for a specific user. Use when organizing events into a separate calendar within a specific calendar group for a user."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_CALENDAR_GROUP_EVENT",
        "name": "Create user calendar group event",
        "description": "Tool to create a new calendar event in a specific user's calendar within a calendar group. Use when creating events for a particular user in a calendar that belongs to a calendar group."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_CONTACTS_EXTENSIONS",
        "name": "Create user contact extension",
        "description": "Tool to create a new open extension on a specific user's contact. Use when you need to store custom data with a contact for a specific user."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_EVENT_ATTACHMENT_UPLOAD_SESSION",
        "name": "Create user event attachment upload session",
        "description": "Deprecated: Use OUTLOOK_CREATE_ME_EVENT_ATTACHMENT_UPLOAD_SESSION instead, which supports both /me and /users/{user_id} endpoints."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_EVENT_CALENDAR_PERMISSION",
        "name": "Create calendar permission via event",
        "description": "Tool to create a calendar permission via an event's calendar. Use when granting calendar access through an event by specifying the event ID and user email address."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_MAIL_CHILD_FOLDER_MSG_EXT",
        "name": "Create user message extension",
        "description": "Tool to create a new open extension on a message in a child mail folder for any user. Use when you need to store custom data with a message in a nested folder structure."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_MAIL_FOLDER_MESSAGE_EXTENSION",
        "name": "Create user mail folder message extension",
        "description": "Tool to create a new open extension on a message in a user's mail folder. Use when you need to store custom data with a specific message in a user's mailbox."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_MAIL_FOLDER_MESSAGE_REPLY_DRAFT",
        "name": "Create reply draft for user mail folder message",
        "description": "Tool to create a reply draft for a message in a user's mail folder. Use when you need to prepare a reply without sending it immediately. The draft is created in the Drafts folder and includes the RE: prefix in the subject line."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_MAIL_FOLDERS_CHILD_FOLDERS",
        "name": "Create user mail folders child folders",
        "description": "Tool to create a new child folder under a specified mail folder for a user. Use when organizing email into nested folder hierarchies within a specific user's mailbox."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_MASTER_CATEGORY",
        "name": "Create user master category",
        "description": "Tool to create a new category in a user's master category list. Use when you need to add a category to organize email and calendar items for a specific user."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_MESSAGE",
        "name": "Create user message",
        "description": "Tool to create a new draft message in a user's mailbox. Use when creating draft messages for a specific user or the authenticated user."
      },
      {
        "slug": "OUTLOOK_CREATE_USER_MESSAGE_ATTACHMENT",
        "name": "Create user message attachment",
        "description": "Tool to create an attachment on a message in a user's mail folder. Use when you need to attach a file or item to an existing message in a specific user's mailbox."
      },
      {
        "slug": "OUTLOOK_DECLINE_EVENT",
        "name": "Decline calendar event",
        "description": "Tool to decline an invitation to a calendar event. Use when the user wants to decline a meeting or event invitation. The API returns 202 Accepted with no content on success."
      },
      {
        "slug": "OUTLOOK_DELETE_CALENDAR",
        "name": "Delete calendar",
        "description": "Tool to delete a calendar other than the default calendar from a user's mailbox. Use when removing calendars that are no longer needed."
      },
      {
        "slug": "OUTLOOK_DELETE_CALENDAR_EVENT",
        "name": "Delete calendar event",
        "description": "Tool to delete a calendar event from a user's Outlook calendar. Use when removing events that are no longer needed or were created in error."
      },
      {
        "slug": "OUTLOOK_DELETE_CALENDAR_EVENT_ATTACHMENT",
        "name": "Delete user calendar event attachment",
        "description": "Tool to delete an attachment from an event in a specific user's calendar. Use when you need to remove a file or item attachment from an event in a calendar."
      },
      {
        "slug": "OUTLOOK_DELETE_CALENDAR_EVENT_FROM_SPECIFIC_CALENDAR",
        "name": "Delete event from specific calendar",
        "description": "Tool to delete an event from a specific calendar in Outlook. Use when removing events from secondary or shared calendars by providing both calendar ID and event ID."
      },
      {
        "slug": "OUTLOOK_DELETE_CALENDAR_FROM_GROUP",
        "name": "Delete user calendar group calendar",
        "description": "Tool to delete a calendar from a specific user's calendar group in Microsoft Outlook. Use when removing a calendar that belongs to a user's calendar group."
      },
      {
        "slug": "OUTLOOK_DELETE_CALENDAR_GROUP",
        "name": "Delete calendar group",
        "description": "Tool to delete a calendar group other than the default calendar group. Use when removing unused calendar groups from the mailbox."
      },
      {
        "slug": "OUTLOOK_DELETE_CALENDAR_GROUP_CALENDAR_EVENT",
        "name": "Delete user calendar group calendar event",
        "description": "Tool to delete a calendar event from a specific user's calendar within a calendar group. Use when removing events from calendars organized under calendar groups for a specific user."
      },
      {
        "slug": "OUTLOOK_DELETE_CALENDAR_GROUP_EVENT_ATTACHMENT",
        "name": "Delete calendar group event attachment",
        "description": "Tool to delete an attachment from an event in a calendar within a calendar group. Use when you need to remove a file or item attachment from an event in a specific calendar group."
      },
      {
        "slug": "OUTLOOK_DELETE_CALENDAR_GROUP_EVENT_PERMANENTLY",
        "name": "Permanently Delete Calendar Group Event",
        "description": "Tool to permanently delete a calendar event from a calendar within a calendar group. Use when you need to ensure an event cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_CALENDAR_PERMANENTLY",
        "name": "Permanently Delete Calendar",
        "description": "Permanently deletes a calendar from a user's mailbox. Unlike standard DELETE, this action makes the calendar permanently unrecoverable. Use when you need to ensure a calendar cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_CALENDAR_PERMISSION",
        "name": "Delete User Calendar Group Calendar Permission",
        "description": "Tool to delete a calendar permission from a user's calendar within a calendar group. Use when revoking calendar sharing access for specific users."
      },
      {
        "slug": "OUTLOOK_DELETE_CHILD_CONTACT_FOLDER_PERMANENTLY",
        "name": "Permanently Delete Child Contact Folder",
        "description": "Permanently deletes a child contact folder. Unlike standard DELETE, this action makes the folder permanently unrecoverable. Use when you need to ensure a child contact folder cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_CHILD_FOLDER_MESSAGE",
        "name": "Delete Child Folder Message",
        "description": "Tool to delete a message from a child mail folder in Outlook. Use when removing messages from nested folder structures or cleaning up messages in subfolders."
      },
      {
        "slug": "OUTLOOK_DELETE_CONTACT",
        "name": "Delete Contact",
        "description": "Permanently deletes an existing contact, using its `contact_id` (obtainable via 'List User Contacts' or 'Get Contact'), from the Outlook contacts of the user specified by `user_id`."
      },
      {
        "slug": "OUTLOOK_DELETE_CONTACT_FOLDER",
        "name": "Delete contact folder",
        "description": "Tool to delete a contact folder from the user's mailbox. Use when you need to remove an existing contact folder."
      },
      {
        "slug": "OUTLOOK_DELETE_CONTACT_FOLDER_CHILD_FOLDER",
        "name": "Delete user contact folder child folder",
        "description": "Tool to delete a child contact folder from a parent contact folder for a specific user. Use when removing nested contact folders from a user's mailbox."
      },
      {
        "slug": "OUTLOOK_DELETE_CONTACT_FOLDER_CONTACT",
        "name": "Delete Contact from Folder",
        "description": "Tool to permanently delete a contact from a specific contact folder. Use when removing contacts from organized folders in Outlook."
      },
      {
        "slug": "OUTLOOK_DELETE_CONTACT_FOLDER_PERMANENTLY",
        "name": "Permanently Delete Contact Folder",
        "description": "Permanently deletes a contact folder. Unlike standard DELETE, this action makes the folder permanently unrecoverable. Use when you need to ensure a contact folder cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_CONTACT_FROM_CHILD_FOLDER_PERMANENTLY",
        "name": "Permanently Delete User Contact from Child Folder",
        "description": "Tool to permanently delete a contact from a child folder for a specific user. Use when you need to ensure a contact cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_CONTACT_FROM_FOLDER_PERMANENTLY",
        "name": "Permanently Delete Contact from Folder",
        "description": "Permanently deletes a contact from a specific contact folder. Unlike standard DELETE, this action makes the contact permanently unrecoverable. Use when you need to ensure a contact in a folder cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_CONTACT_PERMANENTLY",
        "name": "Permanently Delete Contact",
        "description": "Permanently deletes a contact. Unlike standard DELETE, this action makes the contact permanently unrecoverable. Use when you need to ensure a contact cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_CONTACTS_EXTENSIONS",
        "name": "Delete contact extension",
        "description": "Tool to delete a navigation property extension from a contact within a child folder. Use when removing custom extension data from a contact."
      },
      {
        "slug": "OUTLOOK_DELETE_EMAIL_RULE",
        "name": "Delete Email Rule",
        "description": "Delete an email rule permanently; deletion is irreversible. Confirm rule details with the user before executing. Removing a rule may alter the firing order and stop-processing behavior of remaining rules."
      },
      {
        "slug": "OUTLOOK_DELETE_EVENT",
        "name": "Delete calendar event (Deprecated)",
        "description": "DEPRECATED: Use OUTLOOK_DELETE_CALENDAR_EVENT instead. Tool to delete an event from the user's calendar. Use when removing calendar events. If this is a meeting, deleting it removes it from the organizer's calendar and sends a cancellation message to all attendees. Require explicit user confirmation before calling this action."
      },
      {
        "slug": "OUTLOOK_DELETE_EVENT_ATTACHMENT",
        "name": "Delete event attachment",
        "description": "Tool to delete an attachment from an Outlook calendar event. Use when you need to remove a file or item attachment from an existing event."
      },
      {
        "slug": "OUTLOOK_DELETE_EVENT_EXTENSION",
        "name": "Delete event extension",
        "description": "Tool to delete an open extension from a calendar event in a calendar group. Use when removing custom extension data that is no longer needed."
      },
      {
        "slug": "OUTLOOK_DELETE_EVENT_PERMANENTLY",
        "name": "Permanently Delete Event",
        "description": "Permanently deletes a calendar event. Unlike standard DELETE, this action makes the event permanently unrecoverable. Use when you need to ensure an event cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_MAIL_FOLDER",
        "name": "Delete mail folder",
        "description": "Delete a mail folder from the user's mailbox. Use when you need to remove an existing mail folder."
      },
      {
        "slug": "OUTLOOK_DELETE_MAIL_FOLDER_MESSAGE",
        "name": "Delete Mail Folder Message",
        "description": "Tool to delete a message from a specific mail folder in Outlook. Use when removing messages from a particular folder or cleaning up folder contents."
      },
      {
        "slug": "OUTLOOK_DELETE_MASTER_CATEGORY",
        "name": "Delete master category",
        "description": "Tool to delete a category from the user's master category list. Use when removing unused or obsolete categories from the mailbox."
      },
      {
        "slug": "OUTLOOK_DELETE_ME_CALENDAR_PERMISSION",
        "name": "Delete User Calendars Calendar Permission",
        "description": "Tool to delete a calendar permission from a specific user's calendar. Use when revoking access to a shared calendar."
      },
      {
        "slug": "OUTLOOK_DELETE_ME_CONTACT_EXTENSION",
        "name": "Delete contact extension",
        "description": "Tool to delete an open extension from a contact. Use when removing custom data extensions that are no longer needed."
      },
      {
        "slug": "OUTLOOK_DELETE_ME_CONTACT_FOLDER_CONTACT_EXTENSION",
        "name": "Delete user contact folder contact extension",
        "description": "Tool to delete an extension from a contact in a user's contact folder. Use when removing custom extension data from a contact."
      },
      {
        "slug": "OUTLOOK_DELETE_ME_EVENT_EXTENSION",
        "name": "Delete user event extension",
        "description": "Tool to delete an open extension from a user's calendar event. Use when removing custom extension data that is no longer needed."
      },
      {
        "slug": "OUTLOOK_DELETE_ME_EVENTS_ATTACHMENTS",
        "name": "Delete user event attachment",
        "description": "Tool to delete an attachment from a user's Outlook event. Use when you need to remove a file or item attachment from an existing event."
      },
      {
        "slug": "OUTLOOK_DELETE_ME_INFERENCE_CLASSIFICATION_OVERRIDE",
        "name": "Delete inference classification override",
        "description": "Tool to delete an inference classification override for a specific sender. Use when removing custom Focused Inbox rules that were previously set."
      },
      {
        "slug": "OUTLOOK_DELETE_ME_MAIL_FOLDER_CHILD_FOLDER",
        "name": "Delete mail folder child folder",
        "description": "Tool to delete a child mail folder from a parent mail folder. Use when removing nested mail folders from a user's mailbox."
      },
      {
        "slug": "OUTLOOK_DELETE_ME_MAIL_FOLDER_CHILD_FOLDER_PERMANENTLY",
        "name": "Permanently Delete Child Mail Folder",
        "description": "Permanently deletes a child mail folder from a parent mail folder. Unlike standard DELETE, this action makes the folder permanently unrecoverable. Use when you need to ensure a child folder cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_ME_MAIL_FOLDER_MESSAGE_RULE",
        "name": "Delete mail folder message rule",
        "description": "Tool to delete a message rule from a specific mail folder. Use when you need to remove an email automation rule from a folder."
      },
      {
        "slug": "OUTLOOK_DELETE_ME_MAIL_FOLDERS_CHILD_FOLDERS_MESSAGES_EXTENS",
        "name": "Delete user message extension",
        "description": "Delete user message extension"
      },
      {
        "slug": "OUTLOOK_DELETE_ME_MAIL_FOLDERS_MESSAGES_ATTACHMENTS",
        "name": "Delete Message Attachment (Deprecated)",
        "description": "DEPRECATED: Use OUTLOOK_DELETE_MESSAGE_ATTACHMENT instead. Tool to delete an attachment from a message in a mail folder. Use when removing file or item attachments from messages in Outlook mail folders."
      },
      {
        "slug": "OUTLOOK_DELETE_ME_MAIL_FOLDERS_MESSAGES_EXTENSIONS",
        "name": "Delete message extension",
        "description": "Tool to delete a navigation property extension from a message within a mail folder. Use when removing custom extension data from a message."
      },
      {
        "slug": "OUTLOOK_DELETE_ME_MESSAGES_ATTACHMENTS",
        "name": "Delete Message Attachment",
        "description": "Tool to delete an attachment from a message. Use when removing file or item attachments from messages in Outlook."
      },
      {
        "slug": "OUTLOOK_DELETE_MESSAGE",
        "name": "Delete Message",
        "description": "Tool to permanently delete an Outlook email message by its message_id. Use when removing unwanted messages, cleaning up drafts, or performing mailbox maintenance."
      },
      {
        "slug": "OUTLOOK_DELETE_MESSAGE_ATTACHMENT",
        "name": "Delete Message Attachment",
        "description": "Tool to delete an attachment from a message in a nested mail folder structure. Use when removing attachments from messages located in child folders within mail folders."
      },
      {
        "slug": "OUTLOOK_DELETE_MESSAGE_EXTENSION",
        "name": "Delete message extension",
        "description": "Tool to delete an open extension from an Outlook message. Use when removing custom extension data that is no longer needed from a message."
      },
      {
        "slug": "OUTLOOK_DELETE_MESSAGE_PERMANENTLY_FROM_FOLDER",
        "name": "Permanently Delete Message (Folder-Scoped) (Deprecated)",
        "description": "DEPRECATED: Use OUTLOOK_PERMANENT_DELETE_MESSAGE instead. Tool to permanently delete a message from a specific mail folder. Use when you need to irreversibly delete a message with explicit folder context. The message is moved to the Purges folder and cannot be recovered."
      },
      {
        "slug": "OUTLOOK_DELETE_PRIMARY_CALENDAR_PERMISSION",
        "name": "Delete User Calendar Permission",
        "description": "Tool to delete a calendar permission from a specific user's calendar. Use when revoking calendar sharing access for a particular user."
      },
      {
        "slug": "OUTLOOK_DELETE_TODO_TASK",
        "name": "Delete To Do task",
        "description": "Tool to permanently delete a task from a Microsoft To Do task list. Use when removing a task that is no longer needed. This action cannot be undone."
      },
      {
        "slug": "OUTLOOK_DELETE_USER_CALENDAR_EVENT_PERMANENTLY",
        "name": "Permanently Delete User Calendar Event",
        "description": "Tool to permanently delete a calendar event from a specific user's calendar. Use when you need to ensure an event cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_USER_CHILD_FOLDER_CONTACT",
        "name": "Delete Contact from User's Child Folder",
        "description": "Tool to delete a contact from a child folder in a user's contact folder. Use when you need to remove a contact from a specific child folder within a contact folder."
      },
      {
        "slug": "OUTLOOK_DELETE_USER_CHILD_FOLDER_MESSAGE_PERMANENTLY",
        "name": "Delete User Child Folder Message Permanently",
        "description": "Tool to permanently delete a message from a user's child mail folder in Outlook. Unlike standard DELETE, this action makes the message unrecoverable by moving it to the Purges folder in the dumpster. Use when you need to ensure a message in a nested folder cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_USER_CONTACT_EXTENSION",
        "name": "Delete user contact extension",
        "description": "Deprecated: Use OUTLOOK_DELETE_CONTACTS_EXTENSIONS instead, which supports both /me and /users/{user_id} endpoints."
      },
      {
        "slug": "OUTLOOK_DELETE_USER_EVENT_PERMANENTLY",
        "name": "Permanently Delete User Event",
        "description": "Tool to permanently delete a calendar event for a specified user. Use when you need to ensure an event cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_USER_MAIL_FOLDER_PERMANENTLY",
        "name": "Permanently Delete User Mail Folder",
        "description": "Permanently deletes a mail folder for a specific user. Unlike standard DELETE, this action makes the folder permanently unrecoverable. Use when you need to ensure a user's folder cannot be restored from deleted items."
      },
      {
        "slug": "OUTLOOK_DELETE_USER_MESSAGE_ATTACHMENT",
        "name": "Delete user message attachment",
        "description": "Deprecated: Use OUTLOOK_DELETE_ME_MESSAGES_ATTACHMENTS instead, which supports both /me and /users/{user_id} endpoints."
      },
      {
        "slug": "OUTLOOK_DISMISS_CALENDAR_EVENT_REMINDER",
        "name": "Dismiss user calendar event reminder",
        "description": "Tool to dismiss a reminder for a specific event in a user's calendar. Use when you need to turn off or remove a reminder alert for an event in a specific user's calendar."
      },
      {
        "slug": "OUTLOOK_DISMISS_EVENT_REMINDER",
        "name": "Dismiss event reminder",
        "description": "Tool to dismiss a reminder for a specific calendar event. Use when you need to turn off or remove a reminder alert for an event."
      },
      {
        "slug": "OUTLOOK_DISMISS_EVENT_REMINDER_FROM_GROUP",
        "name": "Dismiss user calendar group event reminder",
        "description": "Tool to dismiss a reminder for an event in a user's calendar within a calendar group. Use when you need to turn off a reminder for an event in a specific user's calendar group."
      },
      {
        "slug": "OUTLOOK_DISMISS_USER_EVENT_REMINDER",
        "name": "Dismiss user event reminder",
        "description": "Tool to dismiss a reminder for a specific user's calendar event. Use when you need to turn off or remove a reminder alert for an event in a user's calendar."
      },
      {
        "slug": "OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT",
        "name": "Download Outlook attachment",
        "description": "Downloads a specific file attachment from an email message in a Microsoft Outlook mailbox; the attachment must contain 'contentBytes' (binary data) and not be a link or embedded item. High-volume parallel calls may trigger HTTP 429 responses; honor the Retry-After header and use exponential backoff."
      },
      {
        "slug": "OUTLOOK_FIND_MEETING_TIMES",
        "name": "Find Meeting Times",
        "description": "Suggests meeting times based on organizer and attendee availability, time constraints, and duration requirements. Use when you need to find optimal meeting slots across multiple participants' schedules."
      },
      {
        "slug": "OUTLOOK_FORWARD_MESSAGE",
        "name": "Forward message",
        "description": "Tool to forward a message. Use when you need to send an existing email to new recipients."
      },
      {
        "slug": "OUTLOOK_FORWARD_USER_CALENDAR_EVENT",
        "name": "Forward user calendar event",
        "description": "Tool to forward a calendar event from a specific user's calendar to new recipients. Use when you need to share an event from a particular calendar with additional people."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR",
        "name": "Get specific calendar",
        "description": "Deprecated: Use OUTLOOK_GET_USER_CALENDAR instead, which supports both /me and /users/{user_id} endpoints and adds $select field filtering."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR_EVENT",
        "name": "Get event from calendar",
        "description": "Tool to retrieve a specific event from a specified calendar. Use when you need to get details of an event that belongs to a specific calendar in the user's mailbox."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR_EVENT_ATTACHMENT",
        "name": "Get calendar event attachment",
        "description": "Tool to retrieve a specific attachment from an event within a calendar. Use when you need to access attachment content from a calendar event."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR_FROM_EVENT",
        "name": "Get calendar from event",
        "description": "Tool to retrieve the parent calendar that contains a specific event. Use when you need to get calendar details for a specific event in a calendar."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR_FROM_GROUP",
        "name": "Get calendar from calendar group",
        "description": "Tool to retrieve a specific calendar from a calendar group in Microsoft Outlook. Use when you need to get details of a calendar that belongs to a specific calendar group."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR_GROUP",
        "name": "Get calendar group",
        "description": "Tool to retrieve the properties and relationships of a calendar group object. Use when you need to get details of a specific calendar group by its ID."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR_GROUP_CALENDAR_EVENT_EXTENSION",
        "name": "Get event extension",
        "description": "Tool to retrieve an open extension from a calendar event within a specific calendar group and calendar. Use when you need to access custom data stored with an event."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR_GROUP_EVENT_ATTACHMENT",
        "name": "Get calendar group event attachment",
        "description": "Deprecated: Use OUTLOOK_GET_USER_CALENDAR_GROUP_EVENT_ATTACHMENT instead, which supports both /me and /users/{user_id} endpoints."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR_GROUP_SCHEDULE",
        "name": "Get User Calendar Group Schedule",
        "description": "Tool to retrieve free/busy schedule information for a specific user's calendar within a calendar group. Use when you need availability data from a particular user's calendar that belongs to a calendar group."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR_PERMISSION",
        "name": "Get user calendar permission",
        "description": "Tool to retrieve a specific calendar permission for a user's calendar. Use when you need to check who has access to a specific user's calendar and their permission level."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR_PERMISSION_FROM_CALENDAR",
        "name": "Get user calendar permission",
        "description": "Tool to retrieve a specific calendar permission from a user's calendar. Use when you need to check who has access to a specific user's calendar and their permission level."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR_SCHEDULE",
        "name": "Get Calendar Schedule",
        "description": "Tool to get free/busy schedule information for users, distribution lists, or resources. Use when you need to check availability for specific people or resources during a time period."
      },
      {
        "slug": "OUTLOOK_GET_CALENDAR_VIEW",
        "name": "Get Calendar View",
        "description": "Get events ACTIVE during a time window (includes multi-day events). Use for \"what's on my calendar today/this week\" or availability checks. Returns events overlapping the time range. For keyword search or filters by category, use OUTLOOK_LIST_EVENTS instead."
      },
      {
        "slug": "OUTLOOK_GET_CHILD_FOLDER_MESSAGE",
        "name": "Get child folder message",
        "description": "Tool to retrieve a specific email message from a child mail folder. Use when you need to access a message in a nested folder hierarchy."
      },
      {
        "slug": "OUTLOOK_GET_CHILD_FOLDER_MESSAGE_CONTENT",
        "name": "Get child folder message MIME content",
        "description": "Tool to get the MIME content of a message from a child mail folder. Use when you need to download the raw MIME format of an email message for analysis or archival."
      },
      {
        "slug": "OUTLOOK_GET_CHILD_MAIL_FOLDER",
        "name": "Get child mail folder",
        "description": "Tool to retrieve a specific child mail folder from a parent mail folder. Use when you need details about a specific subfolder within a folder hierarchy."
      },
      {
        "slug": "OUTLOOK_GET_CONTACT_EXTENSION",
        "name": "Get contact extension",
        "description": "Tool to retrieve an open extension from a contact in Microsoft Graph. Use when you need to access custom data stored with a contact."
      },
      {
        "slug": "OUTLOOK_GET_CONTACT_FOLDER",
        "name": "Get contact folder",
        "description": "Tool to retrieve a specific contact folder by ID. Use when you need details about a particular contact folder in the user's mailbox."
      },
      {
        "slug": "OUTLOOK_GET_CONTACT_FOLDERS",
        "name": "List user contact folders",
        "description": "Tool to retrieve contact folders from a specific user's mailbox. Use when you need to list or browse contact folders for a given user."
      },
      {
        "slug": "OUTLOOK_GET_CONTACT_FROM_FOLDER",
        "name": "Get contact from folder",
        "description": "Tool to retrieve a specific contact from a contact folder by its ID. Use when you need to access contact details from a specific folder rather than the default contacts location."
      },
      {
        "slug": "OUTLOOK_GET_DRAFTS_MAIL_FOLDER",
        "name": "Get drafts mail folder",
        "description": "Tool to get the drafts mail folder. Use when you need to retrieve details about the drafts folder such as item counts and folder ID."
      },
      {
        "slug": "OUTLOOK_GET_EVENT",
        "name": "Get calendar event",
        "description": "Retrieves the full details of a specific calendar event by its ID from a user's Outlook calendar, provided the event exists."
      },
      {
        "slug": "OUTLOOK_GET_EVENT_ATTACHMENT",
        "name": "Get event attachment",
        "description": "Tool to retrieve a specific attachment from an Outlook calendar event by attachment ID. Use when you need to download or access the content of a particular event attachment."
      },
      {
        "slug": "OUTLOOK_GET_EVENT_CALENDAR_FROM_GROUP",
        "name": "Get event calendar from calendar group",
        "description": "Tool to retrieve the calendar that contains a specific event within a calendar group. Use when you need to get calendar details for an event in a calendar group."
      },
      {
        "slug": "OUTLOOK_GET_INFERENCE_CLASSIFICATION",
        "name": "Get inference classification",
        "description": "Tool to get inference classification settings for the authenticated user. Use when you need to retrieve the Focused Inbox configuration and sender-specific overrides that determine message classification."
      },
      {
        "slug": "OUTLOOK_GET_MAILBOX_SETTINGS",
        "name": "Get mailbox settings",
        "description": "Tool to retrieve mailbox settings. Use when you need to view settings such as automatic replies, time zone, and working hours for the signed-in or specified user."
      },
      {
        "slug": "OUTLOOK_GET_MAIL_DELTA",
        "name": "Get mail delta",
        "description": "Retrieve incremental changes (delta) of messages in a mailbox. FIRST RUN: Returns ALL messages in folder (use top=50 to limit). Response has @odata.deltaLink. SUBSEQUENT: Pass stored deltaLink to get only NEW/UPDATED/DELETED messages since last sync. Properties available: id, subject, from, receivedDateTime, isRead, etc. NOT available: internetMessageHeaders, full body, attachment content (response size limits)."
      },
      {
        "slug": "OUTLOOK_GET_MAIL_FOLDER",
        "name": "Get mail folder",
        "description": "Tool to retrieve a mail folder by ID or well-known name. Use when you need to get details about a specific folder such as item counts, size, and folder properties."
      },
      {
        "slug": "OUTLOOK_GET_MAIL_FOLDER_MESSAGE",
        "name": "Get mail folder message",
        "description": "Tool to retrieve a specific message from a mail folder by its ID. Use when you need to fetch full message details including subject, body, sender, recipients, timestamps, and other metadata from a specific mail folder."
      },
      {
        "slug": "OUTLOOK_GET_MAIL_FOLDER_MESSAGE_RULE",
        "name": "Get user mail folder message rule",
        "description": "Tool to retrieve a specific message rule from a user's mail folder. Use when you need details about an email rule in a particular user's folder."
      },
      {
        "slug": "OUTLOOK_GET_MAIL_TIPS",
        "name": "Get mail tips",
        "description": "Tool to retrieve mail tips such as automatic replies and mailbox full status. Use when you need to check recipient status before sending mail."
      },
      {
        "slug": "OUTLOOK_GET_MASTER_CATEGORIES",
        "name": "Get master categories",
        "description": "Tool to retrieve the user's master category list. Use when you need to get all categories defined for the user."
      },
      {
        "slug": "OUTLOOK_GET_MASTER_CATEGORY",
        "name": "Get master category",
        "description": "Tool to retrieve properties of a specific category from the user's master category list. Use when you need details about a specific category."
      },
      {
        "slug": "OUTLOOK_GET_ME_CALENDAR",
        "name": "Get user's default calendar",
        "description": "Tool to get the properties and relationships of the signed-in user's default calendar. Use when you need to retrieve calendar details for the authenticated user."
      },
      {
        "slug": "OUTLOOK_GET_ME_CONTACT_FOLDERS_CHILD_FOLDER",
        "name": "Get user child contact folder",
        "description": "Tool to retrieve a specific child contact folder for a user by ID. Use when you need details of a child folder nested within a parent contact folder for a specific user."
      },
      {
        "slug": "OUTLOOK_GET_ME_CONTACT_FROM_CHILD_FOLDER",
        "name": "Get contact from child folder",
        "description": "Tool to retrieve a specific contact from a nested child folder within a contact folder. Use when you need contact details from a child folder."
      },
      {
        "slug": "OUTLOOK_GET_ME_CONTACT_PHOTO",
        "name": "Get contact photo",
        "description": "Tool to get the binary media content of a contact's profile photo. Use when you need to download or retrieve a contact's picture."
      },
      {
        "slug": "OUTLOOK_GET_ME_CONTACTS",
        "name": "Get contact",
        "description": "Retrieves a specific Outlook contact by its `contact_id` from the contacts of a specified `user_id` (defaults to 'me' for the authenticated user)."
      },
      {
        "slug": "OUTLOOK_GET_ME_CONTACTS_EXTENSIONS",
        "name": "Get user contact extension",
        "description": "Tool to retrieve a specific open extension from a user's contact. Use when you need to access custom data stored with a contact."
      },
      {
        "slug": "OUTLOOK_GET_ME_EVENT_ATTACHMENT",
        "name": "Get user event attachment",
        "description": "Tool to retrieve a specific attachment from a user's calendar event. Use when you need to access attachment details including content from a specific user's event."
      },
      {
        "slug": "OUTLOOK_GET_ME_EVENT_CALENDAR",
        "name": "Get event calendar",
        "description": "Tool to retrieve the calendar that contains a specific event. Use when you need to get calendar details for an event."
      },
      {
        "slug": "OUTLOOK_GET_ME_MAIL_FOLDER_MESSAGE_ATTACHMENT",
        "name": "Get mail folder message attachment (Deprecated)",
        "description": "DEPRECATED: Use OUTLOOK_GET_USER_MESSAGES_ATTACHMENTS instead. Tool to get a specific attachment from a message in a mail folder. Use when you have the folder ID, message ID, and attachment ID."
      },
      {
        "slug": "OUTLOOK_GET_ME_MAIL_FOLDERS_MESSAGES_EXTENSIONS",
        "name": "Get message extension",
        "description": "Tool to retrieve a specific extension from a message in a user's mailbox. Use when you need to read custom data stored in a message extension."
      },
      {
        "slug": "OUTLOOK_GET_ME_MESSAGE_MIME_CONTENT",
        "name": "Get message MIME content",
        "description": "Tool to get the MIME content of a message. Use when you need to download the raw MIME format of an email message for analysis or archival."
      },
      {
        "slug": "OUTLOOK_GET_ME_OUTLOOK",
        "name": "Get user outlook",
        "description": "Tool to retrieve the outlookUser object for a specified user. Use when you need to access the Outlook services entity for a user."
      },
      {
        "slug": "OUTLOOK_GET_MESSAGE",
        "name": "Get email message",
        "description": "Retrieves a specific email message by its ID from the specified user's Outlook mailbox. Use the 'select' parameter to include specific fields like 'internetMessageHeaders' for filtering automated emails. Retries transient Microsoft Graph 404 responses with exponential backoff for up to 7.5 seconds because newly surfaced messages can be eventually consistent."
      },
      {
        "slug": "OUTLOOK_GET_MESSAGE_EXTENSION",
        "name": "Get user message extension",
        "description": "Tool to retrieve a specific extension from a user's message. Use when you need to read custom data stored in a message extension."
      },
      {
        "slug": "OUTLOOK_GET_NESTED_FOLDER_MESSAGE_ATTACHMENT",
        "name": "Get attachment from nested folder message",
        "description": "Tool to retrieve a specific attachment from a message located in a nested mail folder structure. Use when you need to get attachment details from messages in deeply nested folders."
      },
      {
        "slug": "OUTLOOK_GET_PROFILE",
        "name": "Get Outlook profile",
        "description": "Retrieves the Microsoft Outlook profile for a specified user."
      },
      {
        "slug": "OUTLOOK_GET_SCHEDULE",
        "name": "Get schedule",
        "description": "Retrieves free/busy schedule information for specified email addresses within a defined time window. Read-only; does not reserve time or prevent conflicts — verify availability before creating events."
      },
      {
        "slug": "OUTLOOK_GET_SUPPORTED_LANGUAGES",
        "name": "Get supported languages",
        "description": "Tool to retrieve supported languages in the user's mailbox. Use when you need to display or select from available mailbox languages."
      },
      {
        "slug": "OUTLOOK_GET_SUPPORTED_TIME_ZONES",
        "name": "Get supported time zones",
        "description": "Tool to get the list of time zones supported for a user as configured on their mailbox server. Use when setting up an Outlook client or configuring user time zone preferences."
      },
      {
        "slug": "OUTLOOK_GET_USER_BY_EMAIL",
        "name": "Get user by email",
        "description": "Retrieves user details from Microsoft Graph by email address (userPrincipalName). Returns user properties including display name, job title, department, and contact information. Use this action when you need to look up a user's profile information using their email address."
      },
      {
        "slug": "OUTLOOK_GET_USER_CALENDAR",
        "name": "Get user's calendar",
        "description": "Tool to get the properties and relationships of a specific calendar for a user. Use when you need to retrieve details for a particular calendar by its ID for any user."
      },
      {
        "slug": "OUTLOOK_GET_USER_CALENDAR_ALLOWED_SHARING_ROLES",
        "name": "Get allowed calendar sharing roles for user calendar",
        "description": "Tool to retrieve allowed calendar sharing roles for a specific user on a given calendar. Use when you need to determine what permission levels can be granted to a user for sharing a specific calendar."
      },
      {
        "slug": "OUTLOOK_GET_USER_CALENDAR_EVENT",
        "name": "Get user calendar event",
        "description": "Tool to retrieve a specific calendar event from a user's primary calendar. Use when you need detailed information about a particular event for a given user."
      },
      {
        "slug": "OUTLOOK_GET_USER_CALENDAR_GROUP_CALENDAR_PERMISSION",
        "name": "Get user calendar group calendar permission",
        "description": "Tool to retrieve a specific calendar permission for a user's calendar within a calendar group. Use when you need to check access permissions for a specific calendar."
      },
      {
        "slug": "OUTLOOK_GET_USER_CALENDAR_GROUP_EVENT",
        "name": "Get user calendar group event",
        "description": "Tool to retrieve a specific event from a user's calendar within a calendar group. Use when you need details of an event in a specific calendar group."
      },
      {
        "slug": "OUTLOOK_GET_USER_CALENDAR_GROUP_EVENT_ATTACHMENT",
        "name": "Get user calendar group event attachment",
        "description": "Tool to retrieve a specific attachment from an event within a calendar group for a user. Use when you need to access attachment content from a calendar event in a user's calendar group."
      },
      {
        "slug": "OUTLOOK_GET_USER_CHILD_FOLDER_MESSAGE",
        "name": "Get message from child folder",
        "description": "Tool to retrieve a specific message from a child folder within a user's mail folder hierarchy. Use when you need to access messages from nested folders where both parent and child folder IDs are known."
      },
      {
        "slug": "OUTLOOK_GET_USER_EVENT_EXTENSION",
        "name": "Get event extension",
        "description": "Tool to retrieve a specific open type extension from a user's calendar event by its extension ID or name. Use when you need to access custom data stored in calendar event extensions."
      },
      {
        "slug": "OUTLOOK_GET_USER_MESSAGES_ATTACHMENTS",
        "name": "Get user message attachment",
        "description": "Tool to retrieve a specific attachment from a message in a mail folder hierarchy. Use when you need to get attachment details including content from a specific folder path."
      },
      {
        "slug": "OUTLOOK_LIST_CALENDAR_CALENDAR_VIEW",
        "name": "List Calendar Calendar View (Deprecated)",
        "description": "DEPRECATED: Use OUTLOOK_LIST_ME_CALENDARS_CALENDAR_VIEW instead. Tool to list calendar events within a specified date/time range. Use when you need to retrieve events from the user's primary calendar that fall within a time window."
      },
      {
        "slug": "OUTLOOK_LIST_CALENDAR_EVENT_ATTACHMENTS",
        "name": "List user calendar event attachments",
        "description": "Tool to list attachments for a calendar event within a specific calendar for a user. Use when you need to retrieve attachments from an event in a user's specific calendar."
      },
      {
        "slug": "OUTLOOK_LIST_CALENDAR_GROUP_CALENDAR_EVENTS",
        "name": "List user calendar group calendar events",
        "description": "Tool to list events from a specific calendar within a calendar group for a user. Use when you need to retrieve events from a user's calendar that belongs to a specific calendar group."
      },
      {
        "slug": "OUTLOOK_LIST_CALENDAR_GROUP_CALENDARS",
        "name": "List calendars in calendar group",
        "description": "Tool to retrieve calendars belonging to a specific calendar group. Use when you need to list calendars within a calendar group with optional OData queries."
      },
      {
        "slug": "OUTLOOK_LIST_CALENDAR_GROUP_EVENT_ATTACHMENTS",
        "name": "List user calendar group event attachments",
        "description": "Tool to list attachments for a calendar event within a specific calendar group for a user. Use when you need to retrieve attachments from an event in a calendar that belongs to a calendar group for a specific user."
      },
      {
        "slug": "OUTLOOK_LIST_CALENDAR_GROUPS",
        "name": "List Outlook calendar groups",
        "description": "Tool to list calendar groups in the signed-in user's mailbox. Use when you need to retrieve calendar groups with optional OData queries."
      },
      {
        "slug": "OUTLOOK_LIST_CALENDAR_PERMISSIONS",
        "name": "List calendar permissions",
        "description": "Tool to list calendar permissions for a specific calendar within a calendar group. Use when you need to view sharing permissions for a calendar."
      },
      {
        "slug": "OUTLOOK_LIST_CALENDARS",
        "name": "List Outlook calendars",
        "description": "Tool to list calendars in the signed-in user's mailbox. Use when you need to retrieve calendars with optional OData queries."
      },
      {
        "slug": "OUTLOOK_LIST_CALENDAR_VIEW_DELTA",
        "name": "List calendar view delta",
        "description": "Tool to get calendar events that have been added, deleted, or updated in a calendar view. Use when you need to track changes to events within a specific time range."
      },
      {
        "slug": "OUTLOOK_LIST_CHAT_MESSAGES",
        "name": "List chat messages",
        "description": "Tool to list messages in a Teams chat. Use when you need message IDs to select a specific message for further actions."
      },
      {
        "slug": "OUTLOOK_LIST_CHATS",
        "name": "List Teams chats",
        "description": "Tool to list Teams chats. Use when you need chat IDs and topics to select a chat for further actions."
      },
      {
        "slug": "OUTLOOK_LIST_CHILD_FOLDER_CONTACTS",
        "name": "List user child folder contacts",
        "description": "Tool to retrieve contacts from a user's child contact folder. Use when you need to access contacts organized in nested folder structures for a specific user."
      },
      {
        "slug": "OUTLOOK_LIST_CHILD_FOLDER_MESSAGES",
        "name": "List child folder messages",
        "description": "Tool to list messages from a child folder within a parent mail folder. Use when you need to retrieve messages from a subfolder that exists within another folder."
      },
      {
        "slug": "OUTLOOK_LIST_CHILD_MAIL_FOLDERS",
        "name": "List child mail folders",
        "description": "Tool to list subfolders (childFolders) under a specified Outlook mail folder. Use when navigating nested folder hierarchies or checking if a folder has subfolders."
      },
      {
        "slug": "OUTLOOK_LIST_CONTACT_FOLDER_CHILD_FOLDERS",
        "name": "List contact folder child folders",
        "description": "Tool to list child folders under a specified contact folder. Use when navigating nested contact folder hierarchies or organizing contacts into subfolder structures."
      },
      {
        "slug": "OUTLOOK_LIST_CONTACT_FOLDERS_DELTA",
        "name": "List contact folders delta",
        "description": "Tool to get contact folders that have been added, deleted, or updated. Use when tracking changes to contact folder structure without fetching all folders each time."
      },
      {
        "slug": "OUTLOOK_LIST_CONTACTS",
        "name": "List Outlook contacts (Deprecated)",
        "description": "DEPRECATED: Use OUTLOOK_LIST_USER_CONTACTS instead. Retrieves a user's Microsoft Outlook contacts, from the default or a specified contact folder."
      },
      {
        "slug": "OUTLOOK_LIST_CONTACTS_DELTA",
        "name": "List contacts delta",
        "description": "Retrieve incremental changes (delta) of contacts in a specified folder. Use when syncing contacts without fetching the entire set each time. FIRST RUN: Returns ALL contacts in folder. Response has @odata.deltaLink. SUBSEQUENT: Pass stored deltaLink to get only NEW/UPDATED/DELETED contacts since last sync."
      },
      {
        "slug": "OUTLOOK_LIST_EMAIL_RULES",
        "name": "List Email Rules",
        "description": "List all email rules from inbox. No server-side filtering is supported; all rule narrowing must be done client-side after retrieval. Each rule includes a `sequence` field defining execution order and may include a `stopProcessingRules` flag affecting downstream rule execution."
      },
      {
        "slug": "OUTLOOK_LIST_EVENT_ATTACHMENTS",
        "name": "List event attachments",
        "description": "Tool to list attachments for a specific Outlook calendar event. Use when you have an event ID and need to view its attachments."
      },
      {
        "slug": "OUTLOOK_LIST_EVENT_CALENDAR_CALENDAR_PERMISSIONS",
        "name": "List event calendar permissions",
        "description": "Tool to list calendar permissions for the calendar containing a specific event. Use when you need to see who has access to a calendar that contains a particular event."
      },
      {
        "slug": "OUTLOOK_LIST_EVENT_INSTANCES",
        "name": "List event instances",
        "description": "Tool to retrieve individual occurrences of a recurring calendar event within a specified time range. Use when you need to get specific instances of a recurring meeting or event series."
      },
      {
        "slug": "OUTLOOK_LIST_EVENTS",
        "name": "List events",
        "description": "Retrieves events from a user's Outlook calendar via Microsoft Graph API. Supports primary/secondary/shared calendars, pagination, filtering, property selection, sorting, and timezone specification. Use calendar_id to access non-primary calendars."
      },
      {
        "slug": "OUTLOOK_LIST_INFERENCE_CLASSIFICATION_OVERRIDES",
        "name": "List Inference Classification Overrides",
        "description": "Tool to list inference classification overrides that control Focused Inbox sender rules. Use when you need to see which senders are configured to always appear in Focused or Other inbox."
      },
      {
        "slug": "OUTLOOK_LIST_MAIL_FOLDER_MESSAGE_ATTACHMENTS",
        "name": "List mail folder message attachments",
        "description": "Tool to get attachments from a message in a specific mail folder. Use when you need to retrieve attachment metadata from a message located in a particular folder."
      },
      {
        "slug": "OUTLOOK_LIST_MAIL_FOLDER_MESSAGE_RULES",
        "name": "List mail folder message rules",
        "description": "Tool to list message rules for a specific mail folder. Use when you need to retrieve rules configured for a particular folder."
      },
      {
        "slug": "OUTLOOK_LIST_MAIL_FOLDER_MESSAGES",
        "name": "List mail folder messages",
        "description": "Tool to list messages from a specific mail folder including subfolders. Use when you need to retrieve messages from a particular folder or subfolder by its ID or well-known name."
      },
      {
        "slug": "OUTLOOK_LIST_MAIL_FOLDERS",
        "name": "List mail folders",
        "description": "Tool to list a user's top-level mail folders. Use when you need folders like Inbox, Drafts, Sent Items; set include_hidden_folders=True to include hidden folders."
      },
      {
        "slug": "OUTLOOK_LIST_MAIL_FOLDERS_DELTA",
        "name": "List mail folders delta",
        "description": "Tool to get incremental changes to mail folders. Use when you need to track additions, deletions, or updates to mail folders without fetching the entire folder list each time."
      },
      {
        "slug": "OUTLOOK_LIST_MASTER_CATEGORIES",
        "name": "List master categories",
        "description": "Deprecated: Use OUTLOOK_GET_MASTER_CATEGORIES instead, which adds pagination (top/skip), filtering, field selection, and sorting."
      },
      {
        "slug": "OUTLOOK_LIST_ME_CALENDAR_PERMISSIONS",
        "name": "List user calendar permissions",
        "description": "Tool to list calendar permissions for a specific user's calendar. Use when you need to see who has access to a user's calendar and their permission levels."
      },
      {
        "slug": "OUTLOOK_LIST_ME_EVENT_INSTANCES",
        "name": "List me event instances (Deprecated)",
        "description": "DEPRECATED: Use OUTLOOK_LIST_EVENT_INSTANCES instead. Tool to retrieve individual occurrences of a recurring calendar event within a specified time range. Use when you need to get specific instances of a recurring meeting or event series from the authenticated user's primary calendar."
      },
      {
        "slug": "OUTLOOK_LIST_MESSAGE_ATTACHMENTS_FROM_CHILD_FOLDER",
        "name": "List message attachments from child folder",
        "description": "Tool to list attachments from a message in a nested child mail folder. Use when you need to retrieve attachment metadata from a message located in a subfolder."
      },
      {
        "slug": "OUTLOOK_LIST_MESSAGES",
        "name": "List Messages",
        "description": "Retrieves a list of email messages from a specified mail folder in an Outlook mailbox, with options for filtering (including by conversationId to get all messages in a thread), pagination, and sorting; ensure 'user_id' and 'folder' are valid, and all date/time strings are in ISO 8601 format."
      },
      {
        "slug": "OUTLOOK_LIST_OUTLOOK_ATTACHMENTS",
        "name": "List Outlook attachments",
        "description": "Lists metadata (name, size, contentType, isInline — but not `contentBytes`) for all attachments of a specified Outlook email message. Returns fileAttachment, itemAttachment, and referenceAttachment types; only fileAttachment entries support download via OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT. Results include inline images and signatures — filter by `isInline == false` and check `contentType` to identify real document attachments. Results are nested under `data.response_data.value`."
      },
      {
        "slug": "OUTLOOK_LIST_PLACES",
        "name": "List places",
        "description": "Retrieves a collection of place objects defined in a tenant by type. Places can include rooms, workspaces, buildings, floors, sections, desks, and room lists. When room_list_id is provided, returns only rooms or workspaces within that specific room list using the /places/{roomListId}/microsoft.graph.roomlist/rooms (or /workspaces) endpoint. Use this action when you need to discover available physical spaces or locations within an organization. Note: Before using this API, ensure that the Places settings are properly configured in the tenant."
      },
      {
        "slug": "OUTLOOK_LIST_PRIMARY_CALENDAR_PERMISSIONS",
        "name": "List primary calendar permissions",
        "description": "Tool to list calendar permissions from a user's primary calendar. Use when you need to see who has access to the primary calendar and their permission levels."
      },
      {
        "slug": "OUTLOOK_LIST_REMINDERS",
        "name": "List event reminders",
        "description": "Tool to retrieve reminders for events occurring within a specified time range. Use when you need to see upcoming reminders between two datetimes."
      },
      {
        "slug": "OUTLOOK_LIST_SENT_ITEMS_MESSAGES",
        "name": "List sent items messages",
        "description": "Tool to list all messages in the SentItems mail folder of the signed-in user's mailbox. Use when you need to retrieve sent messages with optional filtering and sorting."
      },
      {
        "slug": "OUTLOOK_LIST_TO_DO_LISTS",
        "name": "List To Do task lists",
        "description": "Tool to list Microsoft To Do task lists for the signed-in user. Use when you need to discover available task lists before listing or creating tasks. Returns todoTaskList objects with id and displayName that can be used in downstream operations."
      },
      {
        "slug": "OUTLOOK_LIST_TODO_TASKS",
        "name": "List tasks from a To Do list",
        "description": "Tool to list tasks within a specified Microsoft To Do task list, including status and due dates. Use when retrieving tasks from a specific To Do list."
      },
      {
        "slug": "OUTLOOK_LIST_USER_CALENDAR_EVENT_INSTANCES",
        "name": "List calendar event instances",
        "description": "Tool to retrieve instances (occurrences) of a recurring event from a specific calendar within a date range. Use when you need event instances from a particular calendar."
      },
      {
        "slug": "OUTLOOK_LIST_USER_CALENDAR_EVENTS_ATTACHMENTS",
        "name": "List user calendar event attachments",
        "description": "Tool to list attachments for a user's calendar event. Use when you need to retrieve all attachments from a specific event in a user's calendar."
      },
      {
        "slug": "OUTLOOK_LIST_USER_CALENDAR_GROUP_EVENT_INSTANCES",
        "name": "List event instances",
        "description": "Tool to list instances (occurrences) of a recurring event within a specified date range from a user's calendar in a calendar group. Use when you need to retrieve specific occurrences of a recurring event."
      },
      {
        "slug": "OUTLOOK_LIST_USER_CALENDAR_GROUPS_CALENDAR_VIEW",
        "name": "Get Calendar View from User Calendar Group",
        "description": "Tool to get calendar view from a specific calendar within a calendar group for a user. Use when retrieving events from a calendar that belongs to a calendar group."
      },
      {
        "slug": "OUTLOOK_LIST_USER_CALENDARS_CALENDAR_PERMISSIONS",
        "name": "List user calendar permissions",
        "description": "Tool to list calendar permissions for a specific user's specific calendar. Use when you need to see who has access to a user's calendar and their permission levels."
      },
      {
        "slug": "OUTLOOK_LIST_USER_CALENDARS_EVENTS",
        "name": "List user calendars events",
        "description": "Tool to retrieve events from a specific calendar for a user. Use when you need to list calendar events for a specific user by user ID and calendar ID."
      },
      {
        "slug": "OUTLOOK_LIST_USER_CALENDAR_VIEW",
        "name": "Get calendar view from user's calendar",
        "description": "Tool to get calendar view from a specific user's calendar. Use when you need to retrieve events that occur or overlap with a specified time window from a user's specific calendar by calendar ID."
      },
      {
        "slug": "OUTLOOK_LIST_USER_CONTACTS",
        "name": "List user contacts",
        "description": "Tool to retrieve contacts from a specific user's mailbox. Use when you need to list or browse contacts for a given user."
      },
      {
        "slug": "OUTLOOK_LIST_USERS",
        "name": "List users",
        "description": "Tool to list users in Microsoft Entra ID. Use when you need to retrieve a paginated list of users, optionally filtering or selecting specific properties. For single-user lookups, prefer a dedicated get-user tool — listing all users is significantly heavier and slower."
      },
      {
        "slug": "OUTLOOK_MOVE_MAIL_FOLDER",
        "name": "Move mail folder",
        "description": "Tool to move a mail folder and its contents to another mail folder. Use when you need to reorganize the folder hierarchy."
      },
      {
        "slug": "OUTLOOK_MOVE_ME_MAIL_FOLDER",
        "name": "Move child mail folder",
        "description": "Tool to move a child mail folder to a different parent folder. Use when you need to reorganize subfolders within the folder hierarchy."
      },
      {
        "slug": "OUTLOOK_MOVE_MESSAGE",
        "name": "Move message to folder",
        "description": "Move a message to another folder within the specified user's mailbox. Creates a new copy in the destination folder and removes the original. The message_id changes after a successful move; use the ID returned in the response for any subsequent operations on the moved message. Retries transient Microsoft Graph 404 responses with exponential backoff for up to 7.5 seconds because newly surfaced messages can be eventually consistent. High-volume parallel moves can trigger HTTP 429 (MailboxConcurrency) throttling; honor the Retry-After header."
      },
      {
        "slug": "OUTLOOK_MOVE_MESSAGE_FROM_CHILD_FOLDER",
        "name": "Move message from child folder",
        "description": "Tool to move a message from a child folder to another destination folder. Use when you need to move a message that exists within a specific folder hierarchy (parent folder → child folder → message)."
      },
      {
        "slug": "OUTLOOK_MOVE_MESSAGE_FROM_FOLDER",
        "name": "Move message from folder",
        "description": "Tool to move a message from a specific mail folder to another destination folder. Use when you need to move a message and know both the source folder ID and the message ID."
      },
      {
        "slug": "OUTLOOK_PERMANENT_DELETE_MESSAGE",
        "name": "Permanently Delete Message",
        "description": "Permanently deletes an Outlook message by moving it to the Purges folder in the dumpster. Unlike standard DELETE, this action makes the message unrecoverable by the user. IMPORTANT: This is NOT the same as DELETE - permanentDelete is irreversible and availability differs by national cloud deployments (not available in US Government L4, L5 (DOD), or China (21Vianet))."
      },
      {
        "slug": "OUTLOOK_PIN_MESSAGE",
        "name": "Pin message",
        "description": "Tool to pin a message in an Outlook chat. Use when you want to mark an important message for quick access."
      },
      {
        "slug": "OUTLOOK_QUERY_EMAILS",
        "name": "Query Emails",
        "description": "Query Outlook emails within a SINGLE folder using OData filters. Build precise server-side filters for dates, read status, importance, subjects, attachments, and conversations. Best for structured queries on message metadata within a specific folder. Returns up to 100 messages per request with pagination support. • Searches SINGLE folder only (inbox, sentitems, etc.) - NOT across all folders • For cross-folder/mailbox-wide search: Use OUTLOOK_SEARCH_MESSAGES • Server-side filters: dates, importance, isRead, hasAttachments, subjects, conversationId • Pagination: use the returned next_page_token (pass it back as page_token) until it is absent • Limitations: Recipient/body filtering requires OUTLOOK_SEARCH_MESSAGES"
      },
      {
        "slug": "OUTLOOK_REPLY_EMAIL",
        "name": "Reply to Email",
        "description": "Sends a reply to an Outlook email message with optional HTML formatting, attachments, CC, and BCC recipients."
      },
      {
        "slug": "OUTLOOK_SEARCH_EVENTS",
        "name": "Search calendar events",
        "description": "Searches for calendar events in the authenticated user's primary calendar using the Microsoft Graph Search API. This action performs full-text search across event subject, body, location, and attendee information. Use this action when you need to find events by keyword or phrase rather than filtering by specific fields. For filtering by date range or specific properties, use the list events action instead."
      },
      {
        "slug": "OUTLOOK_SEARCH_MESSAGES",
        "name": "Search Outlook messages",
        "description": "Search Outlook messages using powerful KQL syntax. Supports sender (from:), recipient (to:, cc:), subject, date filters (received:, sent:), attachments, and boolean logic. Only works with Microsoft 365/Enterprise accounts (no @hotmail.com/@outlook.com). Examples: 'from:[email protected] AND received>=2025-10-01', 'to:[email protected] AND subject:invoice', 'received>today-30 AND hasattachment:yes'"
      },
      {
        "slug": "OUTLOOK_SEND_DRAFT",
        "name": "Send draft",
        "description": "Tool to send an existing draft message. Use after creating a draft when you want to deliver it to recipients immediately. Example: Send a draft message with ID 'AAMkAG…'."
      },
      {
        "slug": "OUTLOOK_SEND_EMAIL",
        "name": "Send email",
        "description": "Sends an email with subject, body, recipients, and optional attachments via Microsoft Graph API. Supports comma-separated email addresses in the to_email field for multiple recipients. Accepts either a single file or a list of files as attachments. Attachments require a non-empty file with valid name and mimetype."
      },
      {
        "slug": "OUTLOOK_SNOOZE_CALENDAR_GROUP_EVENT_REMINDER",
        "name": "Snooze user calendar group event reminder",
        "description": "Tool to snooze a reminder for a user's calendar event within a calendar group to a new time. Use when you need to postpone an event reminder for a specific user's calendar that belongs to a calendar group."
      },
      {
        "slug": "OUTLOOK_SNOOZE_EVENT_REMINDER",
        "name": "Snooze event reminder",
        "description": "Tool to postpone an event reminder until a new time. Use when you need to delay a reminder for a calendar event."
      },
      {
        "slug": "OUTLOOK_SNOOZE_USER_CALENDAR_EVENT_REMINDER",
        "name": "Snooze user calendar event reminder",
        "description": "Tool to snooze a reminder for a calendar event in a specific user calendar to a new time. Use when you need to postpone an event reminder for a specific calendar."
      },
      {
        "slug": "OUTLOOK_SNOOZE_USER_EVENT_REMINDER",
        "name": "Snooze user event reminder",
        "description": "Tool to snooze a reminder for a user's calendar event to a new time. Use when you need to postpone an event reminder for a specific user."
      },
      {
        "slug": "OUTLOOK_UPDATE_CALENDAR_EVENT",
        "name": "Update calendar event",
        "description": "Updates specified fields of an existing Outlook calendar event. Implementation note: To avoid unintentionally clearing properties, the action first fetches the existing event, merges only the provided fields, and then PATCHes the merged updates. Unspecified fields remain unchanged."
      },
      {
        "slug": "OUTLOOK_UPDATE_CALENDAR_EVENT_IN_CALENDAR",
        "name": "Update event in specific calendar",
        "description": "Tool to update an event in a specific Outlook calendar. Use when you need to modify event details like subject, time, attendees, or location in a non-default calendar."
      },
      {
        "slug": "OUTLOOK_UPDATE_CALENDAR_GROUP",
        "name": "Update calendar group",
        "description": "Tool to update the properties of a calendar group object. Use when you need to rename a calendar group."
      },
      {
        "slug": "OUTLOOK_UPDATE_CALENDAR_GROUP_CALENDAR_PERMISSION",
        "name": "Update Calendar Group Calendar Permission",
        "description": "Tool to update a calendar permission within a calendar group. Use when changing access levels for calendars in specific groups."
      },
      {
        "slug": "OUTLOOK_UPDATE_CALENDAR_GROUPS_CALENDARS",
        "name": "Update user calendar in calendar group",
        "description": "Tool to update a calendar within a calendar group in a user's mailbox. Use when modifying calendar properties like name, color, or default calendar status."
      },
      {
        "slug": "OUTLOOK_UPDATE_CALENDAR_GROUPS_CALENDARS_EVENTS",
        "name": "Update user calendar group event",
        "description": "Tool to update an event in a calendar within a calendar group for a specific user. Use when modifying event details for a user's calendar."
      },
      {
        "slug": "OUTLOOK_UPDATE_CALENDAR_PERMISSION",
        "name": "Update calendar permission",
        "description": "Tool to update calendar permission levels for share recipients or delegates. Use when you need to change the access level (role) for someone who has been granted access to a calendar."
      },
      {
        "slug": "OUTLOOK_UPDATE_CHILD_FOLDER_CONTACT",
        "name": "Update child folder contact",
        "description": "Tool to update a contact in a child contact folder within a parent contact folder. Use when you need to modify contact properties such as name, email, phone numbers, or company details for contacts in nested folder structures."
      },
      {
        "slug": "OUTLOOK_UPDATE_CONTACT",
        "name": "Update Contact",
        "description": "Updates an existing Outlook contact, identified by `contact_id` for the specified `user_id`, requiring at least one other field to be modified."
      },
      {
        "slug": "OUTLOOK_UPDATE_CONTACT_FOLDER",
        "name": "Update user contact folder",
        "description": "Tool to update the properties of a contact folder for a specific user. Use when you need to rename or move an existing contact folder."
      },
      {
        "slug": "OUTLOOK_UPDATE_CONTACT_FOLDER_CHILD_FOLDER",
        "name": "Update user contact folder child folder",
        "description": "Tool to update a child folder within a contact folder for a specific user. Use when you need to rename a child contact folder or move it to a different parent folder."
      },
      {
        "slug": "OUTLOOK_UPDATE_CONTACT_FOLDERS_CONTACTS",
        "name": "Update contact in folder",
        "description": "Tool to update a contact within a specific contact folder. Use when you need to modify contact details for a contact stored in a particular folder."
      },
      {
        "slug": "OUTLOOK_UPDATE_EMAIL",
        "name": "Update email message",
        "description": "Updates specified properties of an existing email message; `message_id` must identify a valid message within the specified `user_id`'s mailbox."
      },
      {
        "slug": "OUTLOOK_UPDATE_EMAIL_RULE",
        "name": "Update Email Rule",
        "description": "Update an existing email rule"
      },
      {
        "slug": "OUTLOOK_UPDATE_EVENT_EXTENSION",
        "name": "Update event extension",
        "description": "Tool to update an open extension on a calendar event in Microsoft Graph. Use when you need to modify custom properties stored in an event extension."
      },
      {
        "slug": "OUTLOOK_UPDATE_EVENT_EXTENSION_IN_CALENDAR_GROUP",
        "name": "Update event extension in calendar group",
        "description": "Tool to update an open extension on a calendar event within a calendar group. Use when modifying custom properties stored in an event extension for events in calendar groups."
      },
      {
        "slug": "OUTLOOK_UPDATE_INFERENCE_CLASSIFICATION",
        "name": "Update Inference Classification",
        "description": "Tool to update the inferenceClassification resource for a user. Use when needing to refresh or sync the Focused Inbox classification settings. Note: The inferenceClassification resource has no writable properties; actual message classification rules are managed through the overrides collection."
      },
      {
        "slug": "OUTLOOK_UPDATE_MAILBOX_SETTINGS",
        "name": "Update mailbox settings",
        "description": "Tool to update mailbox settings for the signed-in user. Use when you need to configure automatic replies, default time zone, language, or working hours. Example: schedule automatic replies for vacation."
      },
      {
        "slug": "OUTLOOK_UPDATE_MAIL_FOLDER",
        "name": "Update mail folder",
        "description": "Tool to update the display name of a mail folder. Use when you need to rename an existing mail folder."
      },
      {
        "slug": "OUTLOOK_UPDATE_MASTER_CATEGORY",
        "name": "Update master category",
        "description": "Tool to update the color of a category in the user's master category list. Use when you need to change the color of an existing category. Note that the display name cannot be modified after creation."
      },
      {
        "slug": "OUTLOOK_UPDATE_ME_CONTACTS_EXTENSIONS",
        "name": "Update contact extension",
        "description": "Tool to update an open extension on a contact in a contact folder. Use when you need to modify custom properties stored in a contact extension."
      },
      {
        "slug": "OUTLOOK_UPDATE_TODO_TASK",
        "name": "Update To Do task",
        "description": "Tool to update an existing task in Microsoft To Do. Use when modifying a task's title, status, importance, due date, reminder, body, or categories. Only the fields you provide will be changed."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_CALENDAR",
        "name": "Update user calendar",
        "description": "Tool to update the properties of a user's calendar. Use when you need to rename a calendar or change its color theme for a specific user."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_CALENDAR_CALENDAR_EVENT",
        "name": "Update user calendar event",
        "description": "Deprecated: Use OUTLOOK_UPDATE_CALENDAR_EVENT_IN_CALENDAR instead, which supports both /me and /users/{user_id} endpoints and additional fields (is_all_day, importance, sensitivity, reminders)."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_CALENDAR_EVENT",
        "name": "Update user calendar event",
        "description": "Tool to update an event in a specific user's calendar. Use when you need to modify calendar event properties for a user other than the signed-in user."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_CALENDAR_PERMISSION",
        "name": "Update user calendar permission",
        "description": "Tool to update calendar permission levels for a specific user's calendar. Use when you need to change the access level (role) for someone who has been granted access to a user's calendar."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_CALENDARS",
        "name": "Update user calendar by ID",
        "description": "Tool to update properties of a specific calendar by ID for a specific user. Use when you need to rename a user's calendar, change its color theme, or set it as the default calendar."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_CHILD_FOLDER_MESSAGE",
        "name": "Update user child folder message",
        "description": "Tool to update a message in a child folder within a user's mailbox. Use when you need to modify message properties such as isRead status, importance, categories, or subject for messages in nested folder structures for a specific user."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_CONTACT_EXTENSION",
        "name": "Update user contact extension",
        "description": "Tool to update an open extension on a contact in a user's contact folder. Use when you need to modify custom properties stored in a contact extension for a specific user."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_CONTACTS_EXTENSIONS",
        "name": "Update user contact extension",
        "description": "Tool to update an open extension on a contact in a user's contact folder. Use when you need to modify custom properties stored in a contact extension for a specific user."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_CONTACTS_EXTENSIONS_DIRECT",
        "name": "Update user contact extension (v3)",
        "description": "Tool to update an open extension on a contact directly under a user's contacts collection. Use when you need to modify custom properties stored in a contact extension."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_EVENT_EXTENSION",
        "name": "Update user event extension",
        "description": "Deprecated: Use OUTLOOK_UPDATE_EVENT_EXTENSION_IN_CALENDAR_GROUP instead, which supports both /me and /users/{user_id} endpoints and uses the correct @odata.type prefix."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_EVENTS_EXTENSIONS",
        "name": "Update user events extensions",
        "description": "Tool to update an open extension on a user's calendar event. Use when modifying custom properties stored in an event extension for a specific user."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_INFERENCE_CLASSIFICATION_OVERRIDE",
        "name": "Update User Inference Classification Override",
        "description": "Tool to update the classification of messages from a specific sender in a user's Focused Inbox. Use when you need to change whether messages from a sender go to Focused or Other inbox for a specific user."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_MAIL_FOLDER_MESSAGE",
        "name": "Update user mail folder message",
        "description": "Tool to update properties of a message in a specific mail folder for a user. Use when you need to modify message attributes like categories, read status, importance, or other properties for a message within a particular user's folder."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_MAIL_FOLDER_MESSAGE_EXTENSION",
        "name": "Update user message extension",
        "description": "Tool to update an open extension on a message within a specific user's mail folder. Use when you need to modify custom properties stored in a message extension for a specific user."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_MAIL_FOLDER_MESSAGE_RULE",
        "name": "Update user mail folder message rule",
        "description": "Tool to update a message rule in a user's mail folder. Use when you need to modify an existing rule's properties, conditions, actions, or exceptions for a specific user."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_MAIL_FOLDERS_CHILD_FOLDERS",
        "name": "Update user mail folder child folder",
        "description": "Tool to update a child folder within a mail folder for a specific user. Use when you need to rename a child mail folder."
      },
      {
        "slug": "OUTLOOK_UPDATE_USER_MESSAGE_EXTENSION",
        "name": "Update user message extension",
        "description": "Tool to update an open extension on a user's message. Use when you need to modify custom properties stored in a message extension for a specific user."
      }
    ],
    "triggers": [
      {
        "slug": "OUTLOOK_CONTACT_TRIGGER",
        "name": "New Contact Added",
        "description": "Triggered when a new contact is added in the Outlook contacts."
      },
      {
        "slug": "OUTLOOK_EVENT_CHANGE_TRIGGER",
        "name": "Calendar Event Changes",
        "description": "Triggered when a new calendar event occurs (created, updated, or deleted) in the Outlook calendar."
      },
      {
        "slug": "OUTLOOK_EVENT_TRIGGER",
        "name": "New Calendar Event",
        "description": "Triggered when a new calendar event is created in the Outlook calendar."
      },
      {
        "slug": "OUTLOOK_MESSAGE_TRIGGER",
        "name": "New Outlook Message",
        "description": "Triggered when a new message is received in the Outlook mailbox.\n\nWatches the Inbox by default. Set `folder_id` to watch a different mail\nfolder, and `from_email`, `to_email`, `subject_contains` or\n`has_attachments` to fire only for the messages you care about."
      },
      {
        "slug": "OUTLOOK_SENT_MESSAGE_TRIGGER",
        "name": "New Sent Message",
        "description": "Triggered when a new message is sent from the Outlook mailbox.\n\nWatches Sent Items by default. Set `folder_id` to watch a different mail\nfolder, and `from_email`, `to_email`, `subject_contains` or\n`has_attachments` to fire only for the messages you care about."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "outlook_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "Calendars.Read,Calendars.ReadWrite,Calendars.ReadWrite.Shared,Contacts.ReadWrite,Chat.ReadWrite,Mail.Read,Mail.ReadWrite,Mail.Send,MailboxSettings.Read,MailboxSettings.ReadWrite,offline_access,User.Read"
              },
              {
                "name": "microsoft_cloud",
                "displayName": "Microsoft cloud environment",
                "type": "string",
                "description": "Microsoft cloud containing the Entra app registration. Use \"global\" for commercial Microsoft 365 or \"gcc_high\" for Microsoft 365 US Government GCC High.",
                "required": false,
                "default": "global"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": [
              {
                "name": "issuer",
                "displayName": "Microsoft Tenant ID",
                "type": "string",
                "description": "Optional Microsoft Entra tenant alias, tenant ID, or tenant domain used to target a specific tenant instead of /common.",
                "required": false,
                "default": "common"
              }
            ]
          }
        }
      },
      {
        "mode": "S2S_OAUTH2",
        "name": "outlook_s2s_oauth2",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client ID",
                "type": "string",
                "description": "Application (client) ID from your Microsoft Entra app registration. Found in Azure Portal > App registrations > your app > Overview.",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client Secret",
                "type": "string",
                "description": "Client secret value from your Microsoft Entra app registration. Found in Azure Portal > App registrations > your app > Certificates & Secrets > Client secrets.",
                "required": true,
                "default": null
              },
              {
                "name": "generic_id",
                "displayName": "Tenant ID",
                "type": "string",
                "description": "Your Microsoft Entra (Azure AD) tenant ID in GUID format (e.g. \"a6a55c5f-0747-4804-a166-2b5dfc9ace2a\"). Found in Azure Portal > Microsoft Entra ID > Overview > Tenant ID.",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "microsoft_cloud",
                "displayName": "Microsoft cloud environment",
                "type": "string",
                "description": "Microsoft cloud containing the Entra app registration. Use \"global\" for commercial Microsoft 365 or \"gcc_high\" for Microsoft 365 US Government GCC High.",
                "required": false,
                "default": "global"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "perplexityai",
    "name": "Perplexity AI",
    "logo": "https://logos.composio.dev/api/perplexityai",
    "description": "Perplexity AI provides conversational AI models for generating human-like text responses",
    "category": "artificial intelligence",
    "authSchemes": [
      "API_KEY"
    ],
    "toolCount": 9,
    "triggerCount": 0,
    "version": "20260615_00",
    "tools": [
      {
        "slug": "PERPLEXITYAI_CREATE_ASYNC_CHAT_COMPLETION",
        "name": "Create Async Chat Completion",
        "description": "Create Async Chat Completion (POST /v1/async/sonar). Submits an asynchronous chat completion request for long-running tasks. Returns immediately with a request ID that can be polled using the Get Async Chat Completion action. Only the 'sonar-deep-research' model is supported for async processing. Async jobs have a 7-day TTL. Deep research generates very long responses (10K-100K+ words) with exhaustive multi-source analysis. Use the idempotency_key to prevent duplicate submissions. Poll with Get Async Chat Completion using the returned request ID to retrieve results when status is COMPLETED."
      },
      {
        "slug": "PERPLEXITYAI_CREATE_CHAT_COMPLETION",
        "name": "Create Chat Completion",
        "description": "Perplexity Sonar Chat Completions (POST /v1/sonar). Generates web-grounded conversational AI responses with citations. Supports multiple Sonar models optimized for different use cases: - sonar: Fast, cost-effective for simple queries - sonar-pro: Enhanced quality for complex questions - sonar-reasoning-pro: Chain-of-thought reasoning with <think> blocks - sonar-deep-research: Exhaustive multi-source research (generates very long responses, 10K+ words; prefer the async endpoint for this model) Features: web search grounding, citations, images, structured JSON output, search filtering by domain/date/language/recency, and streaming. Important constraints: - search_recency_filter and date filters (search_after_date_filter, search_before_date_filter, etc.) are mutually exclusive. Use one or the other, not both. - Messages with the 'tool' role must alternate with 'assistant' messages. A valid pattern is: system -> user -> assistant -> tool -> user. - The 'stop' parameter is not currently supported by the API."
      },
      {
        "slug": "PERPLEXITYAI_CREATE_CONTEXTUALIZED_EMBEDDINGS",
        "name": "Create Contextualized Embeddings",
        "description": "Create Contextualized Embeddings (POST /v1/contextualizedembeddings). Generates document-aware embeddings where chunks from the same document share context. Unlike standard embeddings, these recognize sequential relationships within documents, improving retrieval quality. Models: pplx-embed-context-v1-0.6b (1024 dims) and pplx-embed-context-v1-4b (2560 dims). Both support Matryoshka dimension reduction and INT8/binary quantization."
      },
      {
        "slug": "PERPLEXITYAI_CREATE_EMBEDDINGS",
        "name": "CreateEmbeddings",
        "description": "Generate vector embeddings for independent texts (queries, sentences, documents). This action takes one or more input texts and generates vector embeddings using Perplexity AI's embedding models. Embeddings are useful for semantic search, similarity matching, and machine learning downstream tasks. Supported models: - pplx-embed-v1-0.6b: Smaller, faster model (1024 dimensions) - pplx-embed-v1-4b: Larger, more accurate model (2560 dimensions) The output embeddings are base64-encoded for efficient transmission. Use the dimensions parameter to reduce embedding size for faster processing when full precision is not required (Matryoshka representation)."
      },
      {
        "slug": "PERPLEXITYAI_EXECUTE_AGENT",
        "name": "Execute Agent",
        "description": "Create Agent Response (POST /v1/agent). Orchestrates multi-step agentic workflows with built-in tools (web search, URL fetching, function calling), reasoning, and multi-model support. Streaming is not supported by this action. At least one of 'model', 'models', or 'preset' must be provided. Available presets: 'fast-search', 'pro-search', 'deep-research'. The 'deep-research' preset generates very long responses (10K-100K+ words) with exhaustive multi-source analysis. Available models include Perplexity Sonar, OpenAI, Anthropic, Google, xAI, and NVIDIA models at direct provider rates. Use the List Models action to see available model identifiers."
      },
      {
        "slug": "PERPLEXITYAI_GET_ASYNC_CHAT_COMPLETION",
        "name": "Get Async Chat Completion",
        "description": "Get Async Chat Completion (GET /v1/async/sonar/{id}). Retrieves the result of an asynchronous chat completion request by its ID. Use this to poll for the result after creating an async job. The response includes the status and, when completed, the full completion."
      },
      {
        "slug": "PERPLEXITYAI_LIST_ASYNC_CHAT_COMPLETIONS",
        "name": "List Async Chat Completions",
        "description": "List Async Chat Completions (GET /v1/async/sonar). Retrieves a list of all asynchronous chat completion requests for the authenticated user. Use this to see the status of all your pending, completed, and failed async jobs."
      },
      {
        "slug": "PERPLEXITYAI_LIST_MODELS",
        "name": "List Models",
        "description": "List Models (GET /v1/models). Lists models available for the Agent API. Returns model identifiers that can be used with the Agent endpoint. The response follows the OpenAI List Models format for compatibility. This is a public endpoint that does not require authentication."
      },
      {
        "slug": "PERPLEXITYAI_SEARCH",
        "name": "Perplexity Search (Raw Results)",
        "description": "Search the Web (POST /search). Returns raw, ranked web search results directly from Perplexity's index without LLM processing. Faster and cheaper than chat completions when you need raw results. Supports filtering by domain, date, language, country, and recency. Max 20 results per request. Important: search_recency_filter and date filters (search_after_date_filter, search_before_date_filter, last_updated_after_filter, last_updated_before_filter) are mutually exclusive. Use one or the other, not both."
      }
    ],
    "triggers": [],
    "authConfigDetails": [
      {
        "mode": "API_KEY",
        "name": "pplx_scheme",
        "fields": {
          "auth_config_creation": {
            "required": [],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "generic_api_key",
                "displayName": "API Key",
                "type": "string",
                "description": "Your secret Perplexity API key, starting with 'pplx-'. Create one at console.perplexity.ai under API Keys — it's shown only once, so copy it immediately.",
                "required": true,
                "default": null
              }
            ],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "twitter",
    "name": "Twitter",
    "logo": "https://logos.composio.dev/api/twitter",
    "description": "Twitter, Inc. was an American social media company based in San Francisco, California, which operated and was named for named for its flagship social media network prior to its rebrand as X.",
    "category": "social media accounts",
    "authSchemes": [
      "OAUTH2"
    ],
    "toolCount": 79,
    "triggerCount": 0,
    "version": "20260812_00",
    "tools": [
      {
        "slug": "TWITTER_ADD_LIST_MEMBER",
        "name": "Add a list member",
        "description": "Adds a user to a specified Twitter List; the list must be owned by the authenticated user."
      },
      {
        "slug": "TWITTER_ADD_POST_TO_BOOKMARKS",
        "name": "Add post to bookmarks",
        "description": "Adds a specified, existing, and accessible Tweet to a user's bookmarks, with success indicated by the 'bookmarked' field in the response."
      },
      {
        "slug": "TWITTER_APPEND_MEDIA_UPLOAD",
        "name": "Append Media Upload",
        "description": "Append data chunk to an ongoing media upload session on X/Twitter. Use this action during chunked media uploads to append each segment of media data in sequence."
      },
      {
        "slug": "TWITTER_BOOKMARKS_BY_USER",
        "name": "Get bookmarks by user",
        "description": "Retrieves Tweets bookmarked by the authenticated user, where the provided User ID must match the authenticated user's ID."
      },
      {
        "slug": "TWITTER_CREATE_ACTIVITY_SUBSCRIPTION",
        "name": "Create activity subscription",
        "description": "Tool to create a subscription for an X activity event. Use when you need to monitor specific user activities like profile updates, follows, or spaces events."
      },
      {
        "slug": "TWITTER_CREATE_COMPLIANCE_JOB",
        "name": "Create compliance job",
        "description": "Creates a new compliance job to check the status of Tweet or user IDs; upload IDs as a plain text file (one ID per line) to the `upload_url` received in the response."
      },
      {
        "slug": "TWITTER_CREATE_DM_CONVERSATION",
        "name": "Create group DM conversation",
        "description": "Creates a new group Direct Message (DM) conversation on Twitter. REQUIRED PARAMETERS: - conversation_type: Must be 'Group' - participant_ids: List of Twitter user IDs to include in the conversation - message: JSON object with the initial message. Must contain 'text' field. To include media attachments, use message.attachments array with media_id (NOT media_url): {\"text\": \"...\", \"attachments\": [{\"media_id\": \"1234567890\"}]} Note: Media must be uploaded first using the upload_media action to obtain a media_id."
      },
      {
        "slug": "TWITTER_CREATE_LIST",
        "name": "Create a list",
        "description": "Creates a new, empty List on X (formerly Twitter), for which the provided name must be unique for the authenticated user; accounts are added separately."
      },
      {
        "slug": "TWITTER_CREATION_OF_A_POST",
        "name": "Create a post",
        "description": "Creates a Tweet on Twitter; `text` is required unless `card_uri`, `media_media_ids`, `poll_options`, or `quote_tweet_id` is provided. Example - Creating a tweet with media and location: { \"text\": \"Check out our latest product update! 🚀\", \"media_media_ids\": [\"1455952740635586573\"], \"geo_place_id\": \"df51dec6f4ee2b2c\" } Example - Quote tweet with commentary: { \"text\": \"This is a game-changer for the industry! Here's why... 🧵\", \"quote_tweet_id\": \"1453828617121234945\" } Example - Reply to a tweet: { \"text\": \"Great point! Here's my take on this...\", \"reply_in_reply_to_tweet_id\": \"1453828617121234945\" }"
      },
      {
        "slug": "TWITTER_DELETE_DM",
        "name": "Delete direct message",
        "description": "Permanently deletes a specific Twitter Direct Message (DM) event using its `event_id` if the authenticated user sent it; this action is irreversible and does not delete entire conversations."
      },
      {
        "slug": "TWITTER_DELETE_LIST",
        "name": "Delete list",
        "description": "Permanently deletes a specified Twitter List using its ID, which must be owned by the authenticated user; this action is irreversible and the list must already exist."
      },
      {
        "slug": "TWITTER_FOLLOWERS_BY_USER_ID",
        "name": "Get followers by user id",
        "description": "Retrieves a list of users who follow a specified public Twitter user ID."
      },
      {
        "slug": "TWITTER_FOLLOWING_BY_USER_ID",
        "name": "Get following by user ID",
        "description": "Retrieves users followed by a specific Twitter user, allowing pagination and customization of returned user and tweet data fields via expansions."
      },
      {
        "slug": "TWITTER_FOLLOW_LIST",
        "name": "Follow a list",
        "description": "Allows the authenticated user (`id`) to follow a specific Twitter List (`list_id`) they are permitted to access, subscribing them to the list's timeline; this does not automatically follow individual list members."
      },
      {
        "slug": "TWITTER_FOLLOW_USER",
        "name": "Follow a user",
        "description": "Allows an authenticated user (path `id`) to follow another user (`target_user_id`), which results in a pending request if the target user's tweets are protected."
      },
      {
        "slug": "TWITTER_FULL_ARCHIVE_SEARCH",
        "name": "Search full archive of tweets",
        "description": "Searches the full archive of public Tweets from March 2006 onwards; use 'start_time' and 'end_time' together for a defined time window."
      },
      {
        "slug": "TWITTER_GET_BLOCKED_USERS",
        "name": "Get users blocked by user ID",
        "description": "Retrieves the authenticated user's own block list. IMPORTANT: You can only retrieve YOUR OWN block list - the `id` parameter must be the authenticated user's ID. Use the 'Get authenticated user' action first to obtain your user ID."
      },
      {
        "slug": "TWITTER_GET_COMPLIANCE_JOB",
        "name": "Retrieve compliance job by id",
        "description": "Retrieves status, download/upload URLs, and other details for an existing Twitter compliance job specified by its unique ID."
      },
      {
        "slug": "TWITTER_GET_COMPLIANCE_JOBS",
        "name": "Retrieve compliance jobs",
        "description": "Returns a list of recent compliance jobs, filtered by type (tweets or users) and optionally by status."
      },
      {
        "slug": "TWITTER_GET_DM_CONVERSATION_EVENTS",
        "name": "Get DM events for a DM conversation",
        "description": "Fetches Direct Message (DM) events for a one-on-one conversation with a specified participant ID, ordered chronologically newest to oldest; does not support group DMs."
      },
      {
        "slug": "TWITTER_GET_DM_EVENT",
        "name": "Get DM events by ID",
        "description": "Fetches a specific Direct Message (DM) event by its unique ID, allowing optional expansion of related data like users or tweets; ensure the `event_id` refers to an existing DM event accessible to the authenticated user."
      },
      {
        "slug": "TWITTER_GET_LIST",
        "name": "Lookup list by ID",
        "description": "Returns metadata for a specific Twitter List, identified by its ID; does not return list members but can expand the owner's User object via the `expansions` parameter."
      },
      {
        "slug": "TWITTER_GET_LIST_FOLLOWERS",
        "name": "Get list followers",
        "description": "Fetches a list of users who follow a specific Twitter List, identified by its ID; ensure the authenticated user has access if the list is private."
      },
      {
        "slug": "TWITTER_GET_LIST_MEMBERS",
        "name": "Fetch list members by id",
        "description": "Fetches members of a specific Twitter List, identified by its unique ID."
      },
      {
        "slug": "TWITTER_GET_MEDIA_UPLOAD_STATUS",
        "name": "Get Media Upload Status",
        "description": "Get the processing status of uploaded media (videos/GIFs) on X/Twitter. Only call this when the FINALIZE command returned a processing_info field. Poll every 3–5 seconds with a 60–120 second maximum timeout to avoid HTTP 429 errors. Response state cycles through 'pending', 'in_progress', 'succeeded', and 'failed'. Only attach media_id to a tweet when state is 'succeeded'. State 'failed' is terminal — requires a completely new upload via TWITTER_UPLOAD_MEDIA or TWITTER_UPLOAD_LARGE_MEDIA. Video/GIF processing takes 30–120 seconds; posting before 'succeeded' results in non-playable media."
      },
      {
        "slug": "TWITTER_GET_MUTED_USERS",
        "name": "Get muted users",
        "description": "Returns user objects muted by the X user identified by the `id` path parameter."
      },
      {
        "slug": "TWITTER_GET_OPENAPI_SPEC",
        "name": "Fetch OpenAPI specification",
        "description": "Fetches the OpenAPI specification (JSON) for Twitter's API v2, used to programmatically understand the API's structure for developing client libraries or tools."
      },
      {
        "slug": "TWITTER_GET_POST_ANALYTICS",
        "name": "Get Post analytics",
        "description": "Tool to retrieve analytics data for specified Posts within a defined time range. Use when you need engagement metrics, impressions, or other analytics for one or more Posts. Requires OAuth 2.0 with tweet.read and users.read scopes. Requires an X Enterprise API plan. Accounts on Free, Basic, Pro, or Pay-Per-Use tiers will receive a 403 Forbidden on every call, regardless of scopes or request correctness - this is not something a connected account's OAuth grant can unlock."
      },
      {
        "slug": "TWITTER_GET_POST_RETWEETERS_ACTION",
        "name": "Get post retweeters",
        "description": "Retrieves users who publicly retweeted a specified public Post ID, excluding Quote Tweets and retweets from private accounts."
      },
      {
        "slug": "TWITTER_GET_POST_RETWEETS",
        "name": "Retrieve retweets of a post",
        "description": "Retrieves Tweets that Retweeted a specified public or authenticated-user-accessible Tweet ID, optionally customizing the response with fields and expansions."
      },
      {
        "slug": "TWITTER_GET_POST_USAGE",
        "name": "Fetch tweet usage data",
        "description": "Fetches Tweet usage statistics for a Project (e.g., consumption, caps, daily breakdowns for Project & Client Apps) to monitor API limits; data can be retrieved for 1 to 90 days."
      },
      {
        "slug": "TWITTER_GET_RECENT_DM_EVENTS",
        "name": "Get recent direct message events",
        "description": "Returns recent Direct Message events for the authenticated user, such as new messages or changes in conversation participants."
      },
      {
        "slug": "TWITTER_GET_SPACE_BY_ID",
        "name": "Look up space by ID",
        "description": "Retrieves details for a Twitter Space by its ID, allowing for customization and expansion of related data, provided the Space ID is valid and accessible."
      },
      {
        "slug": "TWITTER_GET_SPACE_POSTS",
        "name": "Retrieve posts from a space",
        "description": "Retrieves Tweets that were shared/posted during a Twitter Space broadcast. IMPORTANT: This endpoint returns Tweets that participants explicitly shared during the Space session, NOT audio transcripts, comments, or reactions. Most Spaces have zero associated Tweets, so empty results (result_count=0) are normal and expected. Twitter Spaces are primarily audio conversations - this endpoint only returns text Tweets that were shared alongside the audio."
      },
      {
        "slug": "TWITTER_GET_SPACES_BY_CREATORS",
        "name": "Get spaces by creator IDs",
        "description": "Retrieves Twitter Spaces created by a list of specified User IDs, with options to customize returned data fields."
      },
      {
        "slug": "TWITTER_GET_SPACES_BY_IDS",
        "name": "Get space information by IDs",
        "description": "Fetches detailed information for one or more Twitter Spaces (live, scheduled, or ended) by their unique IDs; at least one Space ID must be provided."
      },
      {
        "slug": "TWITTER_GET_SPACE_TICKET_BUYERS",
        "name": "Fetch space ticket buyers list",
        "description": "Retrieves a list of users who purchased tickets for a specific, valid, and ticketed Twitter Space."
      },
      {
        "slug": "TWITTER_GET_USER_BY_ID",
        "name": "Look up user by ID",
        "description": "Retrieves detailed public information for a Twitter user by their ID, optionally expanding related data (e.g., pinned tweets) and specifying particular user or tweet fields to return."
      },
      {
        "slug": "TWITTER_GET_USER_FOLLOWED_LISTS",
        "name": "Get user's followed lists",
        "description": "Returns metadata (not Tweets) for lists a specific Twitter user follows, optionally including expanded owner details."
      },
      {
        "slug": "TWITTER_GET_USER_LIST_MEMBERSHIPS",
        "name": "Get a user's list memberships",
        "description": "Retrieves all Twitter Lists a specified user is a member of, including public Lists and private Lists the authenticated user is authorized to view."
      },
      {
        "slug": "TWITTER_GET_USER_OWNED_LISTS",
        "name": "Get a user's owned lists",
        "description": "Call this action to retrieve Lists created (owned) by a specific Twitter user, not Lists they follow or are subscribed to."
      },
      {
        "slug": "TWITTER_GET_USER_PINNED_LISTS",
        "name": "Get a user's pinned lists",
        "description": "Retrieves the Lists a specific, existing Twitter user has pinned to their profile to highlight them."
      },
      {
        "slug": "TWITTER_GET_USERS_BY_IDS",
        "name": "Look up users by IDs",
        "description": "Retrieves detailed information for specified X (formerly Twitter) user IDs, optionally customizing returned fields and expanding related entities."
      },
      {
        "slug": "TWITTER_HIDE_REPLIES",
        "name": "Set reply visibility",
        "description": "Hides or unhides an existing reply Tweet. This action allows the authenticated user to hide or unhide a reply to a conversation they own (started). You can only hide replies to posts you authored. Note: Requires the tweet.moderate.write OAuth scope."
      },
      {
        "slug": "TWITTER_INITIALIZE_MEDIA_UPLOAD",
        "name": "Initialize Media Upload",
        "description": "Initialize a media upload session for X/Twitter. Use this to start a chunked media upload process, which returns a media_id for subsequent APPEND and FINALIZE commands. Required for uploading large files or when using the chunked upload workflow."
      },
      {
        "slug": "TWITTER_LIST_POST_LIKERS",
        "name": "List post likers",
        "description": "Retrieves users who have liked the Post (Tweet) identified by the provided ID."
      },
      {
        "slug": "TWITTER_LIST_POSTS_TIMELINE_BY_LIST_ID",
        "name": "List posts timeline by list ID",
        "description": "Fetches the most recent Tweets posted by members of a specified Twitter List."
      },
      {
        "slug": "TWITTER_MUTE_USER",
        "name": "Mute user by ID",
        "description": "Mutes a target user on behalf of an authenticated user, preventing the target's Tweets and Retweets from appearing in the authenticated user's home timeline without notifying the target."
      },
      {
        "slug": "TWITTER_PIN_LIST",
        "name": "Pin a list",
        "description": "Pins a specified List to the authenticated user's profile, provided the List exists, the user has access rights, and the pin limit (typically 5 Lists) is not exceeded."
      },
      {
        "slug": "TWITTER_POST_DELETE_BY_POST_ID",
        "name": "Delete tweet",
        "description": "Irreversibly deletes a specific Tweet by its ID; the Tweet may persist in third-party caches after deletion."
      },
      {
        "slug": "TWITTER_POST_LOOKUP_BY_POST_ID",
        "name": "Look up post by id",
        "description": "Fetches comprehensive details for a single Tweet by its unique ID, provided the Tweet exists and is accessible."
      },
      {
        "slug": "TWITTER_POST_LOOKUP_BY_POST_IDS",
        "name": "Get tweets by IDs",
        "description": "Retrieves detailed information for one or more Posts (Tweets) identified by their unique IDs, allowing selection of specific fields and expansions."
      },
      {
        "slug": "TWITTER_RECENT_SEARCH",
        "name": "Search recent tweets",
        "description": "Searches Tweets from the last 7 days matching a query (using X's search syntax), ideal for real-time analysis, trend monitoring, or retrieving posts from specific users (e.g., `from:username`) DEFAULT FIELDS: Tweet objects always return 'id' and 'text' by default. User objects always return 'id', 'name', and 'username' by default when expanded. Do not request these default fields in field parameters. IMPORTANT LIMITATION - Impression Counts: The public_metrics.impression_count field returns 0 for search results from other users. Impression data is a non-public metric only available for tweets owned by the authenticated user. To filter by engagement, use retweet_count, like_count, or quote_count instead. Example - Get original tweets from Elon Musk since Sept 20, 2025: { \"query\": \"from:elonmusk -is:retweet -is:reply\", \"start_time\": \"2025-09-20T00:00:00Z\", \"max_results\": 50, \"tweet_fields\": [\"created_at\",\"public_metrics\",\"text\"], \"expansions\": [\"author_id\",\"attachments.media_keys\",\"referenced_tweets.id\"] }"
      },
      {
        "slug": "TWITTER_REMOVE_LIST_MEMBER",
        "name": "Remove a list member",
        "description": "Removes a user from a Twitter List; the response `is_member` field will be `false` if removal was successful or the user was not a member, and the updated list of members is not returned."
      },
      {
        "slug": "TWITTER_REMOVE_POST_FROM_BOOKMARKS",
        "name": "Remove a bookmarked post",
        "description": "Removes a Tweet, specified by `tweet_id`, from the authenticated user's bookmarks; the Tweet must have been previously bookmarked by the user for the action to have an effect."
      },
      {
        "slug": "TWITTER_RETRIEVE_DM_CONVERSATION_EVENTS",
        "name": "Retrieve DM conversation events",
        "description": "Retrieves Direct Message (DM) events for a specific conversation ID on Twitter, useful for analyzing messages and participant activities."
      },
      {
        "slug": "TWITTER_RETRIEVE_POSTS_THAT_QUOTE_A_POST",
        "name": "Retrieve posts that quote a post",
        "description": "Retrieves Tweets that quote a specified Tweet, requiring a valid Tweet ID."
      },
      {
        "slug": "TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_ID",
        "name": "Retrieve liked tweets by user ID",
        "description": "Retrieves Tweets liked by a specified Twitter user, provided their liked tweets are public or accessible."
      },
      {
        "slug": "TWITTER_RETWEET_POST",
        "name": "Retweet post",
        "description": "Retweets a Tweet for the authenticated user. The user ID is automatically fetched from the authenticated session - you only need to provide the tweet_id to retweet."
      },
      {
        "slug": "TWITTER_SEARCH_FULL_ARCHIVE_COUNTS",
        "name": "Get full archive search counts",
        "description": "Returns a count of Tweets from the full archive that match a specified query, aggregated by day, hour, or minute; `start_time` must be before `end_time` if both are provided, and `since_id`/`until_id` cannot be used with `start_time`/`end_time`."
      },
      {
        "slug": "TWITTER_SEARCH_RECENT_COUNTS",
        "name": "Fetch recent tweet counts",
        "description": "Retrieves the count of Tweets matching a specified search query within the last 7 days, aggregated by 'minute', 'hour', or 'day'."
      },
      {
        "slug": "TWITTER_SEARCH_SPACES",
        "name": "Search for spaces",
        "description": "Searches for Twitter Spaces by a textual query, optionally filtering by state (live, scheduled, all) to discover audio conversations."
      },
      {
        "slug": "TWITTER_SEND_A_NEW_MESSAGE_TO_A_USER",
        "name": "Send a new message to a user",
        "description": "Sends a new Direct Message with text and/or media (media_id for attachments must be pre-uploaded) to a specified Twitter user; this creates a new DM and does not modify existing messages."
      },
      {
        "slug": "TWITTER_SEND_DM_TO_CONVERSATION",
        "name": "Send a new message to a DM conversation",
        "description": "Sends a message, with optional text and/or media attachments (using pre-uploaded `media_id`s), to a specified Twitter Direct Message conversation."
      },
      {
        "slug": "TWITTER_STREAM_POST_LABELS",
        "name": "Get tweets label stream",
        "description": "Stream real-time Tweet label events (apply/remove). Requires Enterprise access and App-Only OAuth 2.0 auth. Returns PublicTweetNotice or PublicTweetUnviewable events. 403 errors indicate missing Enterprise access or wrong auth type."
      },
      {
        "slug": "TWITTER_UNFOLLOW_LIST",
        "name": "Unfollow a list",
        "description": "Enables a user (via `id`) to unfollow a specific Twitter List (via `list_id`), which removes its tweets from their timeline and stops related notifications; the action reports `following: false` on success, even if the user was not initially following the list."
      },
      {
        "slug": "TWITTER_UNFOLLOW_USER",
        "name": "Unfollow user",
        "description": "Allows the authenticated user to unfollow an existing Twitter user (`target_user_id`), which removes the follow relationship. The source user ID is automatically determined from the authenticated session."
      },
      {
        "slug": "TWITTER_UNLIKE_POST",
        "name": "Unlike post",
        "description": "Allows an authenticated user (`id`) to remove their like from a specific post (`tweet_id`); the action is idempotent and completes successfully even if the post was not liked."
      },
      {
        "slug": "TWITTER_UNMUTE_USER",
        "name": "Unmute a user by user ID",
        "description": "Unmutes a target user for the authenticated user, allowing them to see Tweets and notifications from the target user again. The source_user_id is automatically populated from the authenticated user's credentials."
      },
      {
        "slug": "TWITTER_UNPIN_LIST",
        "name": "Unpin a list",
        "description": "Unpins a List (specified by list_id) from the authenticated user's profile. The user ID is automatically retrieved if not provided."
      },
      {
        "slug": "TWITTER_UNRETWEET_POST",
        "name": "Unretweet post",
        "description": "Removes a user's retweet of a specified Post, if the user had previously retweeted it."
      },
      {
        "slug": "TWITTER_UPDATE_LIST",
        "name": "Update list attributes",
        "description": "Updates an existing Twitter List's name, description, or privacy status, requiring the List ID and at least one mutable property."
      },
      {
        "slug": "TWITTER_UPLOAD_LARGE_MEDIA",
        "name": "Upload Large Media",
        "description": "Use this to upload a single media file to X/Twitter. Automatically uses chunked upload for GIFs, videos, and images larger than 5 MB. Max file size: 512 MB; max video duration: 140 seconds. After upload, poll TWITTER_GET_MEDIA_UPLOAD_STATUS until processing_info.state=='succeeded' before attaching the media_id to a tweet — GIFs and videos take 30–120 seconds to process. A terminal 'failed' state means the media_id is unusable and the file must be re-uploaded. For small images (<5MB, no GIF/video), TWITTER_UPLOAD_MEDIA is simpler. For GIFs, videos, or files over 5MB, this action is currently the only working option - TWITTER_UPLOAD_MEDIA explicitly rejects those file types, so it is not a full replacement for this action's primary use case, despite what an earlier deprecation notice here claimed."
      },
      {
        "slug": "TWITTER_UPLOAD_MEDIA",
        "name": "Upload Media",
        "description": "Upload media (images only) to X/Twitter using the v2 API. Supports tweet_image, dm_image, and subtitles media categories only. One file per call; the returned media_id expires (see expires_after_secs in response), so upload immediately before creating the tweet. For GIFs, videos, or any file larger than ~5 MB, use TWITTER_UPLOAD_LARGE_MEDIA instead."
      },
      {
        "slug": "TWITTER_USER_HOME_TIMELINE_BY_USER_ID",
        "name": "Get user reverse chronological timeline",
        "description": "Retrieves the home timeline (reverse chronological feed) for the authenticated Twitter user. Returns tweets from accounts the user follows as well as the user's own tweets, in reverse chronological order. Useful for displaying the personalized feed without algorithmic sorting. CRITICAL: The 'id' parameter MUST be the authenticated user's own numeric Twitter user ID - use TWITTER_USER_LOOKUP_ME to get your ID first. This endpoint cannot fetch another user's home timeline, and passing any ID that doesn't match the authenticating user (including phone numbers or other user IDs) will result in an error. DEFAULT FIELDS: Tweet objects always return 'id' and 'text' by default. User objects always return 'id', 'name', and 'username' by default when expanded. Do not request these default fields in field parameters."
      },
      {
        "slug": "TWITTER_USER_LIKE_POST",
        "name": "Like a tweet",
        "description": "Allows the authenticated user to like a specific, accessible Tweet, provided neither user has blocked the other and the authenticated user is not restricted from liking. The authenticated user's ID is automatically determined from the OAuth token - you only need to provide the tweet_id."
      },
      {
        "slug": "TWITTER_USER_LOOKUP_BY_USERNAME",
        "name": "Look up user by username",
        "description": "Fetches public profile information for a valid and existing Twitter user by their username, optionally expanding related data like pinned Tweets; results may be limited for protected profiles not followed by the authenticated user."
      },
      {
        "slug": "TWITTER_USER_LOOKUP_BY_USERNAMES",
        "name": "Look up users by username",
        "description": "Retrieves detailed information for 1 to 100 Twitter users by their usernames (each 1-15 alphanumeric characters/underscores), allowing customizable user/tweet fields and expansion of related data like pinned tweets."
      },
      {
        "slug": "TWITTER_USER_LOOKUP_ME",
        "name": "Get authenticated user",
        "description": "Returns profile information for the currently authenticated X user, customizable via request fields."
      }
    ],
    "triggers": [],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "twitter_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              },
              {
                "name": "generic_id",
                "displayName": "Application Bearer Token",
                "type": "string",
                "description": "Bearer Token from your X Developer App (same App as the OAuth Client ID/Secret). Required for app-only actions: TWITTER_RECENT_SEARCH, TWITTER_RECENT_SEARCH_COUNTS, TWITTER_FULL_ARCHIVE_SEARCH, TWITTER_FULL_ARCHIVE_SEARCH_COUNTS, TWITTER_POST_LOOKUP_BY_POST_IDS, TWITTER_POST_USAGE, TWITTER_POSTS_LABEL_STREAM, TWITTER_CREATE_COMPLIANCE_JOB_REQUEST, TWITTER_RETRIEVE_COMPLIANCE_JOBS, TWITTER_RETRIEVE_COMPLIANCE_JOB_BY_ID.",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "dm.write,dm.read,mute.read,mute.write,space.read,tweet.write,tweet.read,tweet.moderate.write,users.read,follows.read,follows.write,like.read,like.write,list.read,list.write,block.read,block.write,bookmark.read,bookmark.write,media.write,offline.access"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "googledrive",
    "name": "Google Drive",
    "logo": "https://logos.composio.dev/api/googledrive",
    "description": "Google Drive is a cloud storage solution for uploading, sharing, and collaborating on files across devices, with robust search and offline access",
    "category": "file management & storage",
    "authSchemes": [
      "OAUTH2"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 90,
    "triggerCount": 7,
    "version": "20260902_00",
    "tools": [
      {
        "slug": "GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE",
        "name": "Add file sharing preference (Deprecated)",
        "description": "DEPRECATED: Use GOOGLEDRIVE_CREATE_PERMISSION instead; use GOOGLEDRIVE_UPDATE_PERMISSION to modify existing permissions (avoids duplicate entries). Modifies sharing permissions for an existing Google Drive file, granting a specified role to a user, group, domain, or 'anyone'. Bulk calls may trigger 403 rateLimitExceeded (~100 req/100s/user); use jittered exponential backoff."
      },
      {
        "slug": "GOOGLEDRIVE_ADD_PARENT",
        "name": "Insert File Parent (v2)",
        "description": "Tool to add a parent folder for a file using Google Drive API v2. Use when you need to add a file to an additional folder."
      },
      {
        "slug": "GOOGLEDRIVE_ADD_PROPERTY",
        "name": "Insert Property (v2 API)",
        "description": "Tool to add a property to a file, or update it if it already exists (v2 API). Use when you need to attach custom key-value metadata to a Google Drive file."
      },
      {
        "slug": "GOOGLEDRIVE_COPY_FILE",
        "name": "Copy file (Deprecated)",
        "description": "DEPRECATED: Use GOOGLEDRIVE_COPY_FILE_ADVANCED instead. Duplicates an existing file (not folders) in Google Drive by `file_id`; copy lands in same folder as original — use GOOGLEDRIVE_MOVE_FILE afterward for precise placement. Copy receives a new `file_id`; update stored references accordingly. For shared drives, requires organizer/manager rights."
      },
      {
        "slug": "GOOGLEDRIVE_COPY_FILE_ADVANCED",
        "name": "Copy file with advanced options",
        "description": "Creates a copy of a file and applies any requested updates with patch semantics. Use when you need to duplicate a file with advanced options like label inclusion, visibility settings, or custom metadata."
      },
      {
        "slug": "GOOGLEDRIVE_CREATE_COMMENT",
        "name": "Create Comment",
        "description": "Tool to create a comment on a file in Google Drive. Returns a nested `data` object; extract `data.id` for the resulting comment identifier. Omit `anchor` and `quoted_file_content_*` for general file-level comments."
      },
      {
        "slug": "GOOGLEDRIVE_CREATE_DRIVE",
        "name": "Create Shared Drive",
        "description": "Tool to create a new shared drive. Use when you need to programmatically create a new shared drive for collaboration or storage."
      },
      {
        "slug": "GOOGLEDRIVE_CREATE_FILE",
        "name": "Create File or Folder",
        "description": "Creates a new file or folder in Google Drive. Supports both metadata-only creation (for folders and empty documents) and file upload with content. When file_to_upload is provided, uploads the actual file bytes; otherwise creates an empty file. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells when no content is provided; content must be added manually afterward. Newly created files are private by default — set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in `parents` rather than GOOGLEDRIVE_CREATE_FOLDER."
      },
      {
        "slug": "GOOGLEDRIVE_CREATE_FILE_FROM_TEXT",
        "name": "Create a File from Text",
        "description": "Creates a new file in Google Drive from provided text content (up to 10MB), supporting various formats including automatic conversion to Google Workspace types. Returns flat metadata fields (`id`, `mimeType`, `name`) at the top level — not nested under a `file` object. Created files are private by default; use a sharing tool afterward for collaborative access. Rapid successive calls may trigger `403 rateLimitExceeded` or `429 userRateLimitExceeded`; apply exponential backoff between retries. Does not support shared-drive targets in all cases."
      },
      {
        "slug": "GOOGLEDRIVE_CREATE_FOLDER",
        "name": "Create a folder",
        "description": "Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name. The parent folder MUST already exist - use GOOGLEDRIVE_FIND_FOLDER first to verify the parent exists or find its ID. Google Drive permits duplicate folder names, so always store and reuse the folder ID returned by this action rather than relying on names for future lookups."
      },
      {
        "slug": "GOOGLEDRIVE_CREATE_PERMISSION",
        "name": "Create Permission",
        "description": "Tool to create a permission for a file or shared drive. Use when you need to share a file or folder with users, groups, domains, or make it publicly accessible. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied."
      },
      {
        "slug": "GOOGLEDRIVE_CREATE_PERMISSIONS_BATCH",
        "name": "Create Permissions Batch",
        "description": "Creates multiple permissions for files or shared drives in a single batch request. Use this action when you need to share multiple files with users, or share a single file with multiple users or groups simultaneously. Each permission in the batch can target a different file and specify different access levels. Batch operations are more efficient than creating permissions individually, with a maximum of 100 permissions per batch."
      },
      {
        "slug": "GOOGLEDRIVE_CREATE_REPLY",
        "name": "Create Reply",
        "description": "Tool to create a reply to a comment in Google Drive. Use when you need to respond to an existing comment on a file."
      },
      {
        "slug": "GOOGLEDRIVE_CREATE_SHORTCUT_TO_FILE",
        "name": "Create Shortcut to File/Folder",
        "description": "Tool to create a shortcut to a file or folder in Google Drive. Use when you need to link to an existing Drive item from another location without duplicating it. The shortcut receives its own distinct file ID (capture from response). No parent folder parameter exists; use GOOGLEDRIVE_MOVE_FILE after creation to place the shortcut in the desired location."
      },
      {
        "slug": "GOOGLEDRIVE_CREATE_TEAM_DRIVE",
        "name": "Create Team Drive (Deprecated)",
        "description": "Tool to create a Team Drive. Deprecated: Use drives.create instead. Use when you need to create a Team Drive for collaboration."
      },
      {
        "slug": "GOOGLEDRIVE_DELETE_CHILD",
        "name": "Delete Child (v2)",
        "description": "Tool to remove a child from a folder using Google Drive API v2. Use when you need to remove a file from a specific folder."
      },
      {
        "slug": "GOOGLEDRIVE_DELETE_COMMENT",
        "name": "Delete Comment",
        "description": "Permanently deletes a comment thread (and all its replies) from a Google Drive file — this action is irreversible. To remove only a single reply within a thread, use GOOGLEDRIVE_DELETE_REPLY instead. Verify the exact comment content and comment_id before calling."
      },
      {
        "slug": "GOOGLEDRIVE_DELETE_DRIVE",
        "name": "Delete Shared Drive",
        "description": "Tool to permanently delete a shared drive. Use when you need to remove a shared drive and its contents (if specified)."
      },
      {
        "slug": "GOOGLEDRIVE_DELETE_FILE",
        "name": "Delete file",
        "description": "DEPRECATED: Use GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION instead. Tool to permanently delete a file owned by the user without moving it to trash. Use when permanent deletion is required. If the file belongs to a shared drive, the user must be an organizer on the parent folder."
      },
      {
        "slug": "GOOGLEDRIVE_DELETE_PARENT",
        "name": "Delete Parent (v2)",
        "description": "Tool to remove a parent from a file using Google Drive API v2. Use when you need to remove a file from a specific folder."
      },
      {
        "slug": "GOOGLEDRIVE_DELETE_PERMISSION",
        "name": "Delete Permission",
        "description": "Deletes a permission from a file by permission ID. Deletion is irreversible — confirm the target user, group, or permission type before executing. IMPORTANT: You must first call GOOGLEDRIVE_LIST_PERMISSIONS to get valid permission IDs. To fully revoke public access, the type='anyone' (link-sharing) permission must be explicitly deleted; revoking other permissions leaves the file publicly accessible via link. Use when you need to revoke access for a specific user or group from a file."
      },
      {
        "slug": "GOOGLEDRIVE_DELETE_PROPERTY",
        "name": "Delete Property (v2 API)",
        "description": "Tool to delete a property from a file using Google Drive API v2. Use when you need to remove custom key-value metadata from a file."
      },
      {
        "slug": "GOOGLEDRIVE_DELETE_REPLY",
        "name": "Delete Reply",
        "description": "Tool to delete a specific reply by reply ID. Deletion is irreversible; obtain explicit user confirmation before calling. Removes only the targeted reply, not the full comment thread — use GOOGLEDRIVE_DELETE_COMMENT to remove the entire thread."
      },
      {
        "slug": "GOOGLEDRIVE_DELETE_REVISION",
        "name": "Delete Revision",
        "description": "Tool to permanently delete a file revision. Use when you need to remove a specific version of a binary file (images, videos, etc.). Cannot delete revisions for Google Docs/Sheets or the last remaining revision."
      },
      {
        "slug": "GOOGLEDRIVE_DELETE_TEAM_DRIVE",
        "name": "Delete Team Drive (Deprecated)",
        "description": "Tool to permanently delete a Team Drive. Deprecated: Use drives.delete instead. Use when you need to remove a Team Drive using the legacy endpoint."
      },
      {
        "slug": "GOOGLEDRIVE_DOWNLOAD_FILE",
        "name": "Download a file from Google Drive",
        "description": "Downloads a file from Google Drive by its ID. For Google Workspace documents (Docs, Sheets, Slides), optionally exports to a specified `mime_type`. For other file types, downloads in their native format regardless of mime_type. Examples: Export a Google Doc to plain text: {\"file_id\": \"1N2o5xQWmAbCdEfGhIJKlmnOPq\", \"mime_type\": \"text/plain\"} Download a Google Sheet as CSV: {\"file_id\": \"1ZyXwVuTsRqPoNmLkJiHgFeDcB\", \"mime_type\": \"text/csv\"}"
      },
      {
        "slug": "GOOGLEDRIVE_DOWNLOAD_FILE2",
        "name": "Download file content (Deprecated)",
        "description": "DEPRECATED: Use GOOGLEDRIVE_DOWNLOAD_FILE_OPERATION instead. Tool to download file content as a long-running operation. Use when you need to download files from Google Drive. Operations are valid for 24 hours from the time of creation."
      },
      {
        "slug": "GOOGLEDRIVE_DOWNLOAD_FILE_OPERATION",
        "name": "Download file via operation",
        "description": "Tool to download file content using long-running operations. Use when you need to download Google Vids files or export Google Workspace documents as part of a long-running operation. Operations are valid for 24 hours from creation. Returns a response containing `downloaded_file_content.s3url` — a short-lived S3 URL; fetch the actual file bytes from that URL promptly after the call."
      },
      {
        "slug": "GOOGLEDRIVE_EDIT_FILE",
        "name": "Edit File",
        "description": "Updates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB). IMPORTANT: This action only works with files that have binary content (text files, PDFs, images, etc.). It does NOT support editing Google Workspace native files (Google Docs, Sheets, Slides, etc.). For Google Workspace files, use the Google Docs API, Google Sheets API, or Google Slides API directly. Preserves the original file_id (unlike GOOGLEDRIVE_UPLOAD_FILE which creates a new ID)."
      },
      {
        "slug": "GOOGLEDRIVE_EMPTY_TRASH",
        "name": "Empty Trash",
        "description": "Tool to permanently and irreversibly delete ALL trashed files in the user's Google Drive or a specified shared drive. Recovery is impossible after execution — no Drive tool can restore items once trash is emptied. Affects every item in trash across the entire account or shared drive, not just files from the current workflow. Always obtain explicit user confirmation and clarify that recovery is impossible before executing. Provide driveId to target a specific shared drive's trash; omit to empty the user's root trash."
      },
      {
        "slug": "GOOGLEDRIVE_EXPORT_GOOGLE_WORKSPACE_FILE",
        "name": "Export Google Workspace file",
        "description": "Exports a Google Workspace document to the requested MIME type and returns exported file content. Use when you need to export Google Docs, Sheets, Slides, Drawings, or Apps Script files to a specific format. Note: The exported content is limited to 10MB by Google Drive API."
      },
      {
        "slug": "GOOGLEDRIVE_FIND_FILE",
        "name": "Find file",
        "description": "The comprehensive Google Drive search tool that handles all file and folder discovery needs. Use this for any file finding task - from simple name searches to complex queries with date filters, MIME types, permissions, custom properties, folder scoping, and more. Searches across My Drive and shared drives with full metadata support. Examples: - Find PDFs: q=\"mimeType = 'application/pdf'\" - Find recent files: q=\"modifiedTime > '2024-01-01T00:00:00'\" - Search by name: q=\"name contains 'report'\" - Files in folder: folderId=\"abc123\" or q=\"'FOLDER_ID' in parents\""
      },
      {
        "slug": "GOOGLEDRIVE_FIND_FOLDER",
        "name": "Find folder",
        "description": "Finds one page of Google Drive folders by name and optional parent. Use nextPageToken with page_token to retrieve additional pages."
      },
      {
        "slug": "GOOGLEDRIVE_GENERATE_IDS",
        "name": "Generate File IDs",
        "description": "Generates a set of file IDs which can be provided in create or copy requests. Use when you need to pre-allocate IDs for new files or copies."
      },
      {
        "slug": "GOOGLEDRIVE_GET_ABOUT",
        "name": "Get about",
        "description": "Tool to retrieve information about the user, the user's Drive, and system capabilities. Use when you need to check storage quotas, user details, or supported import/export formats. Note: storageQuota reflects My Drive (personal) storage only — it does not cover shared drives; use GOOGLEDRIVE_LIST_SHARED_DRIVES and GOOGLEDRIVE_GET_DRIVE for shared drive quotas. A successful response confirms base Drive read access only; write access and shared drive access must be verified separately."
      },
      {
        "slug": "GOOGLEDRIVE_GET_APP",
        "name": "Get App",
        "description": "Tool to get information about a specific Drive app by ID. Use 'self' as the app ID to get information about the calling app."
      },
      {
        "slug": "GOOGLEDRIVE_GET_CHANGE",
        "name": "Get Change (v2 - Deprecated)",
        "description": "Tool to get a specific change by ID from Google Drive v2 API. Deprecated: Use changes.getStartPageToken and changes.list to retrieve recent changes instead."
      },
      {
        "slug": "GOOGLEDRIVE_GET_CHANGES_START_PAGE_TOKEN",
        "name": "Get Changes Start Page Token",
        "description": "Tool to get the starting pageToken for listing future changes in Google Drive. Returns only a token — pass it to GOOGLEDRIVE_LIST_CHANGES to retrieve actual changes. Persist this token; losing it requires a full rescan. The token is forward-looking: GOOGLEDRIVE_LIST_CHANGES may return no results if no changes have occurred since issuance. For simple recent-file lookups, prefer GOOGLEDRIVE_FIND_FILE; use this tool only for incremental change-feed workflows."
      },
      {
        "slug": "GOOGLEDRIVE_GET_CHILD",
        "name": "Get Child Reference (v2)",
        "description": "Tool to get a specific child reference for a folder using Drive API v2. Use when you need to verify a specific file exists as a child of a folder."
      },
      {
        "slug": "GOOGLEDRIVE_GET_COMMENT",
        "name": "Get Comment",
        "description": "Tool to get a comment by ID. Use when you need to retrieve a specific comment from a Google Drive file and have both the file ID and comment ID."
      },
      {
        "slug": "GOOGLEDRIVE_GET_DRIVE",
        "name": "Get Shared Drive",
        "description": "Tool to get a shared drive by ID. Use when you need to retrieve information about a specific shared drive. To discover drive_ids, use GOOGLEDRIVE_LIST_SHARED_DRIVES first; GOOGLEDRIVE_GET_ABOUT reflects overall user storage, not individual shared drive details. Permission changes may have a brief propagation delay before appearing in results."
      },
      {
        "slug": "GOOGLEDRIVE_GET_FILE_METADATA",
        "name": "Get File Metadata",
        "description": "Tool to get a file's metadata by ID. Use to verify `mimeType`, `parents`, and `trashed` status before destructive operations (delete/move/export), or to confirm `mimeType='application/vnd.google-apps.document'` before calling GOOGLEDOCS_* tools (non-native files require GOOGLEDRIVE_DOWNLOAD_FILE). Only returns metadata visible to the connected account; public access requires GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE. High-frequency calls risk `403 rateLimitExceeded`; apply exponential backoff."
      },
      {
        "slug": "GOOGLEDRIVE_GET_FILE_PROPERTY",
        "name": "Get Property (v2)",
        "description": "Tool to get a property by its key using Google Drive API v2. Use when you need to retrieve a specific custom property attached to a file."
      },
      {
        "slug": "GOOGLEDRIVE_GET_FILE_V2",
        "name": "Get File (v2 API) (Deprecated)",
        "description": "DEPRECATED: Use GetFileMetadata instead. Tool to get a file's metadata or content by ID from Google Drive API v2. Use when you need file metadata with alt=json, or file content with alt=media."
      },
      {
        "slug": "GOOGLEDRIVE_GET_PARENT",
        "name": "Get Parent Reference (v2)",
        "description": "Tool to get a specific parent reference for a file using Drive API v2. Use when you need to retrieve information about a specific parent folder of a file."
      },
      {
        "slug": "GOOGLEDRIVE_GET_PERMISSION",
        "name": "Get Permission",
        "description": "Gets a permission by ID. Use this tool to retrieve a specific permission for a file or shared drive. Newly created or updated permissions on shared drives may have a brief propagation delay before appearing."
      },
      {
        "slug": "GOOGLEDRIVE_GET_PERMISSION_ID_FOR_EMAIL",
        "name": "Get Permission ID for Email",
        "description": "Tool to get the permission ID for an email address using the Drive API v2. Use when you need to convert an email address to its corresponding permission ID."
      },
      {
        "slug": "GOOGLEDRIVE_GET_REPLY",
        "name": "Get Reply",
        "description": "Tool to get a specific reply to a comment on a file. Use when you need to retrieve the details of a particular reply."
      },
      {
        "slug": "GOOGLEDRIVE_GET_REVISION",
        "name": "Get Revision",
        "description": "Tool to get a specific revision's metadata (name, modifiedTime, keepForever, etc.) by revision ID. Returns metadata only — not file content. Use a separate download tool to retrieve file content or restore a revision."
      },
      {
        "slug": "GOOGLEDRIVE_GET_TEAM_DRIVE",
        "name": "Get Team Drive (Deprecated)",
        "description": "Tool to get metadata about a Team Drive by ID. Deprecated: Use the drives.get endpoint instead."
      },
      {
        "slug": "GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION",
        "name": "Delete folder or file",
        "description": "Tool to delete a file or folder in Google Drive. Use when you need to permanently remove a specific file or folder using its ID. Note: This action is irreversible. Deleting a folder permanently removes all nested files and subfolders."
      },
      {
        "slug": "GOOGLEDRIVE_HIDE_DRIVE",
        "name": "Hide Shared Drive",
        "description": "Tool to hide a shared drive from the default view. Use when you want to remove a shared drive from the user's main Google Drive interface without deleting it."
      },
      {
        "slug": "GOOGLEDRIVE_INSERT_CHILD",
        "name": "Insert Child Into Folder (v2)",
        "description": "Tool to insert a file into a folder using Drive API v2. Use when you need to add an existing file to a folder."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_ACCESS_PROPOSALS",
        "name": "List Access Proposals",
        "description": "Tool to list pending access proposals on a file. Use when you need to retrieve access proposals for a specific file. Note: Only approvers can list access proposals; non-approvers will receive a 403 error."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_APPROVALS",
        "name": "List Approvals",
        "description": "Tool to list approvals on a file for workflow-based access control. Use when you need to retrieve all approvals associated with a specific file in Google Drive."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_CHANGES",
        "name": "List Changes",
        "description": "Tool to list the changes for a user or shared drive. Use when a full incremental change feed is needed (for simple recent-file lookups, prefer GOOGLEDRIVE_FIND_FILE instead). Tracks modifications such as creations, deletions, or permission changes. The pageToken is optional - if not provided, the current start page token will be automatically fetched; an empty result is valid if no recent activity has occurred. Example usage: ```json { \"pageToken\": \"22633\", \"pageSize\": 100, \"includeRemoved\": true } ``` Returns changes with timestamps, file IDs, and modification details. Paginate by following `nextPageToken` until it is absent — stopping early will silently omit changes. Save `newStartPageToken` to monitor future changes efficiently."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_CHILDREN_V2",
        "name": "List Folder Children (v2)",
        "description": "Tool to list a folder's children using Google Drive API v2. Use when you need to retrieve all files and folders within a specific folder."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_COMMENTS",
        "name": "List Comments",
        "description": "Tool to list all comments for a file in Google Drive. Results are paginated; iterate using nextPageToken until absent to retrieve all comments. Filtering by author, content, or other criteria must be done client-side. Use commentId, createdTime, and author from results to uniquely identify comments before acting on them."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_FILE_LABELS",
        "name": "List File Labels",
        "description": "Tool to list the labels already applied to a file in Google Drive. An empty labels array is a valid response indicating no labels are applied, not an error. This tool shows only applied labels; label_id and field_id values required by other Drive label tools must be obtained from admin configuration."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_FILE_PROPERTIES",
        "name": "List Properties (v2 API)",
        "description": "Tool to list a file's properties in Google Drive API v2. Use when you need to retrieve custom properties (key-value pairs) attached to a file."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_FILES",
        "name": "List Files and Folders (Deprecated)",
        "description": "DEPRECATED: Use GOOGLEDRIVE_FIND_FILE instead. Tool to list a user's files and folders in Google Drive. Use this to search or browse for files and folders based on various criteria."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_PERMISSIONS",
        "name": "List Permissions",
        "description": "Tool to list a file's permissions. Use when you need to retrieve all permissions associated with a specific file or shared drive."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_REPLIES",
        "name": "List Replies to Comment",
        "description": "Tool to list replies to a comment in Google Drive. Use this when you need to retrieve all replies associated with a specific comment on a file."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_REVISIONS",
        "name": "List File Revisions",
        "description": "Tool to list a file's revision metadata (not content) in Google Drive. Drive may prune old revisions, so history may be incomplete for frequently edited files. Filter client-side for specific revisionIds; do not assume the last entry is the active version."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_SHARED_DRIVES",
        "name": "List Shared Drives",
        "description": "Tool to list the user's shared drives. Use when you need to get a list of all shared drives accessible to the authenticated user. Results may differ from the web UI due to admin policies; listing a drive does not guarantee access to its contents. Paginated calls may trigger 403 rateLimitExceeded or 429 tooManyRequests; apply exponential backoff when iterating many pages."
      },
      {
        "slug": "GOOGLEDRIVE_LIST_TEAM_DRIVES",
        "name": "List Team Drives (Deprecated)",
        "description": "Tool to list Team Drives (deprecated, use List Shared Drives instead). Use when you need to retrieve Team Drives using the legacy endpoint."
      },
      {
        "slug": "GOOGLEDRIVE_MODIFY_FILE_LABELS",
        "name": "Modify File Labels",
        "description": "Modifies the set of labels applied to a file. Returns a list of the labels that were added or modified. Use when you need to programmatically change labels on a Google Drive file, such as adding, updating, or removing them."
      },
      {
        "slug": "GOOGLEDRIVE_MOVE_FILE",
        "name": "Move File",
        "description": "Tool to move a file from one folder to another in Google Drive. To truly move (not just copy the parent), always provide both `add_parents` (destination folder ID) and `remove_parents` (source folder ID); omitting `remove_parents` leaves the file in multiple folders. Useful for reorganizing files, including newly created Google Docs/Sheets that default to Drive root."
      },
      {
        "slug": "GOOGLEDRIVE_PARSE_FILE",
        "name": "Export or download a file",
        "description": "DEPRECATED: Exports Google Workspace files (max 10MB) to a specified format using `mime_type`, or downloads other file types; use `GOOGLEDRIVE_DOWNLOAD_FILE` instead."
      },
      {
        "slug": "GOOGLEDRIVE_PATCH_PERMISSION",
        "name": "Patch Permission",
        "description": "Tool to update a permission using patch semantics. Use when you need to modify specific fields of an existing permission without affecting other fields. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied."
      },
      {
        "slug": "GOOGLEDRIVE_PATCH_PROPERTY",
        "name": "Patch Property (v2 API)",
        "description": "Tool to update a property on a file using PATCH semantics (v2 API). Use when you need to partially update custom key-value metadata attached to a Google Drive file."
      },
      {
        "slug": "GOOGLEDRIVE_RESUMABLE_UPLOAD",
        "name": "Resumable Upload",
        "description": "Tool to start and complete a Google Drive resumable upload session. Use for files larger than ~5 MB to avoid timeouts or size-limit failures. HTTP 308 means continue the session from the correct byte offset; HTTP 410 means the session expired and a full restart with a new session is required."
      },
      {
        "slug": "GOOGLEDRIVE_STOP_WATCH_CHANNEL",
        "name": "Stop Watch Channel",
        "description": "Tool to stop watching resources through a specified channel. Use this when you want to stop receiving notifications for a previously established watch. Both `id` and `resourceId` must be saved from the original watch response — they cannot be retrieved after the fact."
      },
      {
        "slug": "GOOGLEDRIVE_TRASH_FILE",
        "name": "Trash File",
        "description": "Tool to move a file or folder to trash (soft delete). Use when you need to delete a file but want to allow recovery via UNTRASH_FILE. This action is distinct from permanent deletion and provides a safer cleanup workflow."
      },
      {
        "slug": "GOOGLEDRIVE_UNHIDE_DRIVE",
        "name": "Unhide Shared Drive",
        "description": "Tool to unhide a shared drive. Use when you need to restore a shared drive to the default view."
      },
      {
        "slug": "GOOGLEDRIVE_UNTRASH_FILE",
        "name": "Untrash File",
        "description": "Tool to restore a file from the trash. Use when you need to recover a deleted file. This action updates the file's metadata to set the 'trashed' property to false. Only works while the file remains in trash — recovery is impossible after trash is emptied via GOOGLEDRIVE_EMPTY_TRASH or auto-purged by policy."
      },
      {
        "slug": "GOOGLEDRIVE_UPDATE_COMMENT",
        "name": "Update Comment",
        "description": "Tool to update an existing comment on a Google Drive file. Use when you need to change the content of a comment. NOTE: The 'resolved' field is read-only in the Google Drive API. To resolve or reopen a comment, use CREATE_REPLY with action='resolve' or action='reopen'."
      },
      {
        "slug": "GOOGLEDRIVE_UPDATE_DRIVE",
        "name": "Update Shared Drive",
        "description": "Tool to update the metadata for a shared drive. Use when you need to modify properties like the name, theme, background image, or restrictions of a shared drive."
      },
      {
        "slug": "GOOGLEDRIVE_UPDATE_FILE_METADATA_PATCH",
        "name": "Update File Metadata (PATCH v2)",
        "description": "Tool to update file metadata using the Drive API v2 PATCH method. Use when you need to modify file properties like title, description, or labels using patch semantics."
      },
      {
        "slug": "GOOGLEDRIVE_UPDATE_FILE_PROPERTY",
        "name": "Update Property (v2 API)",
        "description": "Tool to update a property on a file using Google Drive API v2. Use when you need to modify an existing custom property attached to a file."
      },
      {
        "slug": "GOOGLEDRIVE_UPDATE_FILE_PUT",
        "name": "Update File (Metadata)",
        "description": "Updates file metadata. Uses PATCH semantics (partial update) as per Google Drive API v3 — only explicitly provided fields are updated, so omit fields you do not intend to overwrite. Use this tool to modify attributes of an existing file like its name, description, or parent folders. To move a file, supply add_parents and remove_parents together; omitting remove_parents creates multiple parents, omitting add_parents can orphan the file. Bulk updates may trigger 429 Too Many Requests; apply exponential backoff. Note: supports metadata updates only; file content updates are not yet implemented."
      },
      {
        "slug": "GOOGLEDRIVE_UPDATE_FILE_REVISION_METADATA",
        "name": "Update File Revision Metadata",
        "description": "Updates ONLY the metadata properties of a specific file revision (keepForever, published, publishAuto, publishedOutsideDomain). IMPORTANT: This action does NOT update file content. To update file content, use EDIT_FILE or UPDATE_FILE_PUT instead. This action requires BOTH file_id AND revision_id parameters. Use LIST_REVISIONS to get available revision IDs for a file. Valid parameters: file_id (required), revision_id (required), keep_forever, published, publish_auto, published_outside_domain. Invalid parameters (use other actions): file_contents, mime_type, content, name - these are NOT supported by this action."
      },
      {
        "slug": "GOOGLEDRIVE_UPDATE_PERMISSION",
        "name": "Update Permission",
        "description": "Tool to update a permission with patch semantics. Use when you need to modify an existing permission for a file or shared drive. Inherited or domain-managed permissions may not be editable; verify editability with GOOGLEDRIVE_LIST_PERMISSIONS before updating."
      },
      {
        "slug": "GOOGLEDRIVE_UPDATE_REPLY",
        "name": "Update Reply",
        "description": "Tool to update a reply to a comment on a Google Drive file. Use when you need to modify the content of an existing reply."
      },
      {
        "slug": "GOOGLEDRIVE_UPDATE_TEAM_DRIVE",
        "name": "Update Team Drive (Deprecated)",
        "description": "Tool to update a Team Drive's metadata. Deprecated: Use the drives.update endpoint instead. Use when you need to modify Team Drive properties."
      },
      {
        "slug": "GOOGLEDRIVE_UPLOAD_FILE",
        "name": "Upload File",
        "description": "Uploads a file (max 5MB) to Google Drive, placing it in the specified folder or root if no valid folder ID is provided. Always creates a new file (never updates existing); use GOOGLEDRIVE_EDIT_FILE to update with a stable file_id. Uploaded files are private by default; configure sharing via GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE."
      },
      {
        "slug": "GOOGLEDRIVE_UPLOAD_FROM_URL",
        "name": "Upload File from URL to Drive",
        "description": "Tool to fetch a file from a provided URL server-side and upload it into Google Drive. Use when you need to reliably persist externally hosted files into Drive without client-side downloads or temporary storage."
      },
      {
        "slug": "GOOGLEDRIVE_UPLOAD_UPDATE_FILE",
        "name": "Upload/Update File Content",
        "description": "Tool to update file content in Google Drive by uploading new binary content. Use when you need to replace the contents of an existing file with new file data."
      },
      {
        "slug": "GOOGLEDRIVE_WATCH_CHANGES",
        "name": "Watch Drive Changes",
        "description": "Tool to subscribe to changes for a user or shared drive in Google Drive. Use when you need to monitor a Google Drive for modifications and receive notifications at a specified webhook URL. Notifications may be batched rather than per-change; design handlers to be idempotent and fetch all changes since the last known page_token on each notification."
      },
      {
        "slug": "GOOGLEDRIVE_WATCH_FILE",
        "name": "Watch File for Changes",
        "description": "Tool to subscribe to push notifications for changes to a specific file. Use when you need to monitor a file for modifications and receive real-time notifications at a webhook URL."
      }
    ],
    "triggers": [
      {
        "slug": "GOOGLEDRIVE_COMMENT_ADDED_TRIGGER",
        "name": "Comment Added (Docs/Sheets/Slides)",
        "description": "Triggers when a new comment is added to Google Docs, Sheets, or Slides."
      },
      {
        "slug": "GOOGLEDRIVE_FILE_CREATED_TRIGGER",
        "name": "File Created",
        "description": "Triggers when a new file is created in Google Drive."
      },
      {
        "slug": "GOOGLEDRIVE_FILE_DELETED_OR_TRASHED_TRIGGER",
        "name": "File Deleted or Trashed",
        "description": "Triggers when a file is moved to trash or permanently deleted in Drive."
      },
      {
        "slug": "GOOGLEDRIVE_FILE_SHARED_PERMISSIONS_ADDED",
        "name": "File Shared (Permissions Added)",
        "description": "Triggers when new sharing permissions are granted to a file or folder.\n\nUses Drive's `changes.list` endpoint with inline `permissions` in the\n`fields` mask so each change carries the file's current permission set\nprovider-atomically. We diff that against `seen_permission_keys` to\nidentify newly added grants. Drive page tokens are the primary cursor;\nif Drive rejects a stored token, the trigger raises `PollingTriggerError`\nwithout clearing state rather than silently re-baselining and dropping\nevents.\n\nLimitation: truly ephemeral permissions (added and revoked between two\npolls without any other file modification in between) are not detected.\nDrive Activity API would catch those but requires an additional OAuth\nscope and a different payload contract."
      },
      {
        "slug": "GOOGLEDRIVE_FILE_UPDATED_TRIGGER",
        "name": "File Updated",
        "description": "Triggers when a file's metadata or content changes in Google Drive."
      },
      {
        "slug": "GOOGLEDRIVE_GOOGLE_DRIVE_CHANGES",
        "name": "Google Drive Changes",
        "description": "Triggers when changes are detected in a Google Drive."
      },
      {
        "slug": "GOOGLEDRIVE_NEW_FILE_MATCHING_QUERY_TRIGGER",
        "name": "New File Matching Query",
        "description": "Triggers when a new Google Drive file matches a provided query.\n\nThis is the legacy query-centric trigger: it preserves Drive API query\nconfig such as ``corpora`` / ``driveId`` aliases and emits the historical\n``file_matching_query`` event type. ``FileCreatedTrigger`` covers the\nbroader \"new file\" case and emits ``file_created``."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "google_drive_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/userinfo.email"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "googledocs",
    "name": "Google Docs",
    "logo": "https://logos.composio.dev/api/googledocs",
    "description": "Google Docs is a cloud-based word processor with real-time collaboration, version history, and integration with other Google Workspace apps",
    "category": "documents",
    "authSchemes": [
      "OAUTH2"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 43,
    "triggerCount": 10,
    "version": "20260826_00",
    "tools": [
      {
        "slug": "GOOGLEDOCS_COPY_DOCUMENT",
        "name": "Copy Google Document",
        "description": "Tool to create a copy of an existing Google Document. Use this to duplicate a document, for example, when using an existing document as a template. The copied document will have a default title (e.g., 'Copy of [original title]') if no new title is provided, and will be placed in the user's root Google Drive folder."
      },
      {
        "slug": "GOOGLEDOCS_CREATE_AND_POPULATE_TABLE",
        "name": "Create and Populate Table in Google Doc",
        "description": "Creates a new table in a Google Document and populates its cells with provided text data in a single operation. Use this action when you need to insert a structured table with predefined content into a document. The action handles both table creation and cell population automatically, eliminating the need for separate operations."
      },
      {
        "slug": "GOOGLEDOCS_CREATE_DOCUMENT",
        "name": "Create a document",
        "description": "Creates a new Google Docs document using the provided title as filename and inserts the initial text at the beginning if non-empty, returning the document's ID and metadata (excluding body content)."
      },
      {
        "slug": "GOOGLEDOCS_CREATE_DOCUMENT2",
        "name": "Create blank document (Deprecated)",
        "description": "DEPRECATED: Use GOOGLEDOCS_CREATE_DOCUMENT instead. Tool to create a blank Google Docs document with a specified title. Use when you need to create a new, empty document."
      },
      {
        "slug": "GOOGLEDOCS_CREATE_DOCUMENT_MARKDOWN",
        "name": "Create Document Markdown",
        "description": "Creates a new Google Docs document, optionally initializing it with a title and content provided as Markdown text."
      },
      {
        "slug": "GOOGLEDOCS_CREATE_FOOTER",
        "name": "Create Footer",
        "description": "Tool to create a new footer in a Google Document. Use when you need to add a footer, optionally specifying its type and the section it applies to."
      },
      {
        "slug": "GOOGLEDOCS_CREATE_FOOTNOTE",
        "name": "Create Footnote",
        "description": "Tool to create a new footnote in a Google Document. Use this when you need to add a footnote at a specific location or at the end of the document body."
      },
      {
        "slug": "GOOGLEDOCS_CREATE_HEADER",
        "name": "Create Header",
        "description": "Tool to create a new header in a Google Document, optionally with text content. Use this tool when you need to add a header to a document. You can provide: - document_id: The ID of the document (required) - type: The header type (DEFAULT is the standard header) - text: Optional text content to add to the header - section_break_location: Optional location for section-specific headers"
      },
      {
        "slug": "GOOGLEDOCS_CREATE_NAMED_RANGE",
        "name": "Create Named Range",
        "description": "Tool to create a new named range in a Google Document. Use this to assign a name to a specific part of the document for easier reference or programmatic manipulation."
      },
      {
        "slug": "GOOGLEDOCS_CREATE_PARAGRAPH_BULLETS",
        "name": "Create Paragraph Bullets",
        "description": "Tool to add bullets to paragraphs within a specified range in a Google Document. Use when you need to format a list or a set of paragraphs as bullet points."
      },
      {
        "slug": "GOOGLEDOCS_CREATE_TAB",
        "name": "Create Document Tab",
        "description": "Creates a new tab in a Google Docs document. Tabs allow you to organize document content into separate sections within a single document. Use this action when you need to add a new organizational tab to a document. When a tab is added at a specified index, all subsequent tabs' indexes are automatically incremented."
      },
      {
        "slug": "GOOGLEDOCS_DELETE_CONTENT_RANGE",
        "name": "Delete Content Range in Document",
        "description": "Tool to delete a range of content from a Google Document. Use when you need to remove a specific portion of text or other structural elements within a document. Note: Every segment (body, header, footer, footnote) in Google Docs ends with a final newline character that cannot be deleted. Ensure the endIndex does not include this trailing newline."
      },
      {
        "slug": "GOOGLEDOCS_DELETE_FOOTER",
        "name": "Delete Footer",
        "description": "Tool to delete a footer from a Google Document. Use when you need to remove a footer from a specific section or the default footer."
      },
      {
        "slug": "GOOGLEDOCS_DELETE_HEADER",
        "name": "Delete Header",
        "description": "Deletes the header from the specified section or the default header if no section is specified. Use this tool to remove a header from a Google Document."
      },
      {
        "slug": "GOOGLEDOCS_DELETE_NAMED_RANGE",
        "name": "Delete Named Range",
        "description": "Tool to delete a named range from a Google Document. Use when you need to remove a previously defined named range by its ID or name."
      },
      {
        "slug": "GOOGLEDOCS_DELETE_PARAGRAPH_BULLETS",
        "name": "Delete Paragraph Bullets",
        "description": "Tool to remove bullets from paragraphs within a specified range in a Google Document. Use when you need to clear bullet formatting from a section of a document."
      },
      {
        "slug": "GOOGLEDOCS_DELETE_TAB",
        "name": "Delete Tab",
        "description": "Deletes a tab from a Google Document. This action is irreversible — the tab cannot be recovered once removed. Use when you need to remove a tab and all its child tabs from a document's tab structure."
      },
      {
        "slug": "GOOGLEDOCS_DELETE_TABLE_COLUMN",
        "name": "Delete Table Column",
        "description": "Tool to delete a column from a table in a Google Document. Use this tool when you need to remove a specific column from an existing table within a document."
      },
      {
        "slug": "GOOGLEDOCS_DELETE_TABLE_ROW",
        "name": "Delete Table Row",
        "description": "Tool to delete a row from a table in a Google Document. Use when you need to remove a specific row from an existing table."
      },
      {
        "slug": "GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF",
        "name": "Export Google Doc as PDF",
        "description": "Tool to export a Google Docs file as PDF using the Google Drive API. Use when you need to generate a PDF version of a Google Docs document for download or distribution. Note: Google Drive enforces a 10MB limit on export content."
      },
      {
        "slug": "GOOGLEDOCS_GET_DOCUMENT_BY_ID",
        "name": "Get document by id",
        "description": "Retrieves an existing Google Document by its ID; will error if the document is not found."
      },
      {
        "slug": "GOOGLEDOCS_GET_DOCUMENT_END_INDEX",
        "name": "Get Document End Index",
        "description": "Retrieves the end index and paragraph structure of a Google Document or specific segment. Use this action when you need to determine valid insertion points for text operations, especially before using insertText requests. The end index represents the maximum boundary of the document body or specified segment (header, footer, footnote, or tab)."
      },
      {
        "slug": "GOOGLEDOCS_GET_DOCUMENT_PLAINTEXT",
        "name": "Get document plain text",
        "description": "Retrieve a Google Doc by ID and return a best-effort plain-text rendering. Converts document structure into plain text including paragraphs, lists, and tables without requiring clients to traverse complex Docs API JSON."
      },
      {
        "slug": "GOOGLEDOCS_INSERT_IMAGE_IN_TABLE_CELL",
        "name": "Insert Image in Table Cell",
        "description": "Inserts an image from a given URI into a specific table cell in a Google Document. Use this action when you need to add an image to a particular cell within a table. The action identifies the target cell by table start index, row index, and column index, then inserts the image at the specified position within that cell's content."
      },
      {
        "slug": "GOOGLEDOCS_INSERT_INLINE_IMAGE",
        "name": "Insert Inline Image",
        "description": "Tool to insert an image from a given URI at a specified location in a Google Document as an inline image. Use when you need to add an image to a document programmatically."
      },
      {
        "slug": "GOOGLEDOCS_INSERT_PAGE_BREAK",
        "name": "Insert Page Break",
        "description": "Tool to insert a page break into a Google Document. Use when you need to start new content on a fresh page, such as at the end of a chapter or section."
      },
      {
        "slug": "GOOGLEDOCS_INSERT_TABLE_ACTION",
        "name": "Insert Table in Google Doc",
        "description": "Tool to insert a table into a Google Document. Use when you need to add a new table at a specific location or at the end of a segment (like document body, header, or footer) in a document."
      },
      {
        "slug": "GOOGLEDOCS_INSERT_TABLE_COLUMN",
        "name": "Insert Table Column",
        "description": "Tool to insert a new column into a table in a Google Document. Use this tool when you need to add a column to an existing table at a specific location."
      },
      {
        "slug": "GOOGLEDOCS_INSERT_TABLE_ROW",
        "name": "Insert Table Row",
        "description": "Inserts a new row into a table in a Google Document at a specified location. Use this action when you need to add a row to an existing table, either above or below a reference cell location."
      },
      {
        "slug": "GOOGLEDOCS_INSERT_TEXT_ACTION",
        "name": "Insert Text into Document",
        "description": "Tool to insert a string of text at a specified location within a Google Document. Use when you need to add new text content to an existing document. IMPORTANT: Two ways to specify insertion location: 1. Use 'insertion_index' to insert at a specific position (index 1 is safe for document start) 2. Use 'append_to_end=true' to append text to the end of the document (recommended for appending) CRITICAL CONSTRAINT: When using insertion_index, the index MUST fall within the bounds of an EXISTING paragraph. You cannot insert text at arbitrary indices or at structural boundaries (e.g., table starts). The index must also be strictly less than the document's end index. To safely append text without index concerns, use append_to_end=true."
      },
      {
        "slug": "GOOGLEDOCS_INSERT_TEXT_IN_TABLE_CELL",
        "name": "Insert Text in Table Cell",
        "description": "Inserts text into a specific cell of a table in a Google Document by row and column position. Use this action when you need to add or update text content in a table cell at a known row and column index. To use this action, you must first retrieve the document structure using GOOGLEDOCS_GET_DOCUMENT_BY_ID to find the table's start index. Then specify the target cell by its zero-based row and column indices (e.g., row_index=0, column_index=0 for the top-left cell)."
      },
      {
        "slug": "GOOGLEDOCS_LIST_SPREADSHEET_CHARTS",
        "name": "Get Charts from Spreadsheet",
        "description": "Tool to retrieve a list of all charts from a specified Google Sheets spreadsheet. Use when you need to get chart IDs and their specifications for embedding or referencing elsewhere, such as in Google Docs."
      },
      {
        "slug": "GOOGLEDOCS_REPLACE_ALL_TEXT",
        "name": "Replace All Text in Document",
        "description": "Tool to replace all occurrences of a specified text string with another text string throughout a Google Document. Use when you need to perform a global find and replace operation within a document."
      },
      {
        "slug": "GOOGLEDOCS_REPLACE_IMAGE",
        "name": "Replace Image in Document",
        "description": "Tool to replace a specific image in a document with a new image from a URI. Use when you need to update an existing image within a Google Doc."
      },
      {
        "slug": "GOOGLEDOCS_SEARCH_DOCUMENTS",
        "name": "Search Documents",
        "description": "Search for Google Documents using various filters including name, content, date ranges, and more."
      },
      {
        "slug": "GOOGLEDOCS_UNMERGE_TABLE_CELLS",
        "name": "Unmerge Table Cells",
        "description": "Tool to unmerge previously merged cells in a table. Use this when you need to revert merged cells in a Google Document table back to their individual cell states."
      },
      {
        "slug": "GOOGLEDOCS_UPDATE_DOCUMENT_BATCH",
        "name": "Update Document Batch (Deprecated)",
        "description": "DEPRECATED: Use UpdateExistingDocument instead. Tool to apply one or more updates to a Google Document. Use when you need to perform batch operations on a document, such as inserting text, updating styles, or modifying document structure. Supports 35+ request types including insertText, replaceAllText, updateTextStyle, createParagraphBullets, insertTable, createHeader/Footer, and more. Each request is validated before being applied. If any request is invalid, the entire operation fails and nothing is applied."
      },
      {
        "slug": "GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN",
        "name": "Update Document Markdown",
        "description": "Replaces the entire content of an existing Google Docs document with new Markdown text; requires edit permissions for the document."
      },
      {
        "slug": "GOOGLEDOCS_UPDATE_DOCUMENT_SECTION_MARKDOWN",
        "name": "Update Document Section Markdown",
        "description": "Tool to insert or replace a section of a Google Docs document with Markdown content. Use when you need to update only a section of a document by specifying start and optional end indices. Supports full Markdown formatting."
      },
      {
        "slug": "GOOGLEDOCS_UPDATE_DOCUMENT_STYLE",
        "name": "Update Document Style",
        "description": "Tool to update the overall document style, such as page size, margins, and default text direction. Use when you need to modify the global style settings of a Google Document."
      },
      {
        "slug": "GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT",
        "name": "Update existing document",
        "description": "Applies programmatic edits, such as text insertion, deletion, or formatting, to a specified Google Doc using the `batchUpdate` API method."
      },
      {
        "slug": "GOOGLEDOCS_UPDATE_TABLE_ROW_STYLE",
        "name": "Update Table Row Style",
        "description": "Tool to update the style of a table row in a Google Document. Use when you need to modify the appearance of specific rows within a table, such as setting minimum row height or marking rows as headers."
      },
      {
        "slug": "GOOGLEDOCS_UPDATE_TAB_PROPERTIES",
        "name": "Update Tab Properties",
        "description": "Updates properties of a document tab such as title, parent tab, index, and icon emoji. Use this action when you need to rename a tab, change its emoji icon, move it within the tab hierarchy, or reorganize tab structure."
      }
    ],
    "triggers": [
      {
        "slug": "GOOGLEDOCS_DOCUMENT_CREATED_TRIGGER",
        "name": "New Document Created",
        "description": "Triggers when a new Google Doc is created.\nThis trigger monitors Google Docs and fires when new documents are detected.\nUses timestamp filtering to efficiently poll for new documents."
      },
      {
        "slug": "GOOGLEDOCS_DOCUMENT_DELETED_TRIGGER",
        "name": "Document Deleted",
        "description": "Triggers when an existing Google Doc is deleted (moved to trash).\nThis trigger monitors Google Docs and fires when documents are trashed."
      },
      {
        "slug": "GOOGLEDOCS_DOCUMENT_PLACEHOLDER_FILLED_TRIGGER",
        "name": "Document Placeholder Filled",
        "description": "Triggers when a Google Doc's plain text changes such that a configured placeholder\ntoken/pattern is no longer present (i.e., the document has been filled in).\n\nThis trigger monitors a specific Google Doc and fires when a placeholder pattern\nthat was previously present is no longer found in the document's plain text."
      },
      {
        "slug": "GOOGLEDOCS_DOCUMENT_SEARCH_UPDATE_TRIGGER",
        "name": "Document Search Update",
        "description": "Triggers when a Google Doc matching a user-defined search query is newly created or updated since the last poll.\nThis trigger uses timestamp filtering to efficiently monitor documents."
      },
      {
        "slug": "GOOGLEDOCS_DOCUMENT_STRUCTURE_CHANGED_TRIGGER",
        "name": "Document Structure Changed",
        "description": "Triggers when a Google Doc's structure changes (headers/footers added/removed, tables/images count changes).\nThis trigger monitors a specific document for structural changes like:\n- Headers added or removed\n- Footers added or removed\n- Tables added or removed\n- Images (inline objects) added or removed\n- Positioned objects added or removed\n- Footnotes added or removed"
      },
      {
        "slug": "GOOGLEDOCS_DOCUMENT_UPDATED_TRIGGER",
        "name": "Document Updated",
        "description": "Triggers when an existing Google Doc is updated or modified.\nThis trigger monitors Google Docs and fires when documents are updated."
      },
      {
        "slug": "GOOGLEDOCS_DOCUMENT_WORD_COUNT_THRESHOLD_TRIGGER",
        "name": "Document Word Count Threshold",
        "description": "Triggers when a Google Doc's word/character count crosses a user-defined threshold.\nThis trigger monitors a specific Google Doc and fires when its word or character count\nbecomes greater than or equal to the configured threshold value."
      },
      {
        "slug": "GOOGLEDOCS_FOLDER_CREATED_TRIGGER",
        "name": "New Folder Created in Root",
        "description": "Triggers when a new folder is created in the root folder of Google Drive.\nThis trigger monitors Google Drive and fires when new folders are detected in the root directory."
      },
      {
        "slug": "GOOGLEDOCS_KEYWORD_DETECTED_TRIGGER",
        "name": "Keyword Detected in Document",
        "description": "Triggers when a specific keyword or phrase first appears in a Google Doc.\nThis trigger monitors a Google Doc and fires once when the specified keyword is detected.\nAfter the keyword is found, the trigger will not fire again until reset."
      },
      {
        "slug": "GOOGLEDOCS_PAGE_ADDED_TRIGGER",
        "name": "New Document Added",
        "description": "Triggers when a new Google Doc is added/created.\nThis trigger monitors Google Docs and fires when new documents are detected."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "google_docs_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/documents,https://www.googleapis.com/auth/userinfo.email"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "hubspot",
    "name": "HubSpot",
    "logo": "https://logos.composio.dev/api/hubspot",
    "description": "HubSpot is an inbound marketing, sales, and customer service platform integrating CRM, email automation, and analytics to facilitate lead nurturing and seamless customer experiences",
    "category": "crm",
    "authSchemes": [
      "OAUTH2",
      "API_KEY"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 245,
    "triggerCount": 2,
    "version": "20260826_00",
    "tools": [
      {
        "slug": "HUBSPOT_ADD_ASSET_ASSOCIATION",
        "name": "Add asset association",
        "description": "Associates an existing asset ('FORM', 'OBJECT_LIST', or 'EXTERNAL_WEB_URL') with a specified HubSpot marketing campaign."
      },
      {
        "slug": "HUBSPOT_ADD_TOKEN_TO_EVENT_TEMPLATE",
        "name": "Add token to event template",
        "description": "Adds a new custom data token to an existing event template for a specified HubSpot application, optionally populating a CRM object property if objectPropertyName is provided."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_BATCH_OF_FEEDBACK_SUBMISSIONS",
        "name": "Archive batch of feedback submissions by id",
        "description": "Asynchronously archives a batch of HubSpot feedback submissions using their unique IDs, which must correspond to valid and existing submissions; the operation is queued, and submissions are moved from active views without being deleted."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_BATCH_OF_LINE_ITEMS",
        "name": "Archive batch of line items by id",
        "description": "Archives a batch of existing line items by their unique IDs in HubSpot CRM; this operation is irreversible via the API."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_BATCH_OF_OBJECTS",
        "name": "Archive batch of objects by id",
        "description": "Archives a batch of existing, non-archived CRM objects of a specified `objectType` by their IDs, effectively hiding them from active use."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_BATCH_OF_PROPERTIES",
        "name": "Archive batch of properties",
        "description": "Archives a batch of properties by their internal names for a specified HubSpot CRM object type; this operation is idempotent and safe to retry."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_BATCH_OF_QUOTES",
        "name": "Archive a batch of quotes by id",
        "description": "Archives a batch of existing quotes by their IDs, removing them from active views while keeping them accessible in your HubSpot account for viewing, downloading, cloning, or deletion; note that archived quotes cannot be restored to active status."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_COMPANIES",
        "name": "Archive companies",
        "description": "Archives multiple HubSpot companies by their IDs."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_COMPANY",
        "name": "Archive company",
        "description": "Archives an existing company in HubSpot CRM by its `companyId`, moving it to a recycling bin from which it can be restored, rather than permanently deleting it."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_CONTACT",
        "name": "Archive contact",
        "description": "Archives a HubSpot contact by its ID."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_CONTACTS",
        "name": "Archive contacts",
        "description": "Archives multiple HubSpot contacts by their IDs."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_CRM_OBJECT_BY_ID",
        "name": "Archive a CRM object by ID",
        "description": "Archives a specific HubSpot CRM object by its type and ID, moving it to the recycling bin; this action is irreversible via the API but objects can often be restored via the HubSpot UI."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_DEALS",
        "name": "Archive deals",
        "description": "Archives multiple HubSpot deals by their IDs."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_EMAIL",
        "name": "ArchiveEmail email",
        "description": "Archives the HubSpot email specified by `emailId` by moving it to the recycling bin, making it inaccessible unless restored."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_EMAILS",
        "name": "Archive emails",
        "description": "Archives multiple HubSpot emails by their IDs."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_FEEDBACK_SUBMISSION",
        "name": "Archive feedback submission",
        "description": "Archives an existing, non-archived Feedback Submission in HubSpot CRM by its ID, moving it to the recycling bin (not permanently deleting it)."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_LINE_ITEM",
        "name": "Archive line item by id",
        "description": "Archives a specific HubSpot line item by its ID, moving it to a recoverable state."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_PRODUCT",
        "name": "Archive product",
        "description": "Archives a HubSpot product by its ID."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_PRODUCTS",
        "name": "Archive products",
        "description": "Archives multiple HubSpot products by their IDs."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_PROPERTY_BY_OBJECT_TYPE_AND_NAME",
        "name": "Archive property by object type and name",
        "description": "Archives a specified CRM property by its object type and name, moving it to the recycling bin; note that some default HubSpot properties cannot be archived."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_PROPERTY_GROUP",
        "name": "Archive property group",
        "description": "Archives a HubSpot property group, making it inactive and hidden (not permanently deleted, allowing potential restoration) with immediate effect on its CRM visibility and usability."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_QUOTE",
        "name": "Archive quote object by id",
        "description": "Archives a HubSpot Quote object by ID, moving it to the recycling bin where it can be restored within 90 days."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_TICKET",
        "name": "Archive ticket",
        "description": "Archives a HubSpot ticket by its ID."
      },
      {
        "slug": "HUBSPOT_ARCHIVE_TICKETS",
        "name": "Archive tickets",
        "description": "Archives multiple HubSpot tickets by their IDs."
      },
      {
        "slug": "HUBSPOT_AUDIT_PIPELINE_CHANGES",
        "name": "Audit pipeline changes by id",
        "description": "Retrieves a reverse chronological audit log of all changes for a specific, existing HubSpot CRM pipeline, which is identified by its `pipelineId` and a valid `objectType` that supports pipelines (e.g., 'deals', 'tickets')."
      },
      {
        "slug": "HUBSPOT_BATCH_READ_COMPANIES_BY_PROPERTIES",
        "name": "Batch read companies by properties",
        "description": "Batch-retrieves up to 100 HubSpot company records by their IDs in a single request. Supports custom ID properties (e.g., domain), selective property retrieval, and historical property values."
      },
      {
        "slug": "HUBSPOT_BATCH_UPDATE_QUOTES",
        "name": "Batch update quotes",
        "description": "Updates multiple existing HubSpot quotes in a batch; each quote is identified by its object ID or a custom unique property (via `idProperty`), and only writable properties are modified."
      },
      {
        "slug": "HUBSPOT_CANCEL_IMPORT",
        "name": "Cancel active import",
        "description": "Cancels an active HubSpot data import job using its `importId`; this action is irreversible, and any data already processed will remain."
      },
      {
        "slug": "HUBSPOT_CLONE_MARKETING_EMAIL",
        "name": "Clone marketing email",
        "description": "Duplicates an existing HubSpot marketing email, identified by its `id`, into a new draft; an optional `cloneName` can be assigned to this new email copy."
      },
      {
        "slug": "HUBSPOT_CONFIGURE_CALLING_EXTENSION_SETTINGS",
        "name": "Configure calling extension settings",
        "description": "Configures or updates settings for a HubSpot app's calling extension, including its name, UI URL, iframe dimensions, `isReady` status, and `supportsCustomObjects` flag, for the specified `appId`."
      },
      {
        "slug": "HUBSPOT_CREATE_AB_TEST_VARIATION",
        "name": "Create A/B test variation",
        "description": "Creates a new A/B test variation for an existing HubSpot marketing email, using its `contentId`; the new variation is created as a draft that can be edited before publishing. This action only creates the variation—it does not start the A/B test or send emails. Note: If an active variation already exists for the email, a new one will not be created. Requires Marketing Hub Professional or Enterprise subscription."
      },
      {
        "slug": "HUBSPOT_CREATE_AND_RETURN_A_NEW_PROPERTY_GROUP",
        "name": "Create a new property group",
        "description": "Creates a new, empty property group for a specified CRM object type in HubSpot, requiring a unique group name for that object type; properties must be added separately."
      },
      {
        "slug": "HUBSPOT_CREATE_A_NEW_MARKETING_EMAIL",
        "name": "Create a new marketing email",
        "description": "Creates a new marketing email in HubSpot, allowing comprehensive configuration of content, recipients, sender details, A/B testing, scheduling, web version, and other settings; the internal `name` for the email is required."
      },
      {
        "slug": "HUBSPOT_CREATE_ASSOCIATION",
        "name": "Create association for object type",
        "description": "Creates a new custom association definition (schema) for a custom object in HubSpot, specifying how this object type can relate to another object type; this defines the association type itself, not actual record-to-record links. Note: This endpoint requires crm.schemas.custom.write scope and only works with custom objects (not standard HubSpot objects like contacts or companies)."
      },
      {
        "slug": "HUBSPOT_CREATE_BATCH_OF_FEEDBACK_SUBMISSIONS",
        "name": "Create batch of feedback submissions",
        "description": "Creates a batch of feedback submissions in HubSpot, ideal for bulk imports; all property names, `associationTypeId`s, and association `to_id`s must reference existing entities in HubSpot."
      },
      {
        "slug": "HUBSPOT_CREATE_BATCH_OF_OBJECTS",
        "name": "Create batch of objects",
        "description": "Creates multiple CRM objects of a specified `objectType` (e.g., contacts, companies, deals) in a single batch operation, where each object can have its own set of properties and associations."
      },
      {
        "slug": "HUBSPOT_CREATE_BATCH_OF_PROPERTIES",
        "name": "Create batch of properties",
        "description": "Efficiently creates multiple CRM properties in a single batch for a specified HubSpot object type (e.g., 'contacts', 'companies', custom object ID), ideal for schema setup or updates."
      },
      {
        "slug": "HUBSPOT_CREATE_BATCH_OF_QUOTES",
        "name": "Create batch of quotes",
        "description": "Creates multiple HubSpot CRM quotes in a batch, ideal for bulk operations; provide meaningful quote details in `inputs` as property requirements can vary, and inspect response for individual quote statuses as partial success is possible."
      },
      {
        "slug": "HUBSPOT_CREATE_CAMPAIGN",
        "name": "Create campaign",
        "description": "Creates a new HubSpot campaign."
      },
      {
        "slug": "HUBSPOT_CREATE_CAMPAIGNS",
        "name": "Create campaigns",
        "description": "Creates multiple HubSpot campaigns by calling the single campaign creation endpoint for each campaign. Note: HubSpot does not provide a native batch create endpoint for campaigns. This action creates multiple campaigns by making individual API calls for each campaign in the batch."
      },
      {
        "slug": "HUBSPOT_CREATE_COMPANIES",
        "name": "Create companies",
        "description": "Creates multiple new HubSpot companies in a single batch operation."
      },
      {
        "slug": "HUBSPOT_CREATE_COMPANY",
        "name": "Create company",
        "description": "Creates a new HubSpot company."
      },
      {
        "slug": "HUBSPOT_CREATE_CONTACT",
        "name": "Create contact",
        "description": "Creates a new HubSpot contact."
      },
      {
        "slug": "HUBSPOT_CREATE_CONTACT_FROM_NL",
        "name": "Create Contact From Natural Language",
        "description": "Creates a new contact in HubSpot from a natural language description. Fetches the contact property schema at runtime, uses an LLM to generate the correct property payload, and creates the contact."
      },
      {
        "slug": "HUBSPOT_CREATE_CONTACTS",
        "name": "Create contacts",
        "description": "Creates multiple new HubSpot contacts in a single batch operation."
      },
      {
        "slug": "HUBSPOT_CREATE_CRM_OBJECT_FROM_NL",
        "name": "Create CRM Object From Natural Language",
        "description": "Creates a new CRM object (contact, deal, company, ticket, or custom object) in HubSpot from a natural language description. Fetches the object's property schema at runtime, uses an LLM to generate the correct property payload, and creates the object."
      },
      {
        "slug": "HUBSPOT_CREATE_CRM_OBJECT_WITH_PROPERTIES",
        "name": "Create CRM object with properties",
        "description": "Creates a new HubSpot CRM object (e.g., contact, company, custom object) with specified `properties` (using valid internal names) and `associations` (to existing objects via valid type IDs)."
      },
      {
        "slug": "HUBSPOT_CREATE_DEAL",
        "name": "Create deal",
        "description": "Creates a new HubSpot deal."
      },
      {
        "slug": "HUBSPOT_CREATE_DEAL_FROM_NL",
        "name": "Create Deal From Natural Language",
        "description": "Creates a new deal in HubSpot from a natural language description. Fetches the deal property schema and pipeline stages at runtime, uses an LLM to generate the correct property payload, and creates the deal."
      },
      {
        "slug": "HUBSPOT_CREATE_DEALS",
        "name": "Create deals",
        "description": "Creates multiple deals in HubSpot CRM; ensure any associated object IDs, deal stages, and pipeline IDs specified are valid and exist within the HubSpot account."
      },
      {
        "slug": "HUBSPOT_CREATE_EMAIL",
        "name": "Create email",
        "description": "Creates a new HubSpot email engagement record. REQUIRED FIELDS in properties dict: - hs_email_subject: Subject line - hs_email_html: HTML content - hs_timestamp: Unix timestamp in milliseconds - hs_email_direction: One of 'EMAIL', 'INCOMING_EMAIL', 'FORWARDED_EMAIL', 'DRAFT_EMAIL' This creates an email engagement/activity record in HubSpot CRM, not a marketing email."
      },
      {
        "slug": "HUBSPOT_CREATE_EMAILS",
        "name": "Create emails",
        "description": "Creates multiple HubSpot emails in a single batch operation."
      },
      {
        "slug": "HUBSPOT_CREATE_EVENT_TEMPLATE_FOR_APP",
        "name": "Create event template for app",
        "description": "Creates a new event template for a HubSpot app, defining structure, custom properties (tokens), and appearance (Markdown with Handlebars) of custom timeline events for CRM objects; this template must exist before logging corresponding events."
      },
      {
        "slug": "HUBSPOT_CREATE_FEEDBACK_SUBMISSION",
        "name": "Create feedback submission",
        "description": "Creates a new HubSpot feedback submission to record customer feedback (e.g., survey responses, support interactions), optionally associating it with CRM objects."
      },
      {
        "slug": "HUBSPOT_CREATE_LINE_ITEM",
        "name": "Create line item",
        "description": "Creates a new HubSpot line item."
      },
      {
        "slug": "HUBSPOT_CREATE_LINE_ITEMS",
        "name": "Create line items",
        "description": "Creates multiple HubSpot line items in a single batch operation."
      },
      {
        "slug": "HUBSPOT_CREATE_MEETING",
        "name": "Create meeting",
        "description": "Creates a new meeting engagement in HubSpot CRM. Use this action when you need to log a meeting that occurred or schedule a future meeting with contacts, companies, or other CRM records. The meeting will appear on the timeline of associated records and can include details like title, time, location, notes, and outcome."
      },
      {
        "slug": "HUBSPOT_CREATE_NOTE",
        "name": "Create note",
        "description": "Creates a new HubSpot CRM note. Use when you need to add a timestamped note with optional attachments and associations to contacts, companies, deals, or tickets."
      },
      {
        "slug": "HUBSPOT_CREATE_OBJECT_ASSOCIATION",
        "name": "Create object association",
        "description": "Tool to create or label an association between two CRM records using HubSpot Associations v4 API. Use when you need to link records (e.g., contact to company, deal to contact) with explicit association labels."
      },
      {
        "slug": "HUBSPOT_CREATE_OBJECT_SCHEMA",
        "name": "Create new object schema with custom properties",
        "description": "Creates a new custom object schema in HubSpot CRM with unique naming for schema and properties, defined display/required/searchable properties within the 'properties' list, provided immutable labels, and correctly configured 'enumeration' type properties (options/referencedObjectType)."
      },
      {
        "slug": "HUBSPOT_CREATE_OR_UPDATE_DRAFT_VERSION",
        "name": "Create or update draft version",
        "description": "Creates or updates the draft version of a marketing email identified by `emailId`; if no draft exists, a new one is created from the current live version to prepare changes or A/B tests before publishing."
      },
      {
        "slug": "HUBSPOT_CREATE_PIPELINE",
        "name": "Create pipeline for object type",
        "description": "Creates a new HubSpot pipeline for a specified CRM `objectType` (e.g., 'deals', 'tickets'), requiring the pipeline `label` be unique for that `objectType` and each stage `label` be unique within the pipeline."
      },
      {
        "slug": "HUBSPOT_CREATE_PIPELINE_STAGE",
        "name": "Create pipeline stage",
        "description": "Creates a new stage in a specified HubSpot CRM pipeline for a given object type, such as 'deals' or 'tickets'."
      },
      {
        "slug": "HUBSPOT_CREATE_PRODUCT",
        "name": "Create product",
        "description": "Creates a new HubSpot product. Note: Products are catalog items and cannot be directly associated with deals, contacts, or companies. To connect product information to a deal or quote, create a line item using HUBSPOT_CREATE_LINE_ITEM that references this product's ID via hs_product_id."
      },
      {
        "slug": "HUBSPOT_CREATE_PRODUCTS",
        "name": "Create products",
        "description": "Creates multiple HubSpot products in a single batch operation."
      },
      {
        "slug": "HUBSPOT_CREATE_PROPERTY_FOR_SPECIFIED_OBJECT_TYPE",
        "name": "Create property for specified object type",
        "description": "Creates a new custom property for a specified HubSpot CRM object type; ensure `groupName` refers to an existing property group for the `objectType`."
      },
      {
        "slug": "HUBSPOT_CREATE_QUOTE_OBJECT",
        "name": "Create quote object",
        "description": "Creates a new quote object in HubSpot CRM with specified properties and associations."
      },
      {
        "slug": "HUBSPOT_CREATE_TASK",
        "name": "Create task",
        "description": "Creates a new CRM task record. Use when adding a task with properties and optional associations."
      },
      {
        "slug": "HUBSPOT_CREATE_TICKET",
        "name": "Create ticket",
        "description": "Creates a new HubSpot ticket."
      },
      {
        "slug": "HUBSPOT_CREATE_TICKETS",
        "name": "Create tickets",
        "description": "Creates multiple HubSpot tickets in a batch, each with its own properties and associations; `inputs` list must not be empty, each item needs `properties`, and associations/custom properties must be validly defined using internal names for custom fields and ISO 8601 for dates."
      },
      {
        "slug": "HUBSPOT_CREATE_TIMELINE_EVENT",
        "name": "Create timeline event based on template",
        "description": "Creates an immutable custom timeline event on a CRM object's record using a specified, existing event template (identified by `eventTemplateId`), optionally updating CRM object properties if defined in the template; requires `email`, `utk`, or `objectId` for association."
      },
      {
        "slug": "HUBSPOT_CREATE_TIMELINE_EVENTS_BATCH",
        "name": "Create multiple timeline events batch",
        "description": "Creates multiple immutable timeline events in a batch, ideal for bulk data imports or real-time synchronizations, using a valid event template; may update CRM properties if the template is so configured."
      },
      {
        "slug": "HUBSPOT_CREATE_WORKFLOW",
        "name": "Create workflow",
        "description": "Creates a new HubSpot workflow to automate processes; ensure `enrollmentCriteria` and `actions` use properties relevant to the specified `objectTypeId`."
      },
      {
        "slug": "HUBSPOT_DELETE_CALL",
        "name": "Delete call",
        "description": "Permanently deletes a HubSpot call record by its ID. This action removes a call engagement from the CRM. Use this action when you need to remove a specific call record that is no longer needed or was created in error. This action is irreversible - the call record cannot be recovered once deleted."
      },
      {
        "slug": "HUBSPOT_DELETE_CALLING_EXTENSION_SETTINGS",
        "name": "Delete calling extension settings",
        "description": "Permanently deletes the settings for a calling extension app, specified by its `appId`, rendering it unusable for all connected HubSpot accounts; this operation is irreversible."
      },
      {
        "slug": "HUBSPOT_DELETE_CAMPAIGN",
        "name": "Delete campaign",
        "description": "Permanently deletes a marketing campaign from HubSpot using its `campaignGuid`; returns a 204 No Content status even if the campaign does not exist."
      },
      {
        "slug": "HUBSPOT_DELETE_CAMPAIGNS_BATCH",
        "name": "Archive a batch of campaigns",
        "description": "Archives a batch of up to 50 marketing campaigns, hiding them from active views rather than permanently deleting them."
      },
      {
        "slug": "HUBSPOT_DELETE_COMPANY_GDPR",
        "name": "Permanently delete company for GDPR compliance",
        "description": "Permanently deletes a company (identified by objectId) and its associated data from HubSpot for GDPR compliance; this action is irreversible and requires the company to exist."
      },
      {
        "slug": "HUBSPOT_DELETE_CONTACT_GDPR",
        "name": "Permanently delete contact for GDPR compliance",
        "description": "Irreversibly erases a HubSpot contact and associated data per a GDPR request; if an email is given for a non-existent contact, it's blocklisted."
      },
      {
        "slug": "HUBSPOT_DELETE_DEAL_GDPR",
        "name": "Archive deal (GDPR permanent delete not supported for deals)",
        "description": "Archives a HubSpot deal by its ID. Note: HubSpot's GDPR permanent deletion API only supports contacts, not deals. This action archives the deal (moves to recycling bin for 90 days) as the closest available functionality."
      },
      {
        "slug": "HUBSPOT_DELETE_LINE_ITEMS_GDPR",
        "name": "Permanently delete line items for gdpr",
        "description": "Permanently deletes a specified line item and its associated content for GDPR compliance; this action is irreversible and cannot be undone."
      },
      {
        "slug": "HUBSPOT_DELETE_MARKETING_EMAIL",
        "name": "Delete a marketing email",
        "description": "Permanently deletes a marketing email from your HubSpot account. This action cannot be undone."
      },
      {
        "slug": "HUBSPOT_DELETE_MEETING",
        "name": "Delete meeting",
        "description": "Permanently deletes (archives) a HubSpot meeting by its ID, moving it to the recycling bin where it can be restored within 90 days. Use this action when you need to remove a meeting engagement from HubSpot's CRM. This action is irreversible via the API — the meeting cannot be recovered programmatically once deleted."
      },
      {
        "slug": "HUBSPOT_DELETE_NOTE",
        "name": "Delete note",
        "description": "Archives a HubSpot note by its ID, removing it from active view. The note is archived rather than permanently deleted and can be restored within 90 days. Use this action when you need to remove a note from the CRM without permanently deleting it. This action is irreversible through the API - archived notes cannot be restored programmatically."
      },
      {
        "slug": "HUBSPOT_DELETE_PIPELINE",
        "name": "Delete pipeline by id",
        "description": "Permanently deletes a HubSpot pipeline and all its stages by `pipelineId` and `objectType`; this is irreversible, so use validation flags to avoid errors if the pipeline is not empty."
      },
      {
        "slug": "HUBSPOT_DELETE_PIPELINE_STAGE",
        "name": "Delete pipeline stage by id",
        "description": "Permanently deletes a specific pipeline stage for an `objectType` (e.g., 'deals', 'tickets') that supports pipelines; this operation is irreversible, so ensure no active CRM records are associated with the stage to prevent data issues."
      },
      {
        "slug": "HUBSPOT_DELETE_SCHEMA",
        "name": "Delete schema by object type",
        "description": "Deletes a HubSpot custom object schema by `objectType`. With `archived=false` (default), it archives the schema (soft delete). With `archived=true`, it permanently deletes an already-archived schema (hard delete). Prerequisites: All object instances, associations, and properties must be deleted first."
      },
      {
        "slug": "HUBSPOT_DELETE_TASK",
        "name": "Delete task",
        "description": "Archives a HubSpot task by its ID, removing it from active task lists. Use this action when you need to delete or remove a task from HubSpot CRM. The task is archived rather than permanently deleted and may be recoverable. This action is irreversible from the API perspective — the task cannot be directly unarchived via this action."
      },
      {
        "slug": "HUBSPOT_DELETE_TIMELINE_EVENT_TEMPLATE",
        "name": "Delete timeline event template",
        "description": "Permanently and irreversibly deletes a specific timeline event template, identified by its `eventTemplateId`, from the application `appId`."
      },
      {
        "slug": "HUBSPOT_DELETE_VIDEO_CONFERENCING_APP_SETTINGS",
        "name": "Delete video conferencing app settings",
        "description": "Irreversibly deletes all settings for a video conferencing application identified by its `appId` in HubSpot, removing its configuration and preventing it from functioning until reconfigured; existing meetings and historical data are unaffected. Note: This API requires developer API key (hapikey) authentication from your HubSpot developer account, not OAuth tokens."
      },
      {
        "slug": "HUBSPOT_DELETE_WORKFLOW",
        "name": "Delete workflow",
        "description": "Permanently deletes a HubSpot workflow by its ID; deleted workflows cannot be restored via the API and the ID must exist."
      },
      {
        "slug": "HUBSPOT_FETCH_IMPORT_ERROR_DETAILS",
        "name": "Fetch import error details",
        "description": "Fetches a paginated list of read-only error details for a specific HubSpot CRM import, requiring a valid `importId` for a processed import."
      },
      {
        "slug": "HUBSPOT_FETCH_RECORDING_SETTINGS",
        "name": "Fetch recording settings by app ID",
        "description": "Fetches call recording settings for a specified, existing HubSpot calling extension app."
      },
      {
        "slug": "HUBSPOT_FETCH_REVENUE",
        "name": "Fetch revenue",
        "description": "Fetches a revenue attribution report for a specified, existing marketing campaign, optionally using a specific attribution model and date range; if both start and end dates are given, `endDate` must not be earlier than `startDate`."
      },
      {
        "slug": "HUBSPOT_GET_AB_EMAIL_VARIATION",
        "name": "Get the variation of an A/B marketing email",
        "description": "Retrieves the alternate variation of a specified A/B marketing email; the `emailId` must identify an email currently in an A/B test. Requires Marketing Hub Professional or Enterprise subscription."
      },
      {
        "slug": "HUBSPOT_GET_ACCOUNT_INFO",
        "name": "Get Account Information",
        "description": "Gets current HubSpot account info (email, hubId, user details) using access-token lookup."
      },
      {
        "slug": "HUBSPOT_GET_ACTIVE_IMPORTS_LIST",
        "name": "Get active imports list",
        "description": "Retrieves a list of currently active import jobs in HubSpot for monitoring ongoing data operations."
      },
      {
        "slug": "HUBSPOT_GET_AGGREGATED_STATISTIC_INTERVALS",
        "name": "Get aggregated statistic intervals",
        "description": "Retrieves aggregated statistics for marketing emails (e.g., send counts), grouped by specified time intervals within a defined time range."
      },
      {
        "slug": "HUBSPOT_GET_AGGREGATED_STATISTICS",
        "name": "Get aggregated statistics",
        "description": "Retrieves aggregated statistics for marketing emails, optionally within an ISO8601 formatted time range, by email IDs, or specific email properties."
      },
      {
        "slug": "HUBSPOT_GET_ALL_MARKETING_EMAILS_FOR_A_HUBSPOT_ACCOUNT",
        "name": "Get all marketing emails for a HubSpot account",
        "description": "Fetches a list of marketing emails from a HubSpot account, with options for filtering, sorting, pagination, and including performance statistics."
      },
      {
        "slug": "HUBSPOT_GET_CAMPAIGN",
        "name": "Get campaign",
        "description": "Retrieves a HubSpot campaign by its ID."
      },
      {
        "slug": "HUBSPOT_GET_CAMPAIGN_METRICS",
        "name": "Get campaign metrics",
        "description": "Retrieves key attribution metrics for an existing marketing campaign, identified by its `campaignGuid`, within an optional date range."
      },
      {
        "slug": "HUBSPOT_GET_CAMPAIGNS",
        "name": "Get campaigns",
        "description": "Retrieves multiple HubSpot campaigns."
      },
      {
        "slug": "HUBSPOT_GET_COMPANY",
        "name": "Get company",
        "description": "Retrieves a HubSpot company by its ID."
      },
      {
        "slug": "HUBSPOT_GET_CONTACT_IDS",
        "name": "Get contact IDs",
        "description": "Fetches a list of contact IDs for a specific HubSpot campaign based on interaction type."
      },
      {
        "slug": "HUBSPOT_GET_DEAL",
        "name": "Get deal",
        "description": "Retrieves a HubSpot deal by its ID."
      },
      {
        "slug": "HUBSPOT_GET_DEALS",
        "name": "Get deals",
        "description": "Retrieves multiple HubSpot deals by their IDs in a single batch request."
      },
      {
        "slug": "HUBSPOT_GET_EMAILS",
        "name": "Get emails",
        "description": "Retrieves multiple HubSpot email engagement records by their IDs in a single batch request."
      },
      {
        "slug": "HUBSPOT_GET_EVENT_TEMPLATE",
        "name": "Get specific event template for app",
        "description": "Retrieves detailed information about a specific event template for a given application in HubSpot's CRM timeline."
      },
      {
        "slug": "HUBSPOT_GET_IMPORT_RECORD_INFORMATION",
        "name": "Get import record information",
        "description": "Retrieves a comprehensive summary of a specific HubSpot CRM import record by its `importId`, including status, progress, updates, results, and errors; useful for monitoring and troubleshooting data imports."
      },
      {
        "slug": "HUBSPOT_GET_MARKETING_EMAIL_DRAFT",
        "name": "Get draft version of a marketing email",
        "description": "Retrieves the draft version of a marketing email by its `emailId`; if no draft exists, returns the published version."
      },
      {
        "slug": "HUBSPOT_GET_MARKETING_EMAIL_REVISION",
        "name": "Get a revision of a marketing email",
        "description": "Retrieves a specific, previously saved revision of a marketing email using its unique email ID and revision ID."
      },
      {
        "slug": "HUBSPOT_GET_MARKETING_EMAIL_REVISIONS",
        "name": "Get revisions of a marketing email",
        "description": "Retrieves a paginated list of all historical versions (including full state like content, settings, metadata) for a specified, existing marketing email; revision ID -1 identifies the current version."
      },
      {
        "slug": "HUBSPOT_GET_PIPELINE_BY_ID",
        "name": "Return pipeline by id",
        "description": "Retrieves a specific pipeline by its ID and CRM object type, detailing its stages and properties."
      },
      {
        "slug": "HUBSPOT_GET_PIPELINE_STAGE_AUDIT",
        "name": "Get pipeline stage audit",
        "description": "Retrieves a reverse chronological list of all mutations (changes) for a specific pipeline stage, including CREATE and UPDATE events with timestamps and details."
      },
      {
        "slug": "HUBSPOT_GET_PRODUCT",
        "name": "Get product",
        "description": "Retrieves a HubSpot product by its ID."
      },
      {
        "slug": "HUBSPOT_GET_PRODUCTS",
        "name": "Get products",
        "description": "Retrieves multiple HubSpot products by their IDs."
      },
      {
        "slug": "HUBSPOT_GET_QUOTE",
        "name": "Get quote by id",
        "description": "Retrieves a specific HubSpot quote by its unique identifier."
      },
      {
        "slug": "HUBSPOT_GET_SEGMENT_MEMBERS",
        "name": "Get segment members",
        "description": "Tool to retrieve segment (list) members ordered by join timestamp. Use when you need to page through list membership data."
      },
      {
        "slug": "HUBSPOT_GET_THE_DETAILS_OF_A_SPECIFIED_MARKETING_EMAIL",
        "name": "Get the details of a specified marketing email",
        "description": "Retrieves detailed information for a specific marketing email in HubSpot using its unique email ID, optionally including performance statistics and specific properties."
      },
      {
        "slug": "HUBSPOT_GET_TICKET",
        "name": "Get ticket",
        "description": "Retrieves a HubSpot ticket by its ID."
      },
      {
        "slug": "HUBSPOT_GET_TICKETS",
        "name": "Get tickets",
        "description": "Retrieves multiple HubSpot tickets by their IDs."
      },
      {
        "slug": "HUBSPOT_GET_WORKFLOW_BY_ID",
        "name": "Get workflow by ID",
        "description": "Retrieves comprehensive details for an existing HubSpot workflow by its unique ID; unsupported actions are designated 'UNSUPPORTED_ACTION' in the response."
      },
      {
        "slug": "HUBSPOT_GET_WORKFLOWS",
        "name": "Get all workflows",
        "description": "Retrieves a list of workflow summaries (ID, name, type, status) from HubSpot, using the 'limit' parameter for pagination."
      },
      {
        "slug": "HUBSPOT_LIST_ASSETS",
        "name": "List assets",
        "description": "Lists assets of a specific `assetType` for a given HubSpot marketing `campaignGuid`, optionally including performance metrics for a date range."
      },
      {
        "slug": "HUBSPOT_LIST_ASSOCIATION_TYPES",
        "name": "List association types",
        "description": "Lists all valid association types between two specified HubSpot CRM object types."
      },
      {
        "slug": "HUBSPOT_LIST_COMPANIES",
        "name": "List companies",
        "description": "Retrieves a paginated list of HubSpot companies."
      },
      {
        "slug": "HUBSPOT_LIST_COMPANY_ACTIVITIES",
        "name": "List company activities",
        "description": "List all activity/engagement associations from a company to a specified activity type (calls, emails, meetings, notes, or tasks). Returns the IDs of associated engagement records. Use this action when you need to retrieve all activities of a specific type for a company to build a timeline or activity history."
      },
      {
        "slug": "HUBSPOT_LIST_COMPANY_CALLS",
        "name": "List company calls",
        "description": "Lists all calls associated with a specific HubSpot company. Returns call IDs and their association types with the company. Use this action when you need to retrieve all call activity records linked to a company without fetching full call details. For full call properties, use the returned call IDs with a call read action."
      },
      {
        "slug": "HUBSPOT_LIST_COMPANY_MEETINGS",
        "name": "List company meetings",
        "description": "List all meetings associated with a specific company in HubSpot. Returns meeting IDs and association metadata for meetings linked to the company record. Use this action when you need to retrieve all meetings scheduled with or related to a particular company."
      },
      {
        "slug": "HUBSPOT_LIST_CONTACT_NOTES",
        "name": "List contact notes",
        "description": "List all notes associated with a specific HubSpot contact. Returns note IDs and association metadata. Use this action when you need to retrieve all notes linked to a contact record. To get full note details (body, timestamp, etc.), use the note IDs with a batch read action."
      },
      {
        "slug": "HUBSPOT_LIST_CONTACT_PROPERTIES",
        "name": "List contact properties",
        "description": "Lists all contact properties in your HubSpot account, including custom properties you've created. Use this action to discover: - Available property names for updating contacts - Custom properties specific to your HubSpot account - Property types and valid options for enumeration fields - Which properties are read-only vs writable"
      },
      {
        "slug": "HUBSPOT_LIST_CONTACTS",
        "name": "List contacts",
        "description": "Retrieves a paginated list of HubSpot contacts."
      },
      {
        "slug": "HUBSPOT_LIST_CONTACT_TASKS",
        "name": "List contact tasks",
        "description": "List all tasks associated with a specific contact. Returns task IDs and association metadata for tasks linked to the given contact. Use this action when you need to retrieve all tasks related to a contact, such as viewing pending action items or following up on contact-related to-dos."
      },
      {
        "slug": "HUBSPOT_LIST_DEAL_ACTIVITIES",
        "name": "List deal activities",
        "description": "Retrieves activities (notes, calls, emails, meetings, tasks) associated with a specific HubSpot deal. Use this action when you need to view the complete activity timeline for a deal, including all engagement types. This provides a comprehensive view of interactions and communications related to the deal, which is useful for understanding deal history and next steps."
      },
      {
        "slug": "HUBSPOT_LIST_DEAL_MEETINGS",
        "name": "List deal meetings",
        "description": "List all meetings associated with a specific deal in HubSpot. Returns meeting IDs and association metadata. Use this action when you need to retrieve meetings linked to a deal without fetching full meeting details. This is useful for understanding deal activity, tracking customer interactions, or building reports of engagement touchpoints."
      },
      {
        "slug": "HUBSPOT_LIST_DEALS",
        "name": "List deals",
        "description": "Retrieves a paginated list of HubSpot deals."
      },
      {
        "slug": "HUBSPOT_LIST_EMAILS",
        "name": "List Emails",
        "description": "Retrieves a paginated list of HubSpot emails, allowing selection of specific properties (with or without history), associated object IDs, and filtering by archive status."
      },
      {
        "slug": "HUBSPOT_LIST_EVENT_TEMPLATES",
        "name": "List all event templates for app",
        "description": "Retrieves all event templates associated with a valid `appId` for an existing application in HubSpot's CRM Timeline."
      },
      {
        "slug": "HUBSPOT_LIST_FEEDBACK_SUBMISSIONS",
        "name": "List feedback submissions page",
        "description": "Retrieves a paginated list of feedback submissions from HubSpot, allowing specification of properties (including history), associated object IDs, and filtering by archive status."
      },
      {
        "slug": "HUBSPOT_LIST_GRANTED_SCOPES",
        "name": "List granted OAuth scopes",
        "description": "Tool to introspect the current OAuth access token and return its granted scopes and metadata. Use when you need to check which permissions are available before calling an endpoint (e.g., workflows, automation) to proactively detect missing scopes and provide clear remediation guidance."
      },
      {
        "slug": "HUBSPOT_LIST_OBJECT_ASSOCIATIONS",
        "name": "List object associations",
        "description": "List all associations from a single CRM record to a specified target object type. Use when you need to expand associations for a single record without fetching the full CRM object."
      },
      {
        "slug": "HUBSPOT_LIST_PRODUCTS",
        "name": "List products",
        "description": "Retrieves a paginated list of HubSpot products."
      },
      {
        "slug": "HUBSPOT_LIST_QUOTES",
        "name": "List quotes page",
        "description": "Retrieves a paginated list of quotes, allowing selection of specific properties, property history, associated object IDs, and filtering by archived status."
      },
      {
        "slug": "HUBSPOT_LIST_TICKETS",
        "name": "List tickets",
        "description": "Retrieves a paginated list of HubSpot tickets."
      },
      {
        "slug": "HUBSPOT_MERGE_COMPANIES",
        "name": "Merge two companies of same type",
        "description": "Merges two existing company records of the same type in HubSpot CRM, where `objectIdToMerge` is absorbed into `primaryObjectId`; this operation is irreversible."
      },
      {
        "slug": "HUBSPOT_MERGE_CONTACTS",
        "name": "Merge contacts",
        "description": "Merges two HubSpot contacts into one."
      },
      {
        "slug": "HUBSPOT_MERGE_DEALS",
        "name": "Merge deals",
        "description": "Merges two HubSpot deals into one."
      },
      {
        "slug": "HUBSPOT_MERGE_EMAILS",
        "name": "Merge emails",
        "description": "Merges two HubSpot emails into one."
      },
      {
        "slug": "HUBSPOT_MERGE_FEEDBACK_SUBMISSIONS",
        "name": "Merge two feedback submissions",
        "description": "Merges two existing feedback submissions by ID, primarily for consolidating duplicates or related feedback; this operation is irreversible, and `primaryObjectId` values take precedence in conflicts."
      },
      {
        "slug": "HUBSPOT_MERGE_LINE_ITEMS",
        "name": "Merge two line items of same type",
        "description": "Merges two line items, `objectIdToMerge` into `primaryObjectId`, which must be of the same type; `objectIdToMerge` is absorbed and the operation is irreversible."
      },
      {
        "slug": "HUBSPOT_MERGE_OBJECTS",
        "name": "Merge two objects of same type",
        "description": "Merges two distinct HubSpot CRM objects of the same `objectType`, consolidating data into `primaryObjectId` (which is preserved) and deleting `objectIdToMerge`; this operation is permanent and irreversible."
      },
      {
        "slug": "HUBSPOT_MERGE_PRODUCTS",
        "name": "Merge products",
        "description": "Merges two HubSpot products into one."
      },
      {
        "slug": "HUBSPOT_MERGE_QUOTES",
        "name": "Merge two quotes of same type",
        "description": "Merges two distinct quotes of the same type by consolidating `objectIdToMerge` into `primaryObjectId` (e.g., for combining information or updating terms); this operation is irreversible."
      },
      {
        "slug": "HUBSPOT_MERGE_TICKETS",
        "name": "Merge tickets",
        "description": "Merges two HubSpot tickets into one."
      },
      {
        "slug": "HUBSPOT_PARTIALLY_UPDATE_CRM_OBJECT_BY_ID",
        "name": "Partially update CRM object by ID",
        "description": "Partially updates specified properties of a CRM object (e.g., contact, company, deal) identified by its type and ID, or optionally by a unique property value if `idProperty` is specified."
      },
      {
        "slug": "HUBSPOT_PERMANENTLY_DELETE_CONTACT_VIA_GDPR",
        "name": "Permanently delete contact via GDPR",
        "description": "Permanently deletes a HubSpot contact and all its associated data for GDPR compliance, identifying the contact by its ID or another unique property."
      },
      {
        "slug": "HUBSPOT_PUBLISH_MARKETING_EMAIL",
        "name": "Publish or send a marketing email",
        "description": "Publishes or sends a specified HubSpot marketing email that is valid and ready for sending; requires Marketing Hub Enterprise or the transactional email add-on."
      },
      {
        "slug": "HUBSPOT_PURGE_SCHEMA",
        "name": "Purge schema by object type",
        "description": "Permanently and irreversibly deletes the schema for an existing `objectType` in HubSpot CRM; this deprecated endpoint should be used with extreme caution."
      },
      {
        "slug": "HUBSPOT_READ_A_CRM_PROPERTY_BY_NAME",
        "name": "Read a CRM property by name",
        "description": "Reads a specific CRM property definition for a given HubSpot object type by its internal name."
      },
      {
        "slug": "HUBSPOT_READ_ALL_PROPERTIES_FOR_OBJECT_TYPE",
        "name": "Read all properties for object type",
        "description": "Retrieves definitions and metadata (not actual values) for properties of a specified HubSpot CRM object type (e.g., 'contacts', 'companies', 'deals', or custom objects)."
      },
      {
        "slug": "HUBSPOT_READ_APAGE_OF_OBJECTS_BY_TYPE",
        "name": "Read a page of objects by type",
        "description": "Retrieves a paginated list of objects for a specified and valid HubSpot CRM object type (e.g., 'contacts', 'companies', 'deals', or custom ID)."
      },
      {
        "slug": "HUBSPOT_READ_ASSOCIATIONS_BATCH",
        "name": "Batch read associations",
        "description": "Tool to batch-read CRM associations (e.g., deals→contacts, deals→companies) for up to 1,000 source record IDs in one request. Use when you need to retrieve associated target IDs and association type metadata for multiple records efficiently, avoiding rate-limit issues from per-record GET calls."
      },
      {
        "slug": "HUBSPOT_READ_BATCH_CRM_OBJECT_PROPERTIES",
        "name": "Read a batch of CRM object properties",
        "description": "Retrieves property definitions (metadata) for a batch of CRM object properties for a specified object type. Returns detailed information about property structure, data types, options, and configuration—not the actual property values of CRM records."
      },
      {
        "slug": "HUBSPOT_READ_BATCH_FEEDBACK_SUBMISSIONS_BY_ID_OR_PROPERTY",
        "name": "Read batch feedback submissions by id or property",
        "description": "Retrieves up to 100 feedback submissions in a batch using their IDs or a specified unique `idProperty`, optionally including specified properties and their history."
      },
      {
        "slug": "HUBSPOT_READ_BATCH_OF_CRM_OBJECTS_BY_ID_OR_PROPERTY_VALUES",
        "name": "Read batch of crm objects by id or property values",
        "description": "Reads a batch of CRM objects of a specified `objectType` using their HubSpot IDs or unique property values from the `inputs` list, allowing retrieval of specific `properties`, their historical values (`propertiesWithHistory`), and filtering by `archived` status."
      },
      {
        "slug": "HUBSPOT_READ_BATCH_OF_LINE_ITEMS_BY_ID_OR_PROPERTY_VALUES",
        "name": "Read batch of line items by id or property values",
        "description": "Retrieves a batch of HubSpot CRM line items by their IDs, or optionally by values of a custom unique property defined in `idProperty`."
      },
      {
        "slug": "HUBSPOT_READ_BATCH_OF_QUOTES_BY_PROPERTY_VALUES",
        "name": "Read batch of quotes by property values",
        "description": "Efficiently retrieves a batch of HubSpot CRM quotes by their IDs (or a specified unique property), optionally including archived quotes, specific properties, and property history."
      },
      {
        "slug": "HUBSPOT_READ_BUDGET",
        "name": "Read budget",
        "description": "Fetches detailed budget (total, spent, remaining) and spend information for a marketing campaign, including an 'order' field for sequencing budget/spend items (0 is oldest)."
      },
      {
        "slug": "HUBSPOT_READ_CONTACT",
        "name": "Read contact",
        "description": "Retrieves a HubSpot contact by its ID."
      },
      {
        "slug": "HUBSPOT_READ_CONTACTS",
        "name": "Read contacts",
        "description": "Batch read multiple HubSpot contacts by their IDs or custom identifier property. This action retrieves up to 100 contacts per request using the HubSpot CRM batch read API. You can specify which contact properties to return and optionally include historical values for properties."
      },
      {
        "slug": "HUBSPOT_READ_CRM_OBJECT_BY_ID",
        "name": "Read crm object by id",
        "description": "Retrieves a specific CRM object (e.g., contact, company, deal, ticket) by its ID or a unique property, optionally including specific properties, history, and associations."
      },
      {
        "slug": "HUBSPOT_READ_EMAIL",
        "name": "ReadEmail Email",
        "description": "Call this to retrieve an existing HubSpot email by its `emailId` or an alternative unique `idProperty`."
      },
      {
        "slug": "HUBSPOT_READ_FEEDBACK_SUBMISSION_BY_ID",
        "name": "Read feedback submission by id",
        "description": "Reads a HubSpot feedback submission by its ID, optionally using a custom unique 'idProperty', and allows specifying properties to return including history and associations."
      },
      {
        "slug": "HUBSPOT_READ_PROPERTY_GROUP",
        "name": "Read a property group",
        "description": "Retrieves metadata for a specific property group of a given CRM object type, detailing its structure and attributes, but not the actual property values of CRM objects."
      },
      {
        "slug": "HUBSPOT_READ_PROPERTY_GROUPS_FOR_OBJECT_TYPE",
        "name": "Read property groups for object type",
        "description": "Retrieves all property groups in a single call for a specified HubSpot CRM object type (e.g., 'contacts', 'companies'), returning only the groups themselves, not the individual properties within them."
      },
      {
        "slug": "HUBSPOT_REMOVE_ASSET_ASSOCIATION",
        "name": "Remove asset association",
        "description": "Disassociates an asset from a HubSpot marketing campaign. Supports a wide range of asset types including forms, landing pages, emails, blog posts, workflows, static lists, and more."
      },
      {
        "slug": "HUBSPOT_REMOVE_ASSOCIATION",
        "name": "Remove association between CRM records",
        "description": "Tool to remove all associations between two CRM records using the v4 associations endpoint. Use when unlinking records or cleaning up incorrect associations."
      },
      {
        "slug": "HUBSPOT_REMOVE_ASSOCIATION_FROM_SCHEMA",
        "name": "Remove association from schema",
        "description": "Permanently removes a specified association definition (type) from a HubSpot object's schema, preventing future creations of this association type without affecting existing instances."
      },
      {
        "slug": "HUBSPOT_REMOVE_DEAL",
        "name": "Remove deal",
        "description": "Removes a HubSpot deal by its ID."
      },
      {
        "slug": "HUBSPOT_REMOVE_TOKEN_FROM_EVENT_TEMPLATE",
        "name": "Remove token from event template",
        "description": "Removes a token from a HubSpot event template, preventing its inclusion in new events created from that template."
      },
      {
        "slug": "HUBSPOT_RENDER_EVENT_DETAIL_TEMPLATE",
        "name": "Render event detail template",
        "description": "Renders detailed information for a specific HubSpot CRM timeline event using a predefined event template, ignoring `extraData` references in the template not present in event data."
      },
      {
        "slug": "HUBSPOT_RENDER_EVENT_HEADER_OR_DETAIL_AS_HTML",
        "name": "Render event header or detail as html",
        "description": "Renders an event's header or detail template as HTML for a specified event on the HubSpot CRM timeline, using a given event template ID and event ID."
      },
      {
        "slug": "HUBSPOT_REPLACE_ALL_PROPERTIES_OF_PIPELINE",
        "name": "Replace all properties of pipeline",
        "description": "Overwrites an entire CRM pipeline (specified by `objectType` and `pipelineId`) and all its stages with a new definition, returning the updated pipeline."
      },
      {
        "slug": "HUBSPOT_REPLACE_PIPELINE_STAGE_PROPERTIES",
        "name": "Replace pipeline stage properties",
        "description": "Replaces all properties of a specified pipeline stage; the new `label` must be unique within the pipeline, and if `objectType` is 'deals', the `metadata` must include a 'probability' key."
      },
      {
        "slug": "HUBSPOT_RESET_DRAFT",
        "name": "Reset draft",
        "description": "Resets a marketing email's draft to its currently published (live) version, discarding all unpublished changes; the email must have a live version to revert to."
      },
      {
        "slug": "HUBSPOT_RESTORE_EMAIL_REVISION",
        "name": "Restore a revision of a marketing email to draft state",
        "description": "Restores a specific revision of a marketing email to a DRAFT state, overwriting any existing draft."
      },
      {
        "slug": "HUBSPOT_RESTORE_MARKETING_EMAIL_REVISION",
        "name": "Restore a revision of a marketing email",
        "description": "Restores a specific, existing, non-active revision of a marketing email to become the new live version for that email."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_ALL_OBJECT_SCHEMAS",
        "name": "Retrieve all object schemas",
        "description": "Retrieves all object schema definitions (not data records) for a HubSpot account, supporting retrieval of either active or archived schemas."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_ALL_PIPELINES_FOR_SPECIFIED_OBJECT_TYPE",
        "name": "Retrieve all pipelines for specified object type",
        "description": "Retrieves all pipelines in HubSpot for a specified CRM object type, such as deals or tickets."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_CALLING_SETTINGS_FOR_APP",
        "name": "Retrieve calling settings for app",
        "description": "Retrieves the read-only calling extension settings for a specific HubSpot app; the app must exist and have calling extensions configured."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_LINE_ITEM_BY_ID",
        "name": "Retrieve line item by id",
        "description": "Retrieves a HubSpot CRM line item by its ID or a specified unique property (`idProperty`)."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_LINE_ITEMS",
        "name": "Retrieve line items list",
        "description": "Fetches a paginated list of HubSpot CRM line items, allowing selection of specific properties (including history), associated object IDs, and filtering by archive status; ensure property and association names are valid HubSpot internal names."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_OBJECT_SCHEMA",
        "name": "Retrieve existing object schema",
        "description": "Fetches the detailed schema definition for a specified, existing standard or custom HubSpot CRM object type; this action is read-only and does not create or modify schemas."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_OWNER_BY_ID_OR_USER_ID",
        "name": "Retrieve owner by ID or user ID",
        "description": "Retrieves a specific HubSpot CRM owner by their ID, with options to specify ID type (owner or user) and to include archived records."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_OWNERS",
        "name": "Retrieve owners",
        "description": "Retrieves a list of all owners in the HubSpot CRM, including their ID, first name, last name, email, and user ID."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_PAGE_OF_CRM_OWNERS",
        "name": "Retrieve page of crm owners",
        "description": "Retrieves a paginated list of CRM owners from HubSpot, optionally filtering by email or archived status."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_PIPELINE_STAGE_BY_ID",
        "name": "Retrieve pipeline stage by id",
        "description": "Fetches detailed properties and metadata (e.g., label, display order, custom properties) for a specific stage within a HubSpot CRM pipeline, identified by its `objectType`, `pipelineId`, and `stageId`."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_PIPELINE_STAGES",
        "name": "Retrieve pipeline stages",
        "description": "Fetches all stages for a specified HubSpot CRM object type and pipeline ID."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_TIMELINE_EVENT_BY_IDS",
        "name": "Retrieve timeline event by ids",
        "description": "Retrieves a specific HubSpot CRM timeline event by its application ID, event template ID, and event ID, returning event details including timestamp, tokens, and associated object information."
      },
      {
        "slug": "HUBSPOT_RETRIEVE_VIDEO_CONFERENCE_SETTINGS_BY_ID",
        "name": "Retrieve video conference settings by id",
        "description": "Retrieves video conference application settings, such as webhook URLs and user/account management configurations, for a specified `appId`."
      },
      {
        "slug": "HUBSPOT_SEARCH_CAMPAIGNS",
        "name": "Search campaigns",
        "description": "Searches for HubSpot campaigns."
      },
      {
        "slug": "HUBSPOT_SEARCH_COMPANIES",
        "name": "Search companies",
        "description": "Searches for HubSpot companies using flexible criteria and filters."
      },
      {
        "slug": "HUBSPOT_SEARCH_CONTACTS_BY_CRITERIA",
        "name": "Search contacts by criteria",
        "description": "Searches for HubSpot contacts using a text query, specific filter criteria (filters in a group are ANDed, groups are ORed), sorting, and pagination to retrieve selected properties."
      },
      {
        "slug": "HUBSPOT_SEARCH_CRM_OBJECTS_BY_CRITERIA",
        "name": "Search crm objects by criteria",
        "description": "Searches HubSpot CRM objects (e.g., 'contacts', 'companies') by `objectType` using complex criteria including filters, sorting, and pagination; property names used in filters, sorts, and returned properties must be valid for the specified `objectType`."
      },
      {
        "slug": "HUBSPOT_SEARCH_DEALS",
        "name": "Search deals",
        "description": "Searches for HubSpot deals using flexible criteria and filters."
      },
      {
        "slug": "HUBSPOT_SEARCH_EMAILS",
        "name": "Search emails",
        "description": "Searches for HubSpot emails using flexible criteria and filters."
      },
      {
        "slug": "HUBSPOT_SEARCH_FEEDBACK_SUBMISSIONS",
        "name": "Search feedback submissions",
        "description": "Searches for feedback submissions in HubSpot CRM using text query, filter groups, sorting, and pagination, returning specified properties."
      },
      {
        "slug": "HUBSPOT_SEARCH_LINE_ITEMS_BY_CRITERIA",
        "name": "Search line items by criteria",
        "description": "Searches HubSpot line items using criteria including filters, sorting, and pagination; `after` must be a valid cursor from a previous response, and `sorts`/`properties` must refer to valid line item property names."
      },
      {
        "slug": "HUBSPOT_SEARCH_PRODUCTS",
        "name": "Search products",
        "description": "Searches for HubSpot products using flexible criteria and filters."
      },
      {
        "slug": "HUBSPOT_SEARCH_QUOTES_BY_CRITERIA",
        "name": "Search quotes by criteria",
        "description": "Searches HubSpot CRM quotes using a text query, complex filter criteria, sorting, and pagination."
      },
      {
        "slug": "HUBSPOT_SEARCH_TICKETS",
        "name": "Search tickets",
        "description": "Searches for HubSpot tickets using flexible criteria and filters."
      },
      {
        "slug": "HUBSPOT_SET_CALL_RECORDING_SETTINGS",
        "name": "Set call recording settings",
        "description": "Configures the URL (`urlToRetrieveAuthedRecording`) that HubSpot uses to retrieve call recordings for a specified third-party calling app (`appId`). The URL must contain a %s placeholder which HubSpot replaces with the engagement's externalId. The calling app must be an existing calling extension app integrated with the HubSpot account."
      },
      {
        "slug": "HUBSPOT_START_IMPORT",
        "name": "Initiate data import process",
        "description": "Call this action to start an asynchronous data import into HubSpot CRM using uploaded files and a detailed `importRequest` JSON configuration, ensuring this JSON correctly maps file columns to HubSpot properties and files align with these mappings."
      },
      {
        "slug": "HUBSPOT_UPDATE_A_MARKETING_EMAIL",
        "name": "Update a marketing email",
        "description": "Updates properties of an existing marketing email identified by its `emailId`; unspecified fields retain their current values."
      },
      {
        "slug": "HUBSPOT_UPDATE_BATCH_FEEDBACK_SUBMISSIONS",
        "name": "Update batch feedback submissions",
        "description": "Updates a batch of HubSpot feedback submissions; property keys must be existing internal HubSpot names and values must be correctly formatted strings."
      },
      {
        "slug": "HUBSPOT_UPDATE_BATCH_OF_OBJECTS_BY_IDOR_PROPERTY_VALUES",
        "name": "Update a batch of objects by id or property values",
        "description": "Performs a batch update on a valid `objectType` where properties are writeable and any `idProperty` used is designated unique; updates can be partial."
      },
      {
        "slug": "HUBSPOT_UPDATE_CALLING_APP_RECORDING_SETTINGS",
        "name": "Update calling app recording settings",
        "description": "Updates the recording settings, such as the URL for retrieving authenticated recordings, for a specific calling extension app identified by its `appId`."
      },
      {
        "slug": "HUBSPOT_UPDATE_CALLING_EXTENSION_SETTINGS",
        "name": "Modify calling extension settings",
        "description": "Updates settings (e.g., display name, UI URL/dimensions, feature flags) for an existing calling extension app, identified by `appId`."
      },
      {
        "slug": "HUBSPOT_UPDATE_CAMPAIGN",
        "name": "Update campaign",
        "description": "Partially updates specific, writable properties of an existing HubSpot marketing campaign identified by `campaignGuid`; an empty string value in `properties` clears a property."
      },
      {
        "slug": "HUBSPOT_UPDATE_CAMPAIGNS",
        "name": "Update a batch of campaigns",
        "description": "Updates properties for up to 50 existing HubSpot marketing campaigns in a single batch operation."
      },
      {
        "slug": "HUBSPOT_UPDATE_COMPANIES",
        "name": "Update companies",
        "description": "Updates multiple HubSpot companies in a single batch operation."
      },
      {
        "slug": "HUBSPOT_UPDATE_COMPANY",
        "name": "Update company",
        "description": "Updates properties for an existing HubSpot company."
      },
      {
        "slug": "HUBSPOT_UPDATE_CONTACT",
        "name": "Update contact",
        "description": "Updates properties for an existing HubSpot contact."
      },
      {
        "slug": "HUBSPOT_UPDATE_CONTACTS",
        "name": "Update contacts",
        "description": "Updates multiple HubSpot contacts in a single batch operation."
      },
      {
        "slug": "HUBSPOT_UPDATE_CRM_PROPERTY",
        "name": "Update specific CRM property",
        "description": "Updates attributes of an existing HubSpot CRM property, identified by its `objectType` and `propertyName`; only provided fields are modified, and changing a property's `type` can cause data loss if incompatible with existing data."
      },
      {
        "slug": "HUBSPOT_UPDATE_DEAL",
        "name": "Update deal",
        "description": "Updates properties for an existing HubSpot deal."
      },
      {
        "slug": "HUBSPOT_UPDATE_DEALS",
        "name": "Update deals",
        "description": "Updates multiple HubSpot deals in a single batch operation."
      },
      {
        "slug": "HUBSPOT_UPDATE_EMAIL",
        "name": "UpdateEmail Email",
        "description": "Partially updates properties of an existing HubSpot email object, identified by `emailId` (as internal ID or custom unique property value if `idProperty` is given); the object must exist."
      },
      {
        "slug": "HUBSPOT_UPDATE_EMAILS",
        "name": "Update emails",
        "description": "Updates multiple HubSpot emails in a single batch operation."
      },
      {
        "slug": "HUBSPOT_UPDATE_EVENT_TEMPLATE",
        "name": "Update existing event template",
        "description": "Updates an existing HubSpot event template's name, display templates, and tokens; providing `tokens` replaces the entire existing list, and the `id` in the request body must match `eventTemplateId` in the path."
      },
      {
        "slug": "HUBSPOT_UPDATE_FEEDBACK_SUBMISSION",
        "name": "Update feedback submission by id",
        "description": "Partially updates writable properties of an existing HubSpot Feedback Submission, identified by its `feedbackSubmissionId` (which can be an internal object ID, or a unique property value if `idProperty` is specified)."
      },
      {
        "slug": "HUBSPOT_UPDATE_LINE_ITEM",
        "name": "Update line item object partially",
        "description": "Partially updates specified properties of an existing HubSpot Line Item, identified by `lineItemId` (as HubSpot object ID or value of `idProperty` if used); new values overwrite existing ones, and an empty string clears a property."
      },
      {
        "slug": "HUBSPOT_UPDATE_LINE_ITEMS",
        "name": "Update a batch of line items",
        "description": "Updates a batch of existing HubSpot CRM line items in a single operation, identifying each by its primary ID or a unique `idProperty` (which must be a unique identifier property in HubSpot), and modifies their specified properties."
      },
      {
        "slug": "HUBSPOT_UPDATE_OBJECT_SCHEMA",
        "name": "Update existing object schema",
        "description": "Updates an existing custom object schema's metadata in HubSpot, such as its description, labels, display properties, required properties, searchable properties, and restorability, for a specified `objectType` that must already exist."
      },
      {
        "slug": "HUBSPOT_UPDATE_PIPELINE",
        "name": "Partially update pipeline by id",
        "description": "Partially updates a CRM pipeline's label, display order, or restores an archived pipeline by setting `archived` to `false`."
      },
      {
        "slug": "HUBSPOT_UPDATE_PIPELINE_STAGE",
        "name": "Update pipeline stage by ids",
        "description": "Partially updates a HubSpot CRM pipeline stage identified by `objectType`, `pipelineId`, and `stageId`, requiring `metadata` in the request; unspecified fields are unchanged."
      },
      {
        "slug": "HUBSPOT_UPDATE_PRODUCT",
        "name": "Update product",
        "description": "Updates properties for an existing HubSpot product."
      },
      {
        "slug": "HUBSPOT_UPDATE_PRODUCTS",
        "name": "Update products",
        "description": "Updates multiple HubSpot products in a single batch operation."
      },
      {
        "slug": "HUBSPOT_UPDATE_PROPERTY_GROUP",
        "name": "Partially update property group",
        "description": "Partially updates a property group's `displayOrder` or `label` for a specified CRM `objectType` in HubSpot."
      },
      {
        "slug": "HUBSPOT_UPDATE_QUOTE",
        "name": "Partial update quote by quote id",
        "description": "Performs a partial update on an existing HubSpot quote's specified properties, identifying the quote by `quoteId` (either its internal ID or a custom unique property value if `idProperty` is provided)."
      },
      {
        "slug": "HUBSPOT_UPDATE_TICKET",
        "name": "Update ticket",
        "description": "Updates properties for an existing HubSpot ticket."
      },
      {
        "slug": "HUBSPOT_UPDATE_TICKETS",
        "name": "Update tickets",
        "description": "Updates multiple HubSpot tickets in a single batch operation."
      },
      {
        "slug": "HUBSPOT_UPDATE_TOKEN_ON_EVENT_TEMPLATE",
        "name": "Update token on event template",
        "description": "Updates the label or options of an existing token within a specified HubSpot CRM event template; token name and data type remain unchanged."
      },
      {
        "slug": "HUBSPOT_UPDATE_VIDEO_CONFERENCE_APP_SETTINGS",
        "name": "Update video conference app settings",
        "description": "Updates webhook URLs (for creating/updating/deleting meetings, fetching accounts, verifying users) for a video conference application specified by `appId`. Requires developer API key authentication. All URLs must use HTTPS protocol and be publicly accessible."
      }
    ],
    "triggers": [
      {
        "slug": "HUBSPOT_CONTACT_CREATED_TRIGGER",
        "name": "Contact Created Trigger",
        "description": "Contact Created Trigger"
      },
      {
        "slug": "HUBSPOT_DEAL_STAGE_UPDATED_TRIGGER",
        "name": "Deal Stage UpdatedTrigger",
        "description": "Deal Stage UpdatedTrigger"
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "hubspot_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "account-info.security.read,accounting,cms.domains.read,cms.domains.write,crm.export,crm.import,crm.lists.read,crm.lists.write,crm.objects.companies.read,crm.objects.companies.write,crm.objects.contacts.read,crm.objects.contacts.write,crm.objects.deals.read,crm.objects.deals.write,crm.objects.marketing_events.read,crm.objects.marketing_events.write,crm.objects.owners.read,crm.objects.quotes.read,crm.objects.quotes.write,crm.schemas.companies.read,crm.schemas.companies.write,crm.schemas.contacts.read,crm.schemas.contacts.write,oauth,settings.users.read,settings.users.write,tickets,timeline,e-commerce,crm.objects.custom.read,crm.schemas.custom.read,content,sales-email-read"
              },
              {
                "name": "optional_scopes",
                "displayName": "Optional Scopes",
                "type": "string",
                "description": "Additional HubSpot OAuth scopes to request through the optional_scopes authorization parameter. Every scope listed here must be enabled as an optional scope in your HubSpot developer app; HubSpot will reject the customer's authorization attempt if any requested scope is not activated. Enter scope names separated by spaces, for example \"transactional-email automation marketing.campaigns.read marketing.campaigns.write\". For available scopes and app configuration details, see https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/scopes.",
                "required": false,
                "default": "transactional-email automation marketing.campaigns.read marketing.campaigns.write"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      },
      {
        "mode": "API_KEY",
        "name": "hubspot_api_key",
        "fields": {
          "auth_config_creation": {
            "required": [],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "generic_api_key",
                "displayName": "API Key",
                "type": "string",
                "description": "Your HubSpot private app access token, starting with 'pat-'. In HubSpot, go to Settings → Integrations → Private Apps, open or create an app, and click 'Show token'.",
                "required": true,
                "default": null
              }
            ],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "linear",
    "name": "Linear",
    "logo": "https://logos.composio.dev/api/linear",
    "description": "Linear is a streamlined issue tracking and project planning tool for modern teams, featuring fast workflows, keyboard shortcuts, and GitHub integrations",
    "category": "project management",
    "authSchemes": [
      "OAUTH2",
      "API_KEY"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 47,
    "triggerCount": 12,
    "version": "20260908_00",
    "tools": [
      {
        "slug": "LINEAR_ARCHIVE_ISSUE",
        "name": "Archive issue",
        "description": "Archives an existing Linear issue by its ID, removing it from active views while preserving its data for future reference. Use this action when you need to remove an issue from active work without permanently deleting it — for example, when an issue is no longer relevant, was created by mistake, or has been superseded by another issue. Archiving is reversible via the unarchive mutation, unlike permanent deletion. This action is irreversible through the API once completed, though issues can be manually unarchived in the Linear UI or via the issueUnarchive mutation."
      },
      {
        "slug": "LINEAR_ARCHIVE_PROJECT",
        "name": "Archive Project",
        "description": "Archives an existing Linear project by its UUID, removing it from active views. Use this action when you need to mark a completed or obsolete project as archived. Archiving is reversible (projects can be unarchived later), but confirm the project name with the user before executing, especially in bulk operations."
      },
      {
        "slug": "LINEAR_ARCHIVE_PROJECT_UPDATE",
        "name": "Archive Project Update",
        "description": "Archives a project update in Linear, hiding it from the default view while preserving its data. Use this action when you need to clean up old or obsolete project status updates without permanently deleting them. Archived updates can be unarchived later if needed. This action is irreversible only in the sense that the project update will be hidden from active views until explicitly unarchived."
      },
      {
        "slug": "LINEAR_CREATE_ATTACHMENT",
        "name": "Create attachment",
        "description": "Creates a new attachment and associates it with a specific, existing Linear issue."
      },
      {
        "slug": "LINEAR_CREATE_COMMENT_REACTION",
        "name": "Add reaction to comment",
        "description": "Tool to add a reaction to an existing Linear comment. Use when you want to programmatically react to a comment on an issue."
      },
      {
        "slug": "LINEAR_CREATE_LINEAR_COMMENT",
        "name": "Create a comment",
        "description": "Creates a new comment on a specified Linear issue. This action modifies shared workspace data and is not reversible — confirm the target issue and comment content before executing."
      },
      {
        "slug": "LINEAR_CREATE_LINEAR_ISSUE",
        "name": "Create linear issue",
        "description": "Creates a new issue in a specified Linear project and team, requiring team_id and title, and allowing optional properties like description, assignee, state, priority, cycle, and due date. All UUID parameters (state_id, assignee_id, cycle_id, label_ids, project_id) must belong to the same team as team_id. The created issue's id is returned in data.id — capture it for use as parent_id in sub-issues or follow-up operations. No template_id field exists; expand templates manually into title and description before calling."
      },
      {
        "slug": "LINEAR_CREATE_LINEAR_ISSUE_RELATION",
        "name": "Create issue relation",
        "description": "Create a relationship between two Linear issues using the issueRelationCreate mutation. Use this to establish connections like 'blocks', 'duplicate', or 'related' between issues."
      },
      {
        "slug": "LINEAR_CREATE_LINEAR_LABEL",
        "name": "Create a label",
        "description": "Creates a new label in Linear for a specified team, used to categorize and organize issues. Label names must be unique within each team. If a label with the same name already exists, the existing label will be returned. Both new and existing labels return the same object structure; check the label's `createdAt` or compare IDs to determine if creation occurred."
      },
      {
        "slug": "LINEAR_CREATE_LINEAR_PROJECT",
        "name": "Create Project",
        "description": "Creates a new Linear project with specified name and team associations."
      },
      {
        "slug": "LINEAR_CREATE_PROJECT_MILESTONE",
        "name": "Create Project Milestone",
        "description": "Tool to create a project milestone in Linear with a name and optional target date and sort order. Use when you need to add milestones to track progress within a project."
      },
      {
        "slug": "LINEAR_CREATE_PROJECT_UPDATE",
        "name": "Create Project Update",
        "description": "Tool to create a project status update post for a Linear project. Use when you need to post progress updates, status reports, or announcements for a project."
      },
      {
        "slug": "LINEAR_CREATE_TEAM",
        "name": "Create Team",
        "description": "Creates a new team in Linear with the specified name and key. Use this action when you need to create a new organizational unit or work group in a Linear workspace. Teams are fundamental organizational structures in Linear that group issues, projects, and members together. Once created, the team's key becomes the prefix for all issues created within that team (e.g., 'ENG-123'). IMPORTANT: The key must be unique across the workspace and cannot be changed after creation."
      },
      {
        "slug": "LINEAR_DELETE_LINEAR_ISSUE",
        "name": "Delete issue",
        "description": "Archives an existing Linear issue by its ID, which is Linear's standard way of deleting issues; the operation is idempotent. Archiving is permanent with no built-in undo — confirm the issue identifier and title with the user before executing, especially in bulk operations."
      },
      {
        "slug": "LINEAR_GET_ALL_LINEAR_TEAMS",
        "name": "Get all teams (Deprecated)",
        "description": "DEPRECATED: Use ListLinearTeams instead (returns paginated payloads with members and projects); this tool returns simpler id/name-level data for all teams visible to the connected workspace with no server-side filtering. Match teams on stable team id, not display name, as names are not guaranteed unique. Partial results reflect workspace permission scope, not tool failure. Skip this call if team_id values are already known."
      },
      {
        "slug": "LINEAR_GET_ATTACHMENT",
        "name": "Download issue files",
        "description": "Downloads a Linear Attachment record or a private upload embedded in issue/comment Markdown; `file_name` must include the correct extension."
      },
      {
        "slug": "LINEAR_GET_COMMENT",
        "name": "Get a comment",
        "description": "Retrieves a single Linear comment by its unique ID. Returns comprehensive details including the comment body, author, timestamps, associated issue, and thread information. Use this action when you need to fetch details about a specific comment, such as when displaying comment information, checking comment status, or retrieving comment content for processing. The comment ID can be obtained from issue queries, comment lists, or comment creation responses."
      },
      {
        "slug": "LINEAR_GET_CURRENT_USER",
        "name": "Get current user",
        "description": "Gets the currently authenticated user's ID, name, email, and other profile information — this is the account behind the API token, which may be a bot or service account rather than a human user. Use the returned `id` field (nested under `data.viewer`) for downstream Linear operations requiring user ID filtering. To search or compare other workspace members, use LINEAR_LIST_LINEAR_USERS instead."
      },
      {
        "slug": "LINEAR_GET_CYCLES_BY_TEAM_ID",
        "name": "Get cycles by team ID",
        "description": "Retrieves all cycles for a specified Linear team ID; cycles are time-boxed work periods (like sprints). Results are team-scoped to the given team_id. To identify the active cycle, check that the current date (in UTC) falls between a cycle's startAt and endAt fields; either field may be null. Results may be paginated — follow page_info cursors to retrieve all cycles."
      },
      {
        "slug": "LINEAR_GET_ISSUE_DEFAULTS",
        "name": "Get create issue default params",
        "description": "Fetches a Linear team's default issue estimate and state, useful for pre-filling new issue forms."
      },
      {
        "slug": "LINEAR_GET_LINEAR_ISSUE",
        "name": "Get Linear issue",
        "description": "Retrieves an existing Linear issue's comprehensive details, including id, identifier, title, description, timestamps, state, team, creator, attachments, comments (with user info and timestamps, use issue.comments.nodes for comment IDs), subscribers, and due date. Embedded screenshots are uploads.linear.app URLs in description/comment Markdown, not Attachment records; download them with LINEAR_GET_ATTACHMENT's upload_url input. Does not include parent, milestone, cycle, or relation graphs—use LINEAR_RUN_QUERY_OR_MUTATION for those. Optional fields (labels, project, state, assignee, cycle) may be null; guard against null when accessing nested properties. Returns null or 'Entity not found' for invalid IDs, cross-workspace IDs, or restricted teams. Rate limit: ~60 req/min; HTTP 429 on excess—apply exponential backoff and respect Retry-After headers."
      },
      {
        "slug": "LINEAR_GET_LINEAR_PROJECT",
        "name": "Get Linear project",
        "description": "Retrieves a single Linear project by its unique identifier. Use when verifying a newly created or updated project, or when fetching detailed project information by ID."
      },
      {
        "slug": "LINEAR_GET_PROJECT_UPDATE",
        "name": "Get Project Update",
        "description": "Retrieves a specific project update by its unique identifier. Use when you need to fetch details about a specific project status update, including the update content, health status, timestamps, and associated project information. This action is useful when verifying a newly created project update or retrieving historical project update information."
      },
      {
        "slug": "LINEAR_LIST_COMMENTS",
        "name": "List comments",
        "description": "Lists comments from Linear workspace accessible to the authenticated user. Use this action when you need to retrieve comments for analysis, reporting, or tracking discussions across issues. The response includes comment content, timestamps, author information, and associated issue details. Supports pagination for large result sets."
      },
      {
        "slug": "LINEAR_LIST_ISSUE_DRAFTS",
        "name": "List issue drafts",
        "description": "Tool to list issue drafts. Use when you need to fetch draft issues for review or further editing. Check `pageInfo.hasNextPage` in the response to determine if additional drafts exist beyond the current page."
      },
      {
        "slug": "LINEAR_LIST_ISSUES_BY_TEAM_ID",
        "name": "List issues by team ID",
        "description": "Tool to list all issues for a specific Linear team, scoped by team ID. Use when you need to retrieve issues belonging to a particular team without fetching workspace-wide issues. This is more efficient than workspace-wide listing followed by client-side filtering."
      },
      {
        "slug": "LINEAR_LIST_LINEAR_CYCLES",
        "name": "Get all cycles",
        "description": "Retrieves all cycles (time-boxed sprint iterations) org-wide from the Linear account; no filters applied. In large multi-team workspaces this produces heavy responses — filter client-side by team ID and date range using each cycle's startsAt/endsAt fields. Cycles are team-scoped; always group by team ID to avoid mixing sprints across teams. To identify the active sprint, verify the current UTC timestamp falls between startsAt and endsAt, and handle null startsAt/endsAt defensively. Timestamps are UTC. Results may be paginated; follow pageInfo.endCursor and hasNextPage until hasNextPage is false to avoid truncated lists."
      },
      {
        "slug": "LINEAR_LIST_LINEAR_ISSUES",
        "name": "List Linear issues",
        "description": "Lists non-archived Linear issues; if project_id is not specified, issues from all accessible projects are returned. Can filter by assignee_id. Only project_id and assignee_id server-side filters are supported; label, state, team, cycle, or date filters must be done client-side or via LINEAR_RUN_QUERY_OR_MUTATION. Response is a flat issues array plus page_info object (not GraphQL nodes/pageInfo). Fields like cycle membership, dueDate, completedAt, comments, and attachments are absent; use LINEAR_GET_LINEAR_ISSUE for enrichment. state and labels are nested objects (labels as labels.nodes array). Response order is not guaranteed; sort client-side after collecting all pages. No team_id filter; scope by project_id or use LINEAR_RUN_QUERY_OR_MUTATION."
      },
      {
        "slug": "LINEAR_LIST_LINEAR_LABELS",
        "name": "Get labels",
        "description": "Retrieves labels from Linear. If team_id is provided, returns labels for that specific team; if omitted, returns all labels across the workspace. Label names are not unique across teams — always use returned IDs, not names, and track each label ID with its team ID. In large workspaces, results may paginate; follow pageInfo.hasNextPage and pageInfo.endCursor to retrieve all labels."
      },
      {
        "slug": "LINEAR_LIST_LINEAR_PROJECTS",
        "name": "List linear projects",
        "description": "Retrieves all projects from the Linear account. Returns a flat array (not a GraphQL connection) with fields id and name; use LINEAR_RUN_QUERY_OR_MUTATION for progress, state, issues, or team linkage. No server-side filtering: all workspace projects are returned regardless of team or name — filter client-side. Multiple projects can share identical names; always confirm project_id before downstream use. Results are permission-scoped to the connected user. Pagination: loop while page_info.hasNextPage is true, passing page_info.endCursor as after, or results will be silently truncated. HTTP 429 may occur in large workspaces; apply exponential backoff between calls."
      },
      {
        "slug": "LINEAR_LIST_LINEAR_STATES",
        "name": "List Linear states",
        "description": "Retrieves all workflow states for a specified team in Linear, representing the stages an issue progresses through in that team's workflow. Returned state IDs are team-scoped — never reuse a stateId across different teams, as this causes validation errors or 'Entity not found' failures in tools like LINEAR_UPDATE_ISSUE. State names (e.g., 'Done', 'In Progress') are non-unique across teams; always resolve names to IDs via this tool for the specific team_id before using them in filters or mutations. Uses cursor-based pagination via pageInfo.hasNextPage and endCursor; iterate until hasNextPage is false to avoid missing states in large workspaces. Always fetch fresh state IDs rather than hardcoding or reusing stale values."
      },
      {
        "slug": "LINEAR_LIST_LINEAR_TEAMS",
        "name": "Get teams",
        "description": "Retrieves all teams with their members and projects. Use stable team IDs or keys (not display names) for subsequent operations — names are non-unique. Results reflect only teams visible to the authenticated token scope; missing teams or members indicate permission limits. Large workspaces paginate via pageInfo.hasNextPage/endCursor — incomplete pagination silently drops teams or members. Members may belong to multiple teams; deduplicate user IDs when aggregating. Use LINEAR_GET_ALL_LINEAR_TEAMS instead when only identifiers are needed."
      },
      {
        "slug": "LINEAR_LIST_LINEAR_USERS",
        "name": "List Linear users",
        "description": "Lists all workspace users (not team-scoped) with their IDs, names, emails, and active status. Display names are non-unique — use email to disambiguate before extracting an ID. Only assign users with `active: true`. Returned IDs are UUID strings; pass them as-is to fields like `assignee_id` — never substitute names, emails, or tokens. When joining with other tools, always join on IDs."
      },
      {
        "slug": "LINEAR_LIST_PROJECT_UPDATES",
        "name": "List project updates",
        "description": "Retrieves all project updates from the Linear workspace. Project updates are status posts written by team members to communicate project progress, blockers, and health. Use when you need to fetch project update history, track project health over time, or review team communication. Returns a paginated list with fields including id, body, health, createdAt, url, user, and project. Results are permission-scoped to the connected user — only updates from accessible projects are returned. Pagination: loop while page_info.hasNextPage is true, passing page_info.endCursor as after, or results will be silently truncated. HTTP 429 may occur in large workspaces; apply exponential backoff between calls."
      },
      {
        "slug": "LINEAR_REMOVE_ISSUE_LABEL",
        "name": "Remove label from Linear issue",
        "description": "Removes a specified label from an existing Linear issue using their IDs; successful even if the label isn't on the issue. Operation is irreversible — obtain explicit user approval before executing. Use this tool instead of LINEAR_UPDATE_ISSUE to avoid replacing the entire label set."
      },
      {
        "slug": "LINEAR_REMOVE_REACTION",
        "name": "Remove reaction from comment",
        "description": "Tool to remove a reaction on a comment. Use when you have a reaction ID and need to delete it."
      },
      {
        "slug": "LINEAR_RESOLVE_COMMENT",
        "name": "Resolve comment",
        "description": "Marks a Linear comment as resolved. This action is used when a comment thread or discussion has been addressed and should be marked as complete. Use this action when you need to resolve a comment after addressing the feedback or discussion it represents. The comment remains visible but is marked as resolved with a timestamp and the resolving user's information."
      },
      {
        "slug": "LINEAR_RUN_QUERY_OR_MUTATION",
        "name": "Run Query or Mutation",
        "description": "Execute any GraphQL query or mutation against Linear's API. USE WHEN: No dedicated action exists, need complex filtering, custom fields, or schema discovery. *** INTROSPECTION FIRST - NEVER GUESS FIELD NAMES *** Run introspection before unknown operations: - query { __type(name: \"Issue\") { fields { name } } } - query { __type(name: \"Mutation\") { fields { name } } } Linear uses nested objects (project { id }), NOT scalar IDs (projectId). KEY: All IDs are UUIDs. Filter: { field: { eq: value } }. Pagination: nodes[] + pageInfo."
      },
      {
        "slug": "LINEAR_SEARCH_ISSUES",
        "name": "Search Linear issues",
        "description": "Search Linear issues using full-text search across identifier, title, and description. Use when you need to find issues by keywords or specific identifiers. Note: This endpoint only supports full-text search; for structured filtering by team, project, assignee, state, or labels, use LIST_ISSUES_BY_TEAM_ID instead."
      },
      {
        "slug": "LINEAR_UNARCHIVE_PROJECT_UPDATE",
        "name": "Unarchive Project Update",
        "description": "Unarchive a previously archived project update in Linear. Use this action when you need to restore an archived project update to make it visible and active again. Archived project updates are hidden from normal views but can be restored using this action. Use when a project update was archived by mistake or needs to be brought back into active use."
      },
      {
        "slug": "LINEAR_UNRESOLVE_COMMENT",
        "name": "Unresolve a comment",
        "description": "Unresolves a previously resolved Linear comment, marking it as requiring attention again. Use this action when you need to reopen a comment thread that was previously marked as resolved. This is useful when additional discussion is needed or the resolution was premature."
      },
      {
        "slug": "LINEAR_UPDATE_ISSUE",
        "name": "Update issue",
        "description": "Updates an existing Linear issue using its `issue_id`; requires at least one other attribute for modification, and all provided entity IDs (for state, assignee, labels, etc.) must be valid UUIDs — only `issueId` accepts key format (e.g., 'ENG-123'). All updated fields are fully overwritten, not merged; omit any field you do not intend to change."
      },
      {
        "slug": "LINEAR_UPDATE_LINEAR_COMMENT",
        "name": "Update a comment",
        "description": "Tool to update an existing Linear comment's body text. Use when you need to edit or modify the content of a previously created comment."
      },
      {
        "slug": "LINEAR_UPDATE_LINEAR_PROJECT",
        "name": "Update Project",
        "description": "Tool to update an existing Linear project. Use when you need to modify project properties like name, description, state, dates, or lead. All fields except project_id are optional - only provide the fields you want to update."
      },
      {
        "slug": "LINEAR_UPDATE_PROJECT_UPDATE",
        "name": "Update Project Update",
        "description": "Tool to update an existing Linear project update post. Use this action when you need to modify a project update's content, health status, or diff visibility settings. All fields except the update ID are optional - only provide the fields you want to update. Changes are immediately visible to all team members viewing the project."
      },
      {
        "slug": "LINEAR_UPDATE_TEAM",
        "name": "Update Team",
        "description": "Updates an existing Linear team's settings and configuration. Use when you need to modify team properties like name, description, key, cycle settings, workflow states, or other team-level configurations. All fields except team_id are optional - only provide the fields you want to update."
      },
      {
        "slug": "LINEAR_VALIDATE_CREDENTIAL",
        "name": "Validate credential",
        "description": "Validates the Linear API credentials by checking if the authentication token can successfully query the current user. Use this action when you need to verify that API credentials are valid before performing other operations, or to confirm that authentication is working correctly. This is particularly useful for connection testing, credential verification flows, or troubleshooting authentication issues."
      }
    ],
    "triggers": [
      {
        "slug": "LINEAR_COMMENT_EVENT_TRIGGER",
        "name": "Comment Received Trigger",
        "description": "Triggered when a comment is received."
      },
      {
        "slug": "LINEAR_ISSUE_CREATED_TRIGGER",
        "name": "Issue Created Trigger",
        "description": "Triggered when a new issue is created."
      },
      {
        "slug": "LINEAR_ISSUE_UPDATED_TRIGGER",
        "name": "Issue Updated Trigger",
        "description": "Triggered when an issue is updated. For example labels are changed, issue status is changed, etc."
      },
      {
        "slug": "LINEAR_PRIVATE_TEAM_COMMENT_CREATED",
        "name": "Private Team Comment Created",
        "description": "Fires when a new comment is posted on an issue in a private Linear team (polled with the connected user's token)."
      },
      {
        "slug": "LINEAR_PRIVATE_TEAM_ISSUE_CREATED",
        "name": "Private Team Issue Created",
        "description": "Fires when a new issue appears in a private Linear team (polled with the connected user's token)."
      },
      {
        "slug": "LINEAR_PRIVATE_TEAM_ISSUE_PROPERTIES_UPDATED",
        "name": "Private Team Issue Properties Updated",
        "description": "Fires when properties on an issue change in a private Linear team (polled with the connected user's token)."
      },
      {
        "slug": "LINEAR_PROJECT_CREATED",
        "name": "Project Created",
        "description": "Fires when a new Linear project is created. Covers projects in both public and private teams — polls with the connected user's token, so visibility matches what the connected user can see in Linear."
      },
      {
        "slug": "LINEAR_PROJECT_PROPERTIES_UPDATED",
        "name": "Project Properties Updated",
        "description": "Fires when properties on a Linear project change (status, lead, target date, priority, etc.). Covers projects in both public and private teams — polls with the connected user's token."
      },
      {
        "slug": "LINEAR_PROJECT_UPDATE_POSTED",
        "name": "Project Update Posted",
        "description": "Fires when a project status update is posted on the Linear project's Updates tab. Covers projects in both public and private teams — polls with the connected user's token."
      },
      {
        "slug": "LINEAR_PUBLIC_TEAM_COMMENT_CREATED",
        "name": "Public Team Comment Created",
        "description": "Fires when a new comment is posted on a *public-team* Linear issue. For private teams (lock icon in Linear's sidebar) use `LINEAR_PRIVATE_TEAM_COMMENT_CREATED`."
      },
      {
        "slug": "LINEAR_PUBLIC_TEAM_ISSUE_CREATED",
        "name": "Public Team Issue Created",
        "description": "Fires when a new issue is created in a Linear *public* team. For private teams (lock icon in Linear's sidebar) use `LINEAR_PRIVATE_TEAM_ISSUE_CREATED`."
      },
      {
        "slug": "LINEAR_PUBLIC_TEAM_ISSUE_PROPERTIES_UPDATED",
        "name": "Public Team Issue Properties Updated",
        "description": "Fires when properties on a *public-team* Linear issue change (status, assignee, priority, labels, etc.). For private teams (lock icon in Linear's sidebar) use `LINEAR_PRIVATE_TEAM_ISSUE_PROPERTIES_UPDATED`."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "linear_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "read,write,issues:create,comments:create"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      },
      {
        "mode": "API_KEY",
        "name": "linear_api_key",
        "fields": {
          "auth_config_creation": {
            "required": [],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "generic_api_key",
                "displayName": "API Key",
                "type": "string",
                "description": "Your Linear personal API key (starts with 'lin_api_'). Create one in Linear under Settings → Security & access → Personal API keys; full access is simplest.",
                "required": true,
                "default": null
              }
            ],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "airtable",
    "name": "Airtable",
    "logo": "https://logos.composio.dev/api/airtable",
    "description": "Airtable merges spreadsheet functionality with database power, enabling teams to organize projects, track tasks, and collaborate through customizable views, automation, and integrations for data management",
    "category": "productivity",
    "authSchemes": [
      "OAUTH2",
      "API_KEY"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 26,
    "triggerCount": 6,
    "version": "20260902_00",
    "tools": [
      {
        "slug": "AIRTABLE_CREATE_BASE",
        "name": "Create base",
        "description": "Creates a new Airtable base with specified tables and fields within a workspace."
      },
      {
        "slug": "AIRTABLE_CREATE_COMMENT",
        "name": "Create Comment",
        "description": "Tool to create a comment on a specific Airtable record. Use when adding comments to records, mentioning collaborators using @[userId] syntax, or creating threaded comment replies. Supports optional parentCommentId for threaded conversations."
      },
      {
        "slug": "AIRTABLE_CREATE_FIELD",
        "name": "Create Field",
        "description": "Creates a new field within a specified table in an Airtable base."
      },
      {
        "slug": "AIRTABLE_CREATE_MULTIPLE_RECORDS",
        "name": "Create multiple records (Deprecated)",
        "description": "DEPRECATED: Use AIRTABLE_CREATE_RECORDS instead. Creates multiple new records in a specified Airtable table."
      },
      {
        "slug": "AIRTABLE_CREATE_RECORD",
        "name": "Create a record (Deprecated)",
        "description": "DEPRECATED: Use CreateRecords instead. Creates a new record in a specified Airtable table; field values must conform to the table's column types."
      },
      {
        "slug": "AIRTABLE_CREATE_RECORD_FROM_NATURAL_LANGUAGE",
        "name": "Create Record From Natural Language",
        "description": "Creates a new record in an Airtable table from a natural language description. Fetches the table schema, uses an LLM to generate the correct field payload, and creates the record with typecast enabled for automatic type conversion."
      },
      {
        "slug": "AIRTABLE_CREATE_RECORDS",
        "name": "Create records",
        "description": "Tool to create multiple records (up to 10) in a specified Airtable table. Use when you need to add new rows to a table with field values. Rate limit: 5 requests per second per base."
      },
      {
        "slug": "AIRTABLE_CREATE_TABLE",
        "name": "Create table",
        "description": "Creates a new table within a specified existing Airtable base, allowing definition of its name, description, and field structure."
      },
      {
        "slug": "AIRTABLE_DELETE_COMMENT",
        "name": "Delete Comment",
        "description": "Tool to delete a comment from a record in an Airtable table. Use when you need to remove an existing comment. Non-admin users can only delete their own comments; Enterprise Admins can delete any comment."
      },
      {
        "slug": "AIRTABLE_DELETE_MULTIPLE_RECORDS",
        "name": "Delete multiple records",
        "description": "Tool to delete up to 10 specified records from a table within an Airtable base. Use when you need to remove multiple records in a single operation."
      },
      {
        "slug": "AIRTABLE_DELETE_RECORD",
        "name": "Delete Record",
        "description": "Permanently deletes a specific record from an existing table within an existing Airtable base."
      },
      {
        "slug": "AIRTABLE_GET_ATTACHMENT_INFO",
        "name": "Get Attachment Info",
        "description": "Retrieves attachment information from a specific field in an Airtable record. Returns metadata including file URLs, sizes, types, and thumbnails for all attachments in the specified field. Use this action when you need to access file metadata or download URLs for attachments stored in Airtable. Note that attachment URLs expire 2 hours after being retrieved from the API."
      },
      {
        "slug": "AIRTABLE_GET_BASE_SCHEMA",
        "name": "Get Base Schema",
        "description": "Retrieves the detailed schema for a specified Airtable base, including its tables, fields, field types, and configurations, using the `baseId`."
      },
      {
        "slug": "AIRTABLE_GET_RECORD",
        "name": "Get Record",
        "description": "Retrieves a specific record from an Airtable table by its record ID. Requires a known, valid record ID obtained from listing records or another API call - this tool cannot search or list records. Use the list records tool to find record IDs. Empty field values are not returned in the response."
      },
      {
        "slug": "AIRTABLE_GET_USER_INFO",
        "name": "Get user information",
        "description": "Retrieves information, such as ID and permission scopes, for the currently authenticated Airtable user from the `/meta/whoami` endpoint."
      },
      {
        "slug": "AIRTABLE_LIST_BASES",
        "name": "List bases",
        "description": "Retrieves all Airtable bases accessible to the authenticated user, which may include an 'offset' for pagination."
      },
      {
        "slug": "AIRTABLE_LIST_COMMENTS",
        "name": "List Comments",
        "description": "Tool to list comments on a specific Airtable record. Use when retrieving comments for a record, with optional pagination support for large comment threads."
      },
      {
        "slug": "AIRTABLE_LIST_RECORDS",
        "name": "List records",
        "description": "Tool to list records from an Airtable table with filtering, sorting, and pagination. Use when you need to retrieve multiple records from a table with optional query parameters."
      },
      {
        "slug": "AIRTABLE_UPDATE_COMMENT",
        "name": "Update Comment",
        "description": "Tool to update an existing comment on a specific Airtable record. Use when modifying comment text or updating user mentions using @[userId] syntax. API users can only update comments they have created."
      },
      {
        "slug": "AIRTABLE_UPDATE_FIELD",
        "name": "Update Field",
        "description": "Updates a field's name or description in an Airtable table. Use this action to modify field metadata without changing the field's type or options. At least one of 'name' or 'description' must be provided."
      },
      {
        "slug": "AIRTABLE_UPDATE_MULTIPLE_RECORDS",
        "name": "Update multiple records",
        "description": "Tool to update up to 10 records in an Airtable table with selective field modifications. Use when you need to modify multiple existing records or perform upsert operations. Updates are not performed atomically."
      },
      {
        "slug": "AIRTABLE_UPDATE_MULTIPLE_RECORDS_PUT",
        "name": "Update multiple records (PUT)",
        "description": "Tool to destructively update multiple records in Airtable using PUT, clearing unspecified fields. Use when you need to fully replace record data or perform upsert operations. Supports up to 10 records per request."
      },
      {
        "slug": "AIRTABLE_UPDATE_RECORD",
        "name": "Update record",
        "description": "Modifies specified fields of an existing record in an Airtable base and table; the base, table, and record must exist."
      },
      {
        "slug": "AIRTABLE_UPDATE_RECORD_PUT",
        "name": "Update record (PUT)",
        "description": "Updates an existing record in an Airtable base using PUT method. Use when you want to replace all field values, clearing any unspecified fields. For partial updates that preserve unspecified fields, use the PATCH-based update action instead."
      },
      {
        "slug": "AIRTABLE_UPDATE_TABLE",
        "name": "Update Table",
        "description": "Updates the name, description, and/or date dependency settings of a table in Airtable. Use this action to modify table metadata without changing the table's fields or views. At least one of 'name', 'description', or 'dateDependencySettings' must be provided."
      },
      {
        "slug": "AIRTABLE_UPLOAD_ATTACHMENT",
        "name": "Upload attachment",
        "description": "Uploads a file attachment to a specified field in an Airtable record. Use when you need to add a file to an attachment field. The file must be provided as a base64-encoded string."
      }
    ],
    "triggers": [
      {
        "slug": "AIRTABLE_BASE_METADATA_CHANGED_TRIGGER",
        "name": "Base Metadata Changed",
        "description": "Triggers when an existing Airtable base changes its name or permission level."
      },
      {
        "slug": "AIRTABLE_BASE_SCHEMA_CHANGED_TRIGGER",
        "name": "Base Schema Changed",
        "description": "Triggers when tables, fields, or views change in an Airtable base."
      },
      {
        "slug": "AIRTABLE_USER_PROFILE_CHANGED_TRIGGER",
        "name": "User Profile Changed",
        "description": "Triggers when the connected Airtable user's profile information changes."
      },
      {
        "slug": "AIRTABLE_VIEW_CREATED_TRIGGER",
        "name": "View Created",
        "description": "Triggers when a new view is created in an Airtable base."
      },
      {
        "slug": "AIRTABLE_VIEW_DELETED_TRIGGER",
        "name": "View Deleted",
        "description": "Triggers when a previously known Airtable view is deleted."
      },
      {
        "slug": "AIRTABLE_VIEW_METADATA_CHANGED_TRIGGER",
        "name": "View Metadata Changed",
        "description": "Triggers when an Airtable view changes its name or type."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "airtable_oauth2",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "data.records:read,data.records:write,data.recordComments:read,data.recordComments:write,schema.bases:read,schema.bases:write,user.email:read"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      },
      {
        "mode": "API_KEY",
        "name": "API_KEY",
        "fields": {
          "auth_config_creation": {
            "required": [],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "generic_api_key",
                "displayName": "Personal Access Token",
                "type": "string",
                "description": "Your Airtable personal access token (starts with 'pat'), not a legacy API key. Create it at airtable.com/create/tokens and grant scopes plus access to your bases.",
                "required": true,
                "default": null
              }
            ],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "codeinterpreter",
    "name": "Code Interpreter",
    "logo": "https://logos.composio.dev/api/codeinterpreter",
    "description": "CodeInterpreter extends Python-based coding environments with integrated data analysis, enabling developers to run scripts, visualize results, and prototype solutions inside supported platforms",
    "category": "developer tools",
    "authSchemes": [
      "NO_AUTH"
    ],
    "toolCount": 5,
    "triggerCount": 0,
    "version": "20260709_00",
    "tools": [
      {
        "slug": "CODEINTERPRETER_CREATE_SANDBOX",
        "name": "Create Sandbox",
        "description": "Create a sandbox to execute python code in a Jupyter notebook cell. This is useful for agents to communicate, execute code, see output, read files, write files, etc. It's like you own personal computer, but in the cloud. Use /home/user folder to write/read files."
      },
      {
        "slug": "CODEINTERPRETER_EXECUTE_CODE",
        "name": "Execute Code",
        "description": "Execute python code in a sandbox and return any result, stdout, stderr, and error. Use /home/user folder to write/read files. Try to not use plt.show() as the code is executed remotely. Use files for image/chart output instead."
      },
      {
        "slug": "CODEINTERPRETER_GET_FILE_CMD",
        "name": "Get File",
        "description": "Get a file from the sandbox and returns the file. The files should be read from /home/user folder."
      },
      {
        "slug": "CODEINTERPRETER_RUN_TERMINAL_CMD",
        "name": "Run Terminal Command",
        "description": "Run a command in the terminal and returns the stdout, stderr, and error code. Use /home/user folder to write/read files."
      },
      {
        "slug": "CODEINTERPRETER_UPLOAD_FILE_CMD",
        "name": "Upload File",
        "description": "Upload a file to the sandbox environment. The files should be uploaded to the /home/user folder."
      }
    ],
    "triggers": [],
    "authConfigDetails": [
      {
        "mode": "NO_AUTH",
        "name": "CodeInterpreter",
        "fields": {
          "auth_config_creation": {
            "required": [],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "serpapi",
    "name": "SerpApi",
    "logo": "https://logos.composio.dev/api/serpapi",
    "description": "SerpApi provides a real-time API for structured search engine results, allowing developers to scrape, parse, and analyze SERP data for SEO and research",
    "category": "analytics",
    "authSchemes": [
      "API_KEY"
    ],
    "toolCount": 48,
    "triggerCount": 0,
    "version": "20260623_00",
    "tools": [
      {
        "slug": "SERPAPI_BAIDU_SEARCH",
        "name": "Search Baidu with Query",
        "description": "Search Baidu (Chinese search engine) and retrieve search results. Requires a search query string in the 'q' parameter. Returns organic search results, answer boxes, and pagination info in JSON format."
      },
      {
        "slug": "SERPAPI_BING_MAPS",
        "name": "Bing Maps Search",
        "description": "Tool to scrape Bing Maps results using SerpApi. Use when you need to find local businesses, places, or get detailed location information including addresses, phone numbers, ratings, reviews, and more. Supports searching by query or specific place ID."
      },
      {
        "slug": "SERPAPI_BING_SEARCH",
        "name": "Bing Search",
        "description": "Retrieve Bing Search Engine Results via SerpAPI (requires active SerpAPI connection; if unavailable, use COMPOSIO_SEARCH_WEB or COMPOSIO_SEARCH_NEWS). Consumes SerpAPI credits per call; throttle to ~1–2 calls/second and apply exponential backoff on HTTP 429. Supports query, location, language, and device parameters. Set `location`, `mkt`, or `cc` explicitly when local relevance matters — result ranking is highly sensitive to localization."
      },
      {
        "slug": "SERPAPI_DUCK_DUCK_GO_LIGHT_SEARCH",
        "name": "DuckDuckGo Light Search",
        "description": "Tool to access the world's fastest DuckDuckGo Search API via SerpApi. Scrapes DuckDuckGo search results in JSON format with critical data for faster response times, without extra-rich results. Use when you need quick DuckDuckGo search results with essential information. Supports location-based searches, date filtering, and pagination (15 results per page)."
      },
      {
        "slug": "SERPAPI_DUCK_DUCK_GO_MAPS",
        "name": "DuckDuckGo Maps search",
        "description": "Scrapes DuckDuckGo Maps results via SerpApi. Use when searching for location-based information like businesses, restaurants, or services in a specific geographic area. Returns structured data including ratings, reviews, addresses, operating hours, and contact information."
      },
      {
        "slug": "SERPAPI_DUCK_DUCK_GO_SEARCH",
        "name": "DuckDuckGo search",
        "description": "Performs a DuckDuckGo search via SerpApi to retrieve SERP data, including organic results, ads, and structured information. Requires a valid SerpApi connection configured in Composio. Results may be localized by region by default."
      },
      {
        "slug": "SERPAPI_EBAY_SEARCH",
        "name": "eBay Search",
        "description": "Retrieve eBay Search Results via SerpApi (requires active SerpApi connected account). Supports parameters like nkw (query), location, etc. Returns product SERP data in JSON format. Listing prices and fees may be incomplete or inconsistent; verify total cost on the source page before comparing results."
      },
      {
        "slug": "SERPAPI_EVENT_SEARCH",
        "name": "Search Google Events",
        "description": "Searches for events (e.g., concerts, festivals, conferences) by query, retrieving structured data from Google's event search results via the SerpApi Google Events engine."
      },
      {
        "slug": "SERPAPI_FINANCE_SEARCH",
        "name": "Search finance",
        "description": "Retrieves structured financial information (e.g., company data, stock details, market trends, news) from Google Finance via SERP API based on a query. Requires active SerpApi credentials. Empty results for delisted, illiquid, or newly listed assets are valid 'no data' responses. High query volumes may trigger HTTP 429 rate limits; apply backoff on retries."
      },
      {
        "slug": "SERPAPI_GET_AVAILABLE_LOCATION_OPTIONS_FOR_GOOGLE_SEARCHES",
        "name": "Get Location Options",
        "description": "Tool to get available location options for Google searches. Returns location names, codes, and identifiers that can be used in the location parameter. Use when you need to find valid location values for search queries."
      },
      {
        "slug": "SERPAPI_GET_FACEBOOK_PROFILE",
        "name": "Get Facebook profile information",
        "description": "Tool to retrieve public information from a Facebook profile or page using SerpAPI. Use when you need to fetch profile details, bio, photos, followers, ratings, or contact information."
      },
      {
        "slug": "SERPAPI_GET_GOOGLE_ABOUT_THIS_RESULT",
        "name": "Get Google About This Result",
        "description": "Tool to get Google 'About this result' information for a website. Use when you need detailed information about a specific URL including company details, social profiles, web citations, and reviews."
      },
      {
        "slug": "SERPAPI_GET_GOOGLE_HOTELS_AUTOCOMPLETE_SUGGESTIONS",
        "name": "Get Google Hotels Autocomplete",
        "description": "Tool to get autocomplete suggestions for Google Hotels destination searches. Use when users need to search for hotel destinations, properties, or locations before performing a full hotel search."
      },
      {
        "slug": "SERPAPI_GET_GOOGLE_IMAGES_RELATED_CONTENT",
        "name": "Get Google Images Related Content",
        "description": "Get related content for a specific Google Images result. Requires a related_content_id obtained from a Google Images search. Use when you need to find similar images or related visual content for a particular image."
      },
      {
        "slug": "SERPAPI_GET_GOOGLE_PATENT_DETAILS",
        "name": "Get Google Patent Details",
        "description": "Tool to retrieve detailed information about a specific patent or scholar document from Google Patents via SerpApi. Use when you need patent details, claims, citations, inventors, assignees, legal events, or scholar publication information."
      },
      {
        "slug": "SERPAPI_GET_SEARCH_ARCHIVE",
        "name": "Get Search Archive",
        "description": "Tool to retrieve results from a previous async search using its search ID. Use when you need to fetch results from searches submitted with async=true. Searches can be retrieved up to 31 days after completion."
      },
      {
        "slug": "SERPAPI_GOOGLE_DOMAINS_LIST",
        "name": "Google Domains List",
        "description": "Retrieve the list of supported Google domains for search queries."
      },
      {
        "slug": "SERPAPI_GOOGLE_FORUMS_SEARCH",
        "name": "Google Forums Search",
        "description": "Tool to scrape forum results from Google's Forums Platform using SerpApi. Use when you need to search forum discussions, get forum titles, dates, links, answers with voting data, and related searches."
      },
      {
        "slug": "SERPAPI_GOOGLE_JOBS_SEARCH",
        "name": "Google Jobs Search",
        "description": "Retrieve Google Jobs Search Results via SerpApi. Returns job SERP data in JSON; key attributes like `work_from_home`, `posted_at`, `salary`, and `schedule_type` are nested under `detected_extensions` per job object and are often absent — treat as optional. Results may include stale postings; verify recency via `detected_extensions.posted_at`. Supports pagination, location filtering, and remote-job filtering."
      },
      {
        "slug": "SERPAPI_GOOGLE_LENS_SEARCH",
        "name": "Google Lens search",
        "description": "Performs reverse image search using Google Lens to find visually similar images, products, and related content. Use when you need to identify objects, find similar products, or get information about images. Requires a publicly accessible image URL."
      },
      {
        "slug": "SERPAPI_GOOGLE_LIGHT_SEARCH",
        "name": "Google Light Search",
        "description": "Retrieve Google Light Search Results via SerpApi. Requires an active SerpApi connection. Supports q, location, gl, hl, and other SERP parameters. Returns lightweight JSON SERP data; results are in organic_results (handle missing/empty gracefully). Snippets are shallow — follow citation URLs with BROWSER_TOOL_FETCH_WEBPAGE for full content. Rate limit: HTTP 429 under heavy use; keep to ~1–2 requests/sec with exponential backoff on retry."
      },
      {
        "slug": "SERPAPI_GOOGLE_MAPS_POSTS",
        "name": "Google Maps Posts",
        "description": "Scrapes Google Maps Posts for a business location via SerpApi. Extracts local posts published by business owners including titles, descriptions, links, images, and publication dates. Returns 10 posts per page with pagination support."
      },
      {
        "slug": "SERPAPI_GOOGLE_MAPS_SEARCH",
        "name": "Google maps search",
        "description": "Performs a Google Maps search via SERP API. Takes a query, optionally using specific GPS coordinates and pagination, returning structured location data."
      },
      {
        "slug": "SERPAPI_GOOGLE_PLAY_PRODUCT",
        "name": "Google Play Product Search",
        "description": "Tool to retrieve detailed Google Play product information using SerpApi. Supports apps, movies, TV shows, audiobooks, and books. Use when you need product details, ratings, reviews, or media for Google Play Store items."
      },
      {
        "slug": "SERPAPI_GOOGLE_SCHOLAR_AUTHOR",
        "name": "Google Scholar Author Profile",
        "description": "Scrapes full Google Scholar Author page including articles, citations, metrics, and co-authors. Use when you need detailed information about a specific researcher's publications and academic profile."
      },
      {
        "slug": "SERPAPI_GOOGLE_SCHOLAR_CITE",
        "name": "Google Scholar Cite",
        "description": "Scrapes full Google Scholar Citations with multiple citation formats. Retrieves MLA, APA, Chicago, Harvard, and Vancouver style citations along with download links for BibTeX, EndNote, RefMan, and RefWorks. Use when you need formatted citations for a specific research paper identified by its Google Scholar ID."
      },
      {
        "slug": "SERPAPI_GOOGLE_VIDEOS_LIGHT",
        "name": "Google Videos Light Search",
        "description": "Tool to scrape Google Videos results using SerpApi's ultra-fast Google Videos Light API. Use when you need video titles, links, thumbnails, snippets, upload dates, and durations from Google Videos search. This lighter version excludes rich results for faster response times."
      },
      {
        "slug": "SERPAPI_HOTEL_SEARCH",
        "name": "Hotel Search",
        "description": "Retrieve Google Hotel Search Results. Supports parameters like q (query), location, etc. Returns hotel SERP data in JSON format."
      },
      {
        "slug": "SERPAPI_IMAGE_SEARCH",
        "name": "Image search",
        "description": "Searches Google Images via SERP API for a given query, returning structured image results. Requires a valid SerpAPI authenticated connection. The number of results can be controlled using the 'num' parameter (1-100). If not specified, it defaults to 20 results."
      },
      {
        "slug": "SERPAPI_NAVER_SEARCH",
        "name": "Naver Search",
        "description": "Tool to search Naver (South Korea's leading search engine) for Korean web results and content. Use when searching for Korean-language content, news, videos, images, or shopping results. Supports various search categories and filtering options including time periods and sorting."
      },
      {
        "slug": "SERPAPI_NEWS_SEARCH",
        "name": "Search for news articles",
        "description": "Searches Google News (via SerpApi, `tbm=nws`) for articles matching a query; precise key-phrase queries yield best results. Auth is handled via SerpApi connection — do not pass api_key as a parameter. Results returned under `news_results` field (~10 items/page). Rate-limited: throttle to ~1 req/s; HTTP 429 on bursts — apply exponential backoff (1s, 2s, 4s). Covers news content only; pair with SERPAPI_SEARCH for broader web sources. Headlines/snippets only — use EXA_GET_CONTENTS_ACTION for full article text."
      },
      {
        "slug": "SERPAPI_OPEN_TABLE_REVIEWS",
        "name": "OpenTable Reviews Search",
        "description": "Tool to scrape OpenTable restaurant reviews using SerpApi. Retrieves user reviews, ratings, restaurant responses, images, and AI-generated summaries. Use when you need detailed review data for OpenTable restaurants."
      },
      {
        "slug": "SERPAPI_PLAY_SEARCH",
        "name": "Google Play Search",
        "description": "Retrieve Google Play Store Search Results. Supports parameters like q (query), gl, hl, etc. Returns app SERP data in JSON format."
      },
      {
        "slug": "SERPAPI_SCHOLAR_SEARCH",
        "name": "Search Google Scholar",
        "description": "Searches Google Scholar via SerpApi for academic literature, papers, articles, and citations based on a query. Response results may include `inline_links.cited_by` and `resources` (PDF links), but these fields are not guaranteed; check for their existence and type before accessing."
      },
      {
        "slug": "SERPAPI_SEARCH",
        "name": "Serp API search",
        "description": "Performs a real-time Google search via the SerpAPI connection (must be active; if unavailable, use COMPOSIO_SEARCH_WEB or other COMPOSIO_SEARCH_* tools). Returns ~10 organic results per page nested under results.organic_results — not a flat list; handle missing/empty arrays. Paginate via start offset or serpapi_pagination.next; max num=100; stop when domains plateau to avoid quota exhaustion. Rate-limited: throttle to 1–2 req/s; HTTP 429 on bursts — apply exponential backoff (1s, 2s, 4s). Derive result rank from array index (absolute rank = start + index; no explicit rank field). Lacks date-bound controls — embed recency terms in query or use SERPAPI_NEWS_SEARCH for time-sensitive queries. Results may include ads and sponsored content; prefer authoritative domains. Use vertical tools (SERPAPI_IMAGE_SEARCH, SERPAPI_NEWS_SEARCH, SERPAPI_YOU_TUBE_SEARCH, SERPAPI_GOOGLE_JOBS_SEARCH) for specialized query types."
      },
      {
        "slug": "SERPAPI_SEARCH_APPLE_APP_STORE",
        "name": "Search Apple App Store",
        "description": "Tool to search Apple App Store for iOS and Mac apps. Returns app details including ratings, reviews, descriptions, and developer information. Use when you need to find apps on the Apple App Store or get information about specific apps."
      },
      {
        "slug": "SERPAPI_SEARCH_GOOGLE_IMAGES_LIGHT",
        "name": "Google Images Light Search",
        "description": "Tool to scrape Google Images results using SerpApi's Google Images Light API. Use when you need fast image search with thumbnails, titles, sources, and original image URLs from Google Images. This lightweight version provides faster response times compared to the full Google Images API."
      },
      {
        "slug": "SERPAPI_SEARCH_GOOGLE_LOCAL_SERVICES",
        "name": "Search Google Local Services",
        "description": "Search Google Local Services for service providers like electricians, plumbers, HVAC technicians, and more. Use when you need to find local service professionals with Google's guaranteed badge and verified business information."
      },
      {
        "slug": "SERPAPI_SEARCH_YELP",
        "name": "Search Yelp businesses",
        "description": "Tool to search Yelp for businesses and places using SerpApi. Returns business listings with ratings, reviews, hours, contact information, and location details. Use when you need to find local businesses, restaurants, services, or read customer reviews."
      },
      {
        "slug": "SERPAPI_SHOPPING_SEARCH",
        "name": "Shopping search",
        "description": "Searches Google Shopping via SerpAPI for a specific product, returning structured listings in results.shopping_results. Requires an active SerpAPI connection. Response fields such as rating, review_count, extracted_price, and extracted_old_price may be absent; null-check before ranking or computing discounts. Discount percentages in listings may reflect aggregate promotional claims, not per-item pricing."
      },
      {
        "slug": "SERPAPI_TRENDS_SEARCH",
        "name": "Google Trends search",
        "description": "Fetches Google Trends data; returns relative 0–100 interest indices (not absolute volumes) meaningful only when comparing queries within the same request. The `query`'s format (single/multiple terms) must comply with the selected `data_type`."
      },
      {
        "slug": "SERPAPI_WALMART_PRODUCT_REVIEWS",
        "name": "Walmart Product Reviews",
        "description": "Tool to scrape full Walmart product reviews using SerpApi's Walmart Product Reviews API. Retrieves ratings, review text, user information, and helpful votes for a specific product. Use when you need detailed customer feedback and sentiment analysis for Walmart products."
      },
      {
        "slug": "SERPAPI_WALMART_SEARCH",
        "name": "Walmart Search",
        "description": "Retrieve Walmart Search Results. Supports parameters like query, location, store ID, etc. Returns product SERP data in JSON format."
      },
      {
        "slug": "SERPAPI_YAHOO_SEARCH",
        "name": "Yahoo Search",
        "description": "Retrieve Yahoo! Search Engine Results. Supports query, location, language, and device parameters."
      },
      {
        "slug": "SERPAPI_YAHOO_VIDEOS",
        "name": "Yahoo Videos Search",
        "description": "Scrape Yahoo! Videos results with position, title, thumbnail, link, preview, source, duration, date and more. Use when you need to search for video content on Yahoo! Videos."
      },
      {
        "slug": "SERPAPI_YANDEX_IMAGES_SEARCH",
        "name": "Yandex Images Search",
        "description": "Tool to search Yandex Images for image results with advanced filters. Use when searching for images on Yandex with filters like size, color, type, or performing reverse image search."
      },
      {
        "slug": "SERPAPI_YANDEX_SEARCH",
        "name": "Yandex Search",
        "description": "Retrieve Yandex Search Results. Supports parameters like text (query), location, etc. Returns SERP data in JSON format."
      },
      {
        "slug": "SERPAPI_YOU_TUBE_SEARCH",
        "name": "YouTube Search",
        "description": "Retrieve YouTube Search Results. Supports parameters like search_query, location, etc. Returns video SERP data in JSON format."
      }
    ],
    "triggers": [],
    "authConfigDetails": [
      {
        "mode": "API_KEY",
        "name": "serpapi_auth",
        "fields": {
          "auth_config_creation": {
            "required": [],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "generic_api_key",
                "displayName": "API Key",
                "type": "string",
                "description": "Your SerpApi private API key, a 64-character string. Sign in and copy it from your Dashboard under 'Your Private API Key' at serpapi.com/manage-api-key.",
                "required": true,
                "default": null
              }
            ],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "jira",
    "name": "Jira",
    "logo": "https://logos.composio.dev/api/jira",
    "description": "A tool for bug tracking, issue tracking, and agile project management.",
    "category": "project management",
    "authSchemes": [
      "OAUTH2",
      "S2S_OAUTH2",
      "API_KEY"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 102,
    "triggerCount": 17,
    "version": "20260908_00",
    "tools": [
      {
        "slug": "JIRA_ADD_ATTACHMENT",
        "name": "Add Attachment",
        "description": "Uploads and attaches a file to a Jira issue."
      },
      {
        "slug": "JIRA_ADD_COMMENT",
        "name": "Add Comment",
        "description": "Adds a comment using Atlassian Document Format (ADF) for rich text to an existing Jira issue."
      },
      {
        "slug": "JIRA_ADD_USERS_TO_PROJECT_ROLE",
        "name": "Add Users to Project Role",
        "description": "Adds users and optionally groups to a project role."
      },
      {
        "slug": "JIRA_ADD_USER_TO_GROUP",
        "name": "Add User to Group",
        "description": "Adds a user to a Jira group."
      },
      {
        "slug": "JIRA_ADD_WATCHER_TO_ISSUE",
        "name": "Add Watcher to Issue",
        "description": "Adds a user to an issue's watcher list by account ID. Requires the authenticated user to have permission to view the issue and manage watchers; insufficient permissions may result in silent failure or an error response."
      },
      {
        "slug": "JIRA_ADD_WORKLOG",
        "name": "Add Worklog",
        "description": "Tool to add a worklog entry to a Jira issue. Use when logging time spent on an issue."
      },
      {
        "slug": "JIRA_ANALYSE_EXPRESSION",
        "name": "Analyse Jira Expression",
        "description": "Analyses Jira expressions for syntax validation, type checking, and complexity analysis. Use when you need to validate Jira expression syntax before using it in automation rules, custom fields, or workflows."
      },
      {
        "slug": "JIRA_ASSIGN_ISSUE",
        "name": "Assign Issue",
        "description": "Assigns a Jira issue to a user, default assignee, or unassigns; supports email/name lookup."
      },
      {
        "slug": "JIRA_BULK_CREATE_ISSUE",
        "name": "Bulk Create Issues",
        "description": "Creates multiple Jira issues (up to 50 per call) with full feature support including markdown, assignee resolution, and priority handling."
      },
      {
        "slug": "JIRA_CHECK_PERMISSIONS",
        "name": "Check User Permissions",
        "description": "Check user permissions for global and project-level operations in Jira. Use this action to verify whether a user has specific permissions at the system level or within projects. Useful for authorization checks before performing operations, or for auditing user access rights."
      },
      {
        "slug": "JIRA_CREATE_BOARD",
        "name": "Create Board",
        "description": "Creates a new Jira board (kanban, scrum, or agility) with optional filter and location configuration. Use this action when you need to set up a new board for a project or create a personal board for tracking work. The board will organize and visualize issues based on the specified filter or project context."
      },
      {
        "slug": "JIRA_CREATE_GROUP",
        "name": "Create Group",
        "description": "Creates a new group in Jira with the specified name."
      },
      {
        "slug": "JIRA_CREATE_ISSUE",
        "name": "Create Issue",
        "description": "Creates a new Jira issue (e.g., bug, task, story) in a specified project. IMPORTANT: Different Jira projects may have custom required fields beyond the standard ones (summary, project_key, issue_type). If issue creation fails with 'field X is required', use JIRA_GET_CREATE_METADATA_ISSUE_TYPE_FIELDS (requires projectIdOrKey and issueTypeId parameters) to discover available fields for your project, or check your Jira project's configuration. Custom fields can be provided via the 'additional_properties' parameter as a JSON string (e.g., '{\"customfield_12345\": \"value\"}'). Rapid bulk creation may trigger HTTP 429 rate limiting; throttle calls and use exponential backoff on 429 responses."
      },
      {
        "slug": "JIRA_CREATE_ISSUE_LINK",
        "name": "Link Issues",
        "description": "Links two Jira issues using a specified link type with optional comment."
      },
      {
        "slug": "JIRA_CREATE_JQL_AUTOCOMPLETEDATA",
        "name": "Get JQL Autocomplete Data",
        "description": "Retrieves JQL autocomplete reference data including reserved words, field names, and function names. Use when building JQL query editors or validating JQL syntax."
      },
      {
        "slug": "JIRA_CREATE_PROJECT",
        "name": "Create Project",
        "description": "Creates a new Jira project with required lead, template, and type configuration."
      },
      {
        "slug": "JIRA_CREATE_SPRINT",
        "name": "Create Sprint",
        "description": "Creates a new sprint on a Jira board with optional start/end dates and goal."
      },
      {
        "slug": "JIRA_CREATE_VERSION",
        "name": "Create Version",
        "description": "Creates a new version for releases or milestones in a Jira project."
      },
      {
        "slug": "JIRA_DELETE_ATTACHMENT",
        "name": "Delete Attachment",
        "description": "Permanently deletes an attachment from Jira by its ID. This action is irreversible — the attachment cannot be recovered once removed. Use this action when you need to remove an unwanted file from a Jira issue."
      },
      {
        "slug": "JIRA_DELETE_COMMENT",
        "name": "Delete Comment",
        "description": "Deletes a specific comment from a Jira issue using its ID and the issue's ID/key; requires user permission to delete comments on the issue."
      },
      {
        "slug": "JIRA_DELETE_ISSUE",
        "name": "Delete Issue",
        "description": "Permanently and irreversibly deletes a Jira issue by its ID or key. Obtain explicit user confirmation before calling."
      },
      {
        "slug": "JIRA_DELETE_VERSION",
        "name": "Delete Version",
        "description": "Deletes a Jira version and optionally reassigns its issues."
      },
      {
        "slug": "JIRA_DELETE_WORKLOG",
        "name": "Delete Worklog",
        "description": "Deletes a worklog from a Jira issue with estimate adjustment options."
      },
      {
        "slug": "JIRA_EDIT_ISSUE",
        "name": "Edit Issue",
        "description": "Updates an existing Jira issue with field values and operations. Supports direct field parameters (summary, description, assignee, priority, etc.) that are merged with the fields parameter. Direct parameters take precedence."
      },
      {
        "slug": "JIRA_EVALUATE_JIRA_EXPRESSION",
        "name": "Evaluate Jira Expression",
        "description": "Tool to evaluate Jira expressions using the enhanced search API. Use when you need to extract or transform data from Jira using Jira expression language. Useful for complex data queries, transformations, and building custom objects from Jira data."
      },
      {
        "slug": "JIRA_FETCH_BULK_ISSUES",
        "name": "Bulk Fetch Issues",
        "description": "Tool to bulk fetch multiple Jira issues by their IDs or keys (max 100 per call). Use when you need to retrieve details for multiple issues efficiently in a single API call."
      },
      {
        "slug": "JIRA_FIND_USERS",
        "name": "Find Users (Deprecated)",
        "description": "DEPRECATED: Use JIRA_FIND_USERS2 instead. Searches for Jira users by email or display name to find account IDs; essential for assigning issues, adding watchers, and other user-related operations. Broad queries may return multiple matches — always disambiguate using full email before selecting an account_id. Results may include app/bot accounts; verify account_type is a human user before use in downstream operations."
      },
      {
        "slug": "JIRA_FIND_USERS2",
        "name": "Find Users 2",
        "description": "Tool to find users in Jira by query string, account ID, or property search. Use when you need to search for users to assign to issues, add as watchers, or perform other user-related operations."
      },
      {
        "slug": "JIRA_FIND_USERS_FOR_PICKER",
        "name": "Find Users For Picker",
        "description": "Find users for picker components by matching query against user attributes like display name and email."
      },
      {
        "slug": "JIRA_GET_ALL_GROUPS",
        "name": "Get All Groups",
        "description": "Retrieves a page of groups from the Jira instance. Useful for resolving correct group names or IDs before passing them to other tools. Some returned groups are system-managed and may be inaccessible via other group operations. Use `start_at`/`max_results` to page through results."
      },
      {
        "slug": "JIRA_GET_ALL_ISSUE_TYPE_SCHEMES",
        "name": "Get All Issue Type Schemes",
        "description": "Retrieves all Jira issue type schemes with optional filtering and pagination."
      },
      {
        "slug": "JIRA_GET_ALL_PROJECTS",
        "name": "Get all projects",
        "description": "Retrieves all visible projects using the modern paginated Jira API with server-side filtering and pagination support. Results reflect only projects the authenticated user can access — small or empty result sets may indicate permission restrictions, not absence of projects. An empty `values` array means no projects matched the filters; relax `query`, `status`, or `categoryId` if unexpected. Project keys are mutable; prefer the stable numeric project ID for durable references in follow-up calls."
      },
      {
        "slug": "JIRA_GET_ALL_STATUSES",
        "name": "Get Issue Statuses",
        "description": "Retrieves all issue statuses associated with workflows from Jira. Returns global statuses that may not be valid for every project or workflow scheme; verify a returned status is applicable to the specific project before use."
      },
      {
        "slug": "JIRA_GET_ALL_USERS",
        "name": "Get All Users",
        "description": "Retrieves all users from the Jira instance including active, inactive, app accounts, and system accounts, with pagination support. On Jira Cloud, fields like `email_address` may be redacted due to privacy settings — never treat them as guaranteed present. Successful responses may silently omit users due to permission restrictions; a smaller-than-expected result set may reflect access limits, not absence of users."
      },
      {
        "slug": "JIRA_GET_ATTACHMENT",
        "name": "Get Attachment",
        "description": "Retrieves the binary content of a Jira attachment by ID. Use when you need to download a specific file attached to an issue."
      },
      {
        "slug": "JIRA_GET_ATTACHMENT_META",
        "name": "Get Attachment Meta",
        "description": "Tool to retrieve Jira attachment settings including upload limits and enabled status. Use when you need to check if attachments are enabled or determine the maximum file size allowed."
      },
      {
        "slug": "JIRA_GET_COMMENT",
        "name": "Get Comment",
        "description": "Retrieves a specific comment by ID from a Jira issue with optional expansions."
      },
      {
        "slug": "JIRA_GET_COMPONENTS",
        "name": "Get Component",
        "description": "Tool to retrieve components from Jira projects with search and filtering. Use when you need to list or find components across projects, optionally filtered by project IDs/keys or search query."
      },
      {
        "slug": "JIRA_GET_CREATE_METADATA_ISSUE_TYPE_FIELDS",
        "name": "Get Create Field Metadata for Issue Type",
        "description": "Tool to retrieve field metadata for a specific issue type in a project. Use this to discover required fields, allowed values, and field configurations before creating issues of a specific type."
      },
      {
        "slug": "JIRA_GET_CURRENT_USER",
        "name": "Get Current User",
        "description": "Retrieves detailed information about the currently authenticated Jira user. The returned `accountId` is the correct identifier for fields like `lead_account_id` in JIRA_CREATE_PROJECT, JIRA_ADD_WATCHER_TO_ISSUE, and JIRA_REMOVE_WATCHER_FROM_ISSUE — never use email or username in those fields."
      },
      {
        "slug": "JIRA_GET_DASHBOARDS",
        "name": "Get Dashboards",
        "description": "Tool to list and search Jira dashboards visible to the current user. Use when you need to discover available dashboards, filter by ownership or favorites, or retrieve dashboard details including permissions and popularity."
      },
      {
        "slug": "JIRA_GET_FAVORITE_FILTERS",
        "name": "Get Favorite Filters",
        "description": "Tool to retrieve favorite filters for the current user. Use when you need to discover which saved filters the user has marked as favorites."
      },
      {
        "slug": "JIRA_GET_FIELDS",
        "name": "Get fields",
        "description": "Tool to retrieve Jira issue fields metadata. Use before editing an issue to discover custom field IDs and names. Custom fields are addressed as customfield_XXXXX in API calls and cf[XXXXX] in JQL; using display names instead causes 400 Unknown field errors. Returns global metadata — cross-reference with JIRA_GET_ISSUE_EDIT_META before editing, as globally visible fields not listed there will also cause 400 errors when sent to JIRA_EDIT_ISSUE. Results are scoped to the authenticated user's permissions, so field sets may differ between users."
      },
      {
        "slug": "JIRA_GET_FIELDS_PAGINATED",
        "name": "Get custom fields paginated",
        "description": "Tool to retrieve Jira fields in pages. Use when you need to filter or page through custom and system fields."
      },
      {
        "slug": "JIRA_GET_FILTER",
        "name": "Get Filter",
        "description": "Retrieves a specific Jira saved filter by ID, including its JQL and sharing metadata, to reuse in subsequent searches. Use when you need to fetch filter details or extract the JQL query to run searches."
      },
      {
        "slug": "JIRA_GET_GROUP",
        "name": "Get Group",
        "description": "Retrieves details of a specific Jira group by name or ID. Use JIRA_GET_ALL_GROUPS to discover valid group names/IDs first. Some system-managed groups may be inaccessible due to permission restrictions even when name/ID is known."
      },
      {
        "slug": "JIRA_GET_INFO",
        "name": "Get Service Management Info",
        "description": "Retrieves runtime information for the Jira Service Management instance. Use when you need to check the version, build date, or license status."
      },
      {
        "slug": "JIRA_GET_ISSUE",
        "name": "Get Issue",
        "description": "Retrieves a Jira issue by ID or key with customizable fields and expansions. Request only needed fields and expansions to avoid large responses. Use specific `customfield_*` keys in `fields` to verify updated values programmatically."
      },
      {
        "slug": "JIRA_GET_ISSUE_CREATE_METADATA",
        "name": "Get Create Issue Metadata (Deprecated)",
        "description": "DEPRECATED: Use JIRA_GET_CREATE_METADATA_ISSUE_TYPE_FIELDS instead. This action wraps the deprecated query-based GET /issue/createmeta endpoint. Tool to retrieve issue creation metadata for Jira projects (available projects, issue types, and required fields)."
      },
      {
        "slug": "JIRA_GET_ISSUE_EDIT_METADATA",
        "name": "Get Issue Edit Meta",
        "description": "Tool to retrieve editable fields for a Jira issue. Use before running an edit action to fetch custom field metadata and required fields."
      },
      {
        "slug": "JIRA_GET_ISSUE_LINK_TYPES",
        "name": "Get Issue Link Types",
        "description": "Retrieves all configured issue link types from Jira."
      },
      {
        "slug": "JIRA_GET_ISSUE_PICKER_SUGGESTIONS",
        "name": "Get issue picker",
        "description": "Tool to get issue picker suggestions from Jira. Use when you need to search for issues and get auto-completion suggestions."
      },
      {
        "slug": "JIRA_GET_ISSUE_PROPERTY",
        "name": "Get Issue Property",
        "description": "Retrieves a custom property from a Jira issue by key."
      },
      {
        "slug": "JIRA_GET_ISSUE_RESOLUTIONS",
        "name": "Get Issue Resolutions",
        "description": "Retrieves all available issue resolution types from Jira."
      },
      {
        "slug": "JIRA_GET_ISSUE_TYPES",
        "name": "Get issue types",
        "description": "Retrieves all Jira issue types available to the user using the modern API v3 endpoint; results vary based on 'Administer Jira' global or 'Browse projects' project permissions. Response includes two shapes: global issue types (no scope field) and project-scoped types (include scope.project.id); deduplicate by id, not name. Always use issuetype.id (not display name) when referencing issue types in other API calls to avoid validation errors."
      },
      {
        "slug": "JIRA_GET_ISSUE_WATCHERS",
        "name": "Get Issue Watchers",
        "description": "Retrieves users watching a Jira issue for update notifications. Watcher data access may be restricted by Jira permissions. Returns all watchers; filter client-side by `accountId` to check if a specific user is watching."
      },
      {
        "slug": "JIRA_GET_ISSUE_WORKLOGS",
        "name": "Get Issue Worklogs (Deprecated)",
        "description": "DEPRECATED: Use JIRA_GET_WORKLOG instead. This action is deprecated because it lacks the expand parameter for worklog properties. Use JIRA_GET_WORKLOG which provides the same functionality plus the ability to expand worklog properties using the 'expand' parameter. Legacy description: Retrieves worklogs for a Jira issue with user permission checks."
      },
      {
        "slug": "JIRA_GET_JQL_AUTOCOMPLETEDATA",
        "name": "Get JQL autocomplete reference data",
        "description": "Tool to retrieve JQL autocomplete reference data. Use when you need to discover available JQL fields, functions, and reserved words for building queries."
      },
      {
        "slug": "JIRA_GET_JQL_AUTOCOMPLETEDATA_SUGGESTIONS",
        "name": "Get JQL autocomplete suggestions",
        "description": "Tool to get JQL field auto-complete suggestions. Use when building JQL queries to discover valid field values or predicate options."
      },
      {
        "slug": "JIRA_GET_MY_PERMISSIONS",
        "name": "Get My Permissions",
        "description": "Tool to retrieve the user's permissions in Jira. Use when checking what actions the authenticated user can perform in a specific context (project, issue, or comment)."
      },
      {
        "slug": "JIRA_GET_MYPREFERENCES_LOCALE",
        "name": "Get User Locale Preference",
        "description": "Tool to retrieve the locale preference of the currently authenticated Jira user. Use when you need to know the user's language and regional settings."
      },
      {
        "slug": "JIRA_GET_PERMISSIONS",
        "name": "Get Permissions",
        "description": "Tool to retrieve all available Jira permissions. Use when you need to list all permission types that exist in Jira, including project and global permissions."
      },
      {
        "slug": "JIRA_GET_PERMITTED_PROJECTS",
        "name": "Get Permitted Projects",
        "description": "Tool to retrieve projects where the current user has specific permissions. Use when you need to find which projects a user can access with certain permission levels."
      },
      {
        "slug": "JIRA_GET_PROJECT",
        "name": "Get Project",
        "description": "Retrieves details of a Jira project by its ID or key."
      },
      {
        "slug": "JIRA_GET_PROJECT_ROLES",
        "name": "Get Project Roles",
        "description": "Retrieves all available roles for a Jira project. Role IDs are project-specific and must not be reused across projects; call this action per project to obtain correct role IDs."
      },
      {
        "slug": "JIRA_GET_PROJECT_TEMPLATES",
        "name": "Get Project Templates",
        "description": "Retrieves available Jira project templates for creating projects. Returns template keys that can be used with the Create Project action. Use this action when you need to discover valid project template keys before creating a project."
      },
      {
        "slug": "JIRA_GET_PROJECT_TYPE",
        "name": "Get Project Type",
        "description": "Retrieves detailed information about a specific Jira project type by its key. Use when you need to get metadata about project types like software, service desk, business, or product discovery projects."
      },
      {
        "slug": "JIRA_GET_PROJECT_VERSIONS",
        "name": "Get Project Versions",
        "description": "Retrieves all versions for a Jira project with optional expansion. Use version IDs from the response (not names) when setting fixVersions or affectedVersions on issues — submitting names alone causes 400 validation errors."
      },
      {
        "slug": "JIRA_GET_RECENT_PROJECTS",
        "name": "Get Recent Projects",
        "description": "Retrieves a list of projects recently accessed by the authenticated user."
      },
      {
        "slug": "JIRA_GET_REMOTE_ISSUE_LINKS",
        "name": "Get Issue Remote Links",
        "description": "Retrieves links from a Jira issue to external resources."
      },
      {
        "slug": "JIRA_GET_SERVER_INFO",
        "name": "Get Server Info",
        "description": "Tool to retrieve Jira instance server information. Use when you need details about the Jira version, build, deployment type, or server configuration."
      },
      {
        "slug": "JIRA_GET_SERVICE_DESK_REQUEST_TYPE_FIELDS",
        "name": "Get Service Desk Request Type Fields",
        "description": "Tool to retrieve JSM request type field metadata for filling out portal requests. Use when you need to know which fields are required and their valid values."
      },
      {
        "slug": "JIRA_GET_SPRINT",
        "name": "Get Sprint",
        "description": "Retrieves detailed information about a specific sprint by its ID. Use this action when you need to fetch a single sprint's details directly by ID, such as checking sprint status, dates, goal, or metadata. For finding sprint IDs, use JIRA_LIST_SPRINTS first."
      },
      {
        "slug": "JIRA_GET_SYSTEM_AVATARS",
        "name": "Get System Avatars",
        "description": "Tool to retrieve all system avatars for a specific type (issuetype, project, user, or priority). Use when you need to get a list of available default avatars that can be assigned to Jira entities."
      },
      {
        "slug": "JIRA_GET_TRANSITIONS",
        "name": "Get Transitions",
        "description": "Retrieves available workflow transitions for a Jira issue. Always use the numeric `id` from the response when calling JIRA_TRANSITION_ISSUE — transition IDs are project/workflow-specific and must not be hardcoded or reused across different issues or projects. When multiple transitions share similar names, use `id` to disambiguate."
      },
      {
        "slug": "JIRA_GET_UNIVERSAL_AVATAR_TYPE_OWNER",
        "name": "Get Universal Avatar Type Owner",
        "description": "Tool to retrieve all avatars (system and custom) for a specific type and entity in Jira. Use when you need to view available avatar options for projects, issue types, or priorities."
      },
      {
        "slug": "JIRA_GET_UNIVERSAL_AVATAR_VIEW_TYPE",
        "name": "Get Universal Avatar View Type",
        "description": "Tool to retrieve the default avatar image for a specific type (project, issuetype, or priority) from Jira. Use when you need to download the default avatar for a type."
      },
      {
        "slug": "JIRA_GET_USER_GROUPS",
        "name": "Get User Groups",
        "description": "Retrieves all groups for a specific Jira user by account ID. Use this action when you need to check group membership for a particular user, verify permissions, or audit user access. Essential for understanding which groups a user belongs to before performing group-related operations."
      },
      {
        "slug": "JIRA_GET_VIEW_TYPE_AVATAR",
        "name": "Get Avatar Image",
        "description": "Tool to retrieve a specific avatar image by type and ID from Jira. Use when you need to download avatar images for projects, issue types, or priorities."
      },
      {
        "slug": "JIRA_GET_VOTES",
        "name": "Get Issue Votes",
        "description": "Fetches voting details for a Jira issue; requires voting to be enabled in Jira's general settings."
      },
      {
        "slug": "JIRA_GET_WORKLOG",
        "name": "Get Worklogs",
        "description": "Retrieves worklogs for a specified Jira issue."
      },
      {
        "slug": "JIRA_LIST_ALL_PROJECTS",
        "name": "List All Projects (Deprecated)",
        "description": "DEPRECATED: Use JIRA_GET_ALL_PROJECTS instead. Tool to list all projects accessible to the user. Wraps the deprecated GET /project endpoint; prefer the paginated JIRA_GET_ALL_PROJECTS (GET /project/search)."
      },
      {
        "slug": "JIRA_LIST_BOARDS",
        "name": "List Boards",
        "description": "Retrieves paginated Jira boards with filtering and sorting options. Use `start_at` and `max_results` together, looping through pages to retrieve all results."
      },
      {
        "slug": "JIRA_LIST_COMMENTS",
        "name": "List Comments by IDs",
        "description": "Tool to retrieve multiple comments by their IDs in a single request. Use when you need to fetch specific comments efficiently. Supports up to 1000 comment IDs per request with optional expansion for rendered HTML and properties."
      },
      {
        "slug": "JIRA_LIST_FILTERS",
        "name": "List Jira Filters",
        "description": "Tool to search and list Jira saved filters (saved searches) visible to the current user. Use when you need to discover existing filters, find filters by name or owner, or get filter details including JQL queries and sharing permissions."
      },
      {
        "slug": "JIRA_LIST_GROUPS_PICKER",
        "name": "List Groups (Picker)",
        "description": "Tool to search and list groups using Jira's picker endpoint. Use when you need to find groups by name or get a filtered list of groups."
      },
      {
        "slug": "JIRA_LIST_ISSUE_COMMENTS",
        "name": "List Issue Comments",
        "description": "Retrieves paginated comments from a Jira issue with optional ordering. Paginate by incrementing `start_at` by `max_results` until the cumulative count reaches the `total` field in the response. A response with `total=0` and an empty comments array means the issue has no comments."
      },
      {
        "slug": "JIRA_LIST_PROJECT_TYPES",
        "name": "List Project Types",
        "description": "Retrieves all Jira project types available in the instance. Use when you need to discover available project types or list all types without filtering by a specific key."
      },
      {
        "slug": "JIRA_LIST_SPRINTS",
        "name": "List Sprints",
        "description": "Retrieves paginated sprints from a Jira board with optional state filtering."
      },
      {
        "slug": "JIRA_MOVE_ISSUE_TO_SPRINT",
        "name": "Move Issues to Sprint",
        "description": "Moves one or more Jira issues to a specified active sprint."
      },
      {
        "slug": "JIRA_PARSE_JQL_QUERIES",
        "name": "Parse JQL Queries",
        "description": "Parse and validate JQL queries, returning their abstract syntax tree structure along with any errors or warnings. Use when you need to validate JQL syntax or understand query structure before execution."
      },
      {
        "slug": "JIRA_REMOVE_USER_FROM_GROUP",
        "name": "Remove User from Group",
        "description": "Removes a user from a Jira group. This is a destructive operation that revokes group-based permissions; confirm intent before calling."
      },
      {
        "slug": "JIRA_REMOVE_USER_FROM_PROJECT_ROLE",
        "name": "Remove User from Project Role",
        "description": "Removes a user or group from a project role."
      },
      {
        "slug": "JIRA_REMOVE_WATCHER_FROM_ISSUE",
        "name": "Remove Watcher from Issue",
        "description": "Removes a user from an issue's watcher list by account ID."
      },
      {
        "slug": "JIRA_SEARCH_APPROXIMATE_COUNT",
        "name": "Search Approximate Count",
        "description": "Count issues matching a JQL query using approximate count endpoint. Use when you need a fast count of issues without retrieving full issue details. The JQL query must be bounded (include at least one search restriction)."
      },
      {
        "slug": "JIRA_SEARCH_DASHBOARDS",
        "name": "Search Dashboards",
        "description": "Tool to search for Jira dashboards with filtering, sorting, and pagination support. Use when you need to find dashboards by name, owner, sharing permissions, or status. Supports filtering by owner account ID, group, project, and dashboard name."
      },
      {
        "slug": "JIRA_SEARCH_FOR_ISSUES_USING_JQL_GET",
        "name": "Search Issues Using JQL (GET)",
        "description": "Searches for Jira issues using JQL with pagination and field selection."
      },
      {
        "slug": "JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST",
        "name": "Search Issues Using JQL Enhanced (POST)",
        "description": "DEPRECATED: Use JIRA_SEARCH_ISSUES instead. Searches for Jira Cloud issues using Enhanced JQL via POST request; supports eventual consistency and token-based pagination. Use this POST endpoint for long/complex JQL to avoid HTTP 414 errors on GET-based search. IMPORTANT: This action is for Jira Cloud only and will not work with Jira Server or Data Center instances."
      },
      {
        "slug": "JIRA_SEARCH_ISSUES",
        "name": "Search issues",
        "description": "Advanced Jira issue search supporting structured filters and raw JQL. At least one filter parameter (e.g., jql, project_key, updated_after) is required; calls with no parameters will be rejected."
      },
      {
        "slug": "JIRA_SEND_NOTIFICATION_FOR_ISSUE",
        "name": "Send Notification for Issue",
        "description": "Sends a customized email notification for a Jira issue."
      },
      {
        "slug": "JIRA_TRANSITION_ISSUE",
        "name": "Transition Issue",
        "description": "Transitions a Jira issue to a different workflow state, with support for transition name lookup and user assignment by email. IMPORTANT: Only fields that are on the transition's screen can be set during the transition. Which fields are available depends on the Jira workflow configuration and varies per project. Use JIRA_GET_TRANSITIONS with expand='transitions.fields' to check which fields a transition supports. If a field (e.g., assignee) is not on the transition screen, use a JIRA_EDIT_ISSUE action after the transition to set other fields."
      },
      {
        "slug": "JIRA_UPDATE_COMMENT",
        "name": "Update Comment",
        "description": "Updates text content or visibility of an existing Jira comment."
      }
    ],
    "triggers": [
      {
        "slug": "JIRA_COMMENT_CREATED",
        "name": "Comment Created",
        "description": "Triggers when a comment is posted on a Jira issue. Can deliver comments\non issues the connected account cannot open in Jira itself."
      },
      {
        "slug": "JIRA_COMMENT_DELETED",
        "name": "Comment Deleted",
        "description": "Triggers when a comment is deleted from a Jira issue. The deleted\ncomment's text still arrives. Can deliver comments on issues the connected\naccount cannot open in Jira itself."
      },
      {
        "slug": "JIRA_COMMENT_UPDATED",
        "name": "Comment Updated",
        "description": "Triggers when an existing comment on a Jira issue is edited. The payload\ncarries the comment as it now reads, not what it said before. Can deliver\ncomments on issues the connected account cannot open in Jira itself."
      },
      {
        "slug": "JIRA_ISSUE_CREATED",
        "name": "Issue Created",
        "description": "Triggers when an issue is created in Jira, including a sub-task. Can\ndeliver issues the connected account cannot open in Jira itself."
      },
      {
        "slug": "JIRA_ISSUE_DELETED",
        "name": "Issue Deleted",
        "description": "Triggers when an issue is deleted from Jira. The deleted issue's full\nfield set still arrives, so the filters below apply to it as usual. Can\ndeliver issues the connected account cannot open in Jira itself."
      },
      {
        "slug": "JIRA_ISSUE_UPDATED",
        "name": "Issue Updated",
        "description": "Triggers when a field on an existing issue changes — its status, assignee,\nor anything else on the issue. One edit can change several fields and arrives\nas one event; creating a sub-task also updates its parent. Commenting does not\nfire it. Can deliver issues the connected account cannot open in Jira itself."
      },
      {
        "slug": "JIRA_SPRINT_CLOSED",
        "name": "Sprint Closed",
        "description": "Triggers when a sprint is completed and moves into the closed state."
      },
      {
        "slug": "JIRA_SPRINT_CREATED",
        "name": "Sprint Created",
        "description": "Triggers when a sprint is created on a Jira board. Creating a sprint does\nnot start it — watch Sprint Started for that."
      },
      {
        "slug": "JIRA_SPRINT_STARTED",
        "name": "Sprint Started",
        "description": "Triggers when a sprint moves into the active state."
      },
      {
        "slug": "JIRA_SPRINT_UPDATED",
        "name": "Sprint Updated",
        "description": "Triggers when a sprint's name, goal, dates or state changes. Starting a\nsprint also fires this when the same call changed another field; closing one\ndoes not."
      },
      {
        "slug": "JIRA_VERSION_CREATED",
        "name": "Version Created",
        "description": "Triggers when a project version is created in Jira."
      },
      {
        "slug": "JIRA_VERSION_DELETED",
        "name": "Version Deleted",
        "description": "Triggers when a project version is deleted outright. A version that\ndisappeared because it was merged into another one fires Version Merged\ninstead."
      },
      {
        "slug": "JIRA_VERSION_MERGED",
        "name": "Version Merged",
        "description": "Triggers when a project version is merged into another one, carrying both\nthe version that went away and the one that survived."
      },
      {
        "slug": "JIRA_VERSION_MOVED",
        "name": "Version Moved",
        "description": "Triggers when a project version is reordered within its project's release\nlist."
      },
      {
        "slug": "JIRA_VERSION_RELEASED",
        "name": "Version Released",
        "description": "Triggers when a project version is marked released."
      },
      {
        "slug": "JIRA_VERSION_UNRELEASED",
        "name": "Version Unreleased",
        "description": "Triggers when a released project version is put back to unreleased."
      },
      {
        "slug": "JIRA_VERSION_UPDATED",
        "name": "Version Updated",
        "description": "Triggers when a project version's name, description or dates change.\nReleasing and un-releasing a version each fire this as well, alongside\nVersion Released and Version Unreleased."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "jira_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "read:jira-work,write:jira-work,manage:jira-project,manage:jira-configuration,read:jira-user,manage:jira-webhook,manage:jira-data-provider,read:servicedesk-request,manage:servicedesk-customer,write:servicedesk-request,read:servicemanagement-insight-objects,offline_access,read:sprint:jira-software,write:sprint:jira-software,read:board-scope:jira-software,write:board-scope:jira-software,read:project:jira,read:issue-type-scheme:jira"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "subdomain",
                "displayName": "Your Subdomain",
                "type": "string",
                "description": "The part of your Jira web address before .atlassian.net — e.g. 'acme' for acme.atlassian.net. Open Jira and copy it from your browser's address bar.",
                "required": true,
                "default": null
              }
            ],
            "optional": []
          }
        }
      },
      {
        "mode": "API_KEY",
        "name": "API_KEY",
        "fields": {
          "auth_config_creation": {
            "required": [],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "subdomain",
                "displayName": "Your Subdomain",
                "type": "string",
                "description": "The part of your Jira web address before .atlassian.net — e.g. 'acme' for acme.atlassian.net. Open Jira and copy it from your browser's address bar.",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "basic_encoded",
                "displayName": "Base Encode (Deprecated)",
                "type": "string",
                "description": "Deprecated — leave this blank. Composio builds it automatically from your email and API token above. Only fill if instructed, using the Base64 of 'email:api-token'.",
                "required": false,
                "default": null
              },
              {
                "name": "generic_api_key",
                "displayName": "API Key (Required)",
                "type": "string",
                "description": "An Atlassian API token — it acts as your password. Create one at id.atlassian.com/manage-profile/security/api-tokens and copy it right away; it's shown only once.",
                "required": false,
                "default": null
              },
              {
                "name": "generic_id",
                "displayName": "Jira Email (Required)",
                "type": "string",
                "description": "The email you sign in to Jira/Atlassian with (e.g. [email protected]). It must match the account that created the API token below.",
                "required": false,
                "default": null
              }
            ]
          }
        }
      },
      {
        "mode": "S2S_OAUTH2",
        "name": "jira_s2s_oauth2",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client ID",
                "type": "string",
                "description": "OAuth Client ID from Atlassian admin service account credentials",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client Secret",
                "type": "string",
                "description": "OAuth Client Secret from Atlassian admin service account credentials",
                "required": true,
                "default": null
              }
            ],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "subdomain",
                "displayName": "Your Subdomain",
                "type": "string",
                "description": "The part of your Jira web address before .atlassian.net — e.g. 'acme' for acme.atlassian.net. Open Jira and copy it from your browser's address bar.",
                "required": true,
                "default": null
              }
            ],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "firecrawl",
    "name": "Firecrawl",
    "logo": "https://logos.composio.dev/api/firecrawl",
    "description": "Firecrawl automates web crawling and data extraction, enabling organizations to gather content, index sites, and gain insights from online sources at scale",
    "category": "ai web scraping",
    "authSchemes": [
      "API_KEY"
    ],
    "toolCount": 30,
    "triggerCount": 0,
    "version": "20260903_00",
    "tools": [
      {
        "slug": "FIRECRAWL_AGENT_CANCEL",
        "name": "Cancel an agent job",
        "description": "Tool to cancel an in-progress agent job by its ID. Use when you need to terminate an active agent operation. The API returns a success boolean upon cancellation."
      },
      {
        "slug": "FIRECRAWL_BATCH_SCRAPE",
        "name": "Batch scrape multiple URLs",
        "description": "Tool to scrape multiple URLs in batch with concurrent processing. Use when you need to scrape multiple web pages efficiently with customizable formats and content filtering."
      },
      {
        "slug": "FIRECRAWL_BATCH_SCRAPE_CANCEL",
        "name": "Cancel a batch scrape job",
        "description": "Tool to cancel a running batch scrape job using its unique identifier. Use when you need to terminate an in-progress batch scrape operation."
      },
      {
        "slug": "FIRECRAWL_BATCH_SCRAPE_GET",
        "name": "Get batch scrape status",
        "description": "Retrieves the current status and results of a batch scrape job using the job ID. Use this to check batch scrape progress and retrieve scraped data."
      },
      {
        "slug": "FIRECRAWL_BATCH_SCRAPE_GET_ERRORS",
        "name": "Get errors from batch scrape job",
        "description": "Tool to retrieve error details from a batch scrape job, including failed URLs and URLs blocked by robots.txt. Use when you need to debug or understand why certain pages failed to scrape in a batch operation."
      },
      {
        "slug": "FIRECRAWL_CRAWL",
        "name": "Start a web crawl",
        "description": "Initiates a Firecrawl web crawl from a given URL, applying various filtering and content extraction rules, and polls until the job is complete; ensure the URL is accessible and any regex patterns for paths are valid."
      },
      {
        "slug": "FIRECRAWL_CRAWL_CANCEL",
        "name": "Cancel a crawl job",
        "description": "Cancels an active or queued web crawl job using its ID; attempting to cancel completed, failed, or previously canceled jobs will not change their state."
      },
      {
        "slug": "FIRECRAWL_CRAWL_DELETE",
        "name": "Cancel a crawl job",
        "description": "Tool to cancel a running crawl job by its ID. Use when you need to stop an active crawl operation. The API returns a status of 'cancelled' upon successful cancellation."
      },
      {
        "slug": "FIRECRAWL_CRAWL_GET",
        "name": "Get crawl job status",
        "description": "Tool to retrieve the status and results of a Firecrawl crawl job. Use when you need to check the progress or get data from an ongoing or completed crawl operation. Returns crawl status, progress metrics, credits used, and the crawled page data."
      },
      {
        "slug": "FIRECRAWL_CRAWL_GET_ERRORS",
        "name": "Get errors from a crawl job",
        "description": "Tool to retrieve errors from a Firecrawl crawl job. Use when you need to understand why certain pages failed to scrape or which URLs were blocked by robots.txt during a crawl operation."
      },
      {
        "slug": "FIRECRAWL_CRAWL_LIST_ACTIVE",
        "name": "Get all active crawl jobs",
        "description": "Tool to retrieve all active crawl jobs for the authenticated team. Use when you need to see which crawl operations are currently running."
      },
      {
        "slug": "FIRECRAWL_CRAWL_PARAMS_PREVIEW",
        "name": "Preview crawl parameters",
        "description": "Preview crawl parameters before starting a crawl by generating optimal configuration from natural language instructions. Use this tool to understand what crawl settings will be applied based on your requirements before executing a full crawl operation. The endpoint intelligently interprets natural language prompts to configure crawl parameters like include/exclude paths, depth limits, and domain scope."
      },
      {
        "slug": "FIRECRAWL_CRAWL_V2",
        "name": "Start a web crawl (v2) [NEW]",
        "description": "[NEW v2 API] Initiates a Firecrawl v2 web crawl with enhanced features over v1: natural language prompts for automatic crawler configuration, crawlEntireDomain for sibling/parent page discovery, better depth control with maxDiscoveryDepth, subdomain support, and full webhook configuration. Polls until crawl is complete."
      },
      {
        "slug": "FIRECRAWL_CREDIT_USAGE_GET",
        "name": "Get team credit usage",
        "description": "Tool to get current team credit usage information. Use when you need to check remaining credits or billing period details."
      },
      {
        "slug": "FIRECRAWL_CREDIT_USAGE_GET_HISTORICAL",
        "name": "Get historical team credit usage",
        "description": "Tool to retrieve historical team credit usage on a monthly basis. Use when you need to analyze credit consumption patterns over time, optionally segmented by API key."
      },
      {
        "slug": "FIRECRAWL_DEEP_RESEARCH",
        "name": "Perform deep research",
        "description": "Initiates an AI-powered deep research operation that autonomously explores the web to investigate any topic and synthesizes findings from multiple sources. Requires an active Firecrawl connection. The research process iteratively searches, analyzes, and synthesizes information across multiple web sources, providing comprehensive insights with source citations. Results include a final analysis, detailed activity timeline, and curated source list. Billing: 1 credit per URL analyzed. Control costs with the maxUrls parameter. Note: This API is in Alpha and being deprecated after June 30, 2025; prefer FIRECRAWL_SEARCH + FIRECRAWL_EXTRACT or COMPOSIO_SEARCH_WEB for durable workflows. Reserve this tool for cases requiring synthesized multi-source analysis — it is slower and more resource-intensive than FIRECRAWL_SEARCH."
      },
      {
        "slug": "FIRECRAWL_EXTRACT",
        "name": "Extract structured data",
        "description": "Extracts structured data from web pages by initiating an extraction job and polling for completion; requires a natural language `prompt` or a JSON `schema` (one must be provided)."
      },
      {
        "slug": "FIRECRAWL_EXTRACT_GET",
        "name": "Get extract job status",
        "description": "Tool to retrieve the status and results of a previously submitted extract job. Use when you need to check the progress or get the final results of an extraction operation."
      },
      {
        "slug": "FIRECRAWL_GET_AGENT_STATUS",
        "name": "Get agent job status",
        "description": "Tool to get the status and results of an agent job. Use when you need to check if an agent job has completed and retrieve the collected data. Agent jobs autonomously search, navigate, and extract data from the web."
      },
      {
        "slug": "FIRECRAWL_GET_DEEP_RESEARCH_STATUS",
        "name": "Get deep research status",
        "description": "Retrieves the status and results of a deep research job by its ID. Use when you need to check the progress or retrieve the final analysis of a deep research operation."
      },
      {
        "slug": "FIRECRAWL_GET_THE_STATUS_OF_A_CRAWL_JOB",
        "name": "Get the status of a crawl job",
        "description": "Retrieves the current status, progress, and details of a web crawl job, using the job ID obtained when the crawl was initiated."
      },
      {
        "slug": "FIRECRAWL_LLMS_TXT_GENERATE",
        "name": "Generate LLMs.txt for a website",
        "description": "Initiates an async job to generate an LLMs.txt file for a website, converting web content into LLM-friendly format. Returns a job ID to check status and retrieve results. Use when you need to create a standardized, machine-readable representation of website content for language models."
      },
      {
        "slug": "FIRECRAWL_LLMS_TXT_GET",
        "name": "Get LLMs.txt generation job status",
        "description": "Tool to get the status and results of an LLMs.txt generation job. Use when you need to check if a job has completed and retrieve the generated content."
      },
      {
        "slug": "FIRECRAWL_MAP_MULTIPLE_URLS_BASED_ON_OPTIONS",
        "name": "Map multiple URLs",
        "description": "Maps a website by discovering URLs from a starting base URL, with options to customize the crawl via search query, subdomain inclusion, sitemap handling, and result limits; search effectiveness is site-dependent."
      },
      {
        "slug": "FIRECRAWL_QUEUE_GET",
        "name": "Get team queue status",
        "description": "Tool to retrieve metrics about the team's scrape queue. Use when you need to check queue status, job counts, or concurrency limits."
      },
      {
        "slug": "FIRECRAWL_SCRAPE",
        "name": "Scrape URL",
        "description": "Scrapes a publicly accessible URL, optionally performing pre-scrape browser actions or extracting structured JSON using an LLM, to retrieve content in specified formats."
      },
      {
        "slug": "FIRECRAWL_SEARCH",
        "name": "Search",
        "description": "Performs a web search for a query, scrapes content from the top search results using Firecrawl, and returns details in specified formats."
      },
      {
        "slug": "FIRECRAWL_START_AGENT",
        "name": "Start an agent job",
        "description": "Tool to start an agent job for agentic web extraction with multi-page navigation and interaction capabilities. Use when you need to autonomously gather data from the web with complex navigation requirements. The agent can search, navigate, and extract information across multiple pages based on your natural language prompt."
      },
      {
        "slug": "FIRECRAWL_TOKEN_USAGE_GET",
        "name": "Get team token usage",
        "description": "Tool to retrieve the current team's token usage and balance information for Firecrawl's Extract feature. Use when you need to check remaining token credits, plan allocation, or billing period details."
      },
      {
        "slug": "FIRECRAWL_TOKEN_USAGE_GET_HISTORICAL",
        "name": "Get historical team token usage",
        "description": "Tool to retrieve historical team token usage on a monthly basis. Use when you need to analyze token consumption patterns over time, optionally segmented by API key."
      }
    ],
    "triggers": [],
    "authConfigDetails": [
      {
        "mode": "API_KEY",
        "name": "firecrawl_api_key",
        "fields": {
          "auth_config_creation": {
            "required": [],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "full",
                "displayName": "Base URL",
                "type": "string",
                "description": "The Firecrawl API web address. Most accounts can keep the default https://api.firecrawl.dev/v1. If you self-host Firecrawl, enter your server's address ending in /v1.",
                "required": true,
                "default": "https://api.firecrawl.dev/v1"
              },
              {
                "name": "generic_api_key",
                "displayName": "API Key",
                "type": "string",
                "description": "Your Firecrawl API key, a token starting with fc- (e.g. fc-12345...). Sign in and copy it from the API Keys page: https://www.firecrawl.dev/app/api-keys",
                "required": true,
                "default": null
              }
            ],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "tavily",
    "name": "Tavily",
    "logo": "https://logos.composio.dev/api/tavily",
    "description": "Tavily offers search and data retrieval solutions, helping teams quickly locate and filter relevant information from documents, databases, or web sources",
    "category": "ai web scraping",
    "authSchemes": [
      "API_KEY"
    ],
    "toolCount": 5,
    "triggerCount": 0,
    "version": "20260717_00",
    "tools": [
      {
        "slug": "TAVILY_CRAWL",
        "name": "Tavily crawl",
        "description": "Tool to perform intelligent graph-based website crawling with parallel path exploration and content extraction. Use when you need to traverse and extract content from multiple pages of a website following specific patterns or instructions. Supports depth/breadth controls, domain filtering, and natural language instructions for guided crawling."
      },
      {
        "slug": "TAVILY_EXTRACT",
        "name": "Tavily extract",
        "description": "Tool to extract and parse web page content from specified URLs using Tavily's extract endpoint. Use when you need to retrieve clean, structured content from web pages with optional image extraction and content reranking based on query relevance."
      },
      {
        "slug": "TAVILY_GET_USAGE",
        "name": "Get Tavily usage",
        "description": "Tool to retrieve API key and account usage statistics from Tavily. Use when you need to check credit consumption, limits, and per-endpoint usage for search, extract, crawl, map, and research operations."
      },
      {
        "slug": "TAVILY_MAP",
        "name": "Tavily map website",
        "description": "Tool to map a website and discover its pages. Use when you need to scan a website and get a structured list of URLs/pages it contains without extracting full content."
      },
      {
        "slug": "TAVILY_SEARCH",
        "name": "Tavily search",
        "description": "Use this to perform a web search via the Tavily API; offers controls for search depth, content types, result count, and domain filtering. Requires an active Tavily connection (401 = auth failure). Rate limit: ~2 req/s; apply exponential backoff on HTTP 429. Results are nested under response_data.results (not a flat list). Subject to HTTP 429 on rapid bursts."
      }
    ],
    "triggers": [],
    "authConfigDetails": [
      {
        "mode": "API_KEY",
        "name": "tavily_scheme",
        "fields": {
          "auth_config_creation": {
            "required": [],
            "optional": []
          },
          "connected_account_initiation": {
            "required": [
              {
                "name": "generic_api_key",
                "displayName": "API Key",
                "type": "string",
                "description": "Your Tavily API key (starts with 'tvly-', e.g. tvly-dev-abc123). Sign in at app.tavily.com and copy it from the API Keys section; either key type works.",
                "required": true,
                "default": null
              }
            ],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "youtube",
    "name": "YouTube",
    "logo": "https://logos.composio.dev/api/youtube",
    "description": "YouTube is a video-sharing platform with user-generated content, live streaming, and monetization opportunities, widely used for marketing, education, and entertainment",
    "category": "video & audio",
    "authSchemes": [
      "OAUTH2"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 51,
    "triggerCount": 4,
    "version": "20260721_00",
    "tools": [
      {
        "slug": "YOUTUBE_ADD_VIDEO_TO_PLAYLIST",
        "name": "Add Video to Playlist",
        "description": "Tool to add a video to a playlist by inserting a playlist item. Use when organizing videos into playlists or building curated collections."
      },
      {
        "slug": "YOUTUBE_CREATE_CHANNEL_SECTION",
        "name": "Insert Channel Section",
        "description": "Tool to create a new channel section for the authenticated user's YouTube channel. Use when organizing channel content into sections like featured playlists, recent uploads, or featured channels."
      },
      {
        "slug": "YOUTUBE_CREATE_COMMENT_REPLY",
        "name": "Insert Comment Reply",
        "description": "Tool to create a reply to an existing YouTube comment. Use when responding to user comments or engaging in conversations on videos."
      },
      {
        "slug": "YOUTUBE_CREATE_PLAYLIST",
        "name": "Create Playlist",
        "description": "Tool to create a new YouTube playlist on the authenticated user's channel. Use when organizing videos into collections or building curated playlists."
      },
      {
        "slug": "YOUTUBE_DELETE_CHANNEL_SECTION",
        "name": "Delete Channel Section",
        "description": "Tool to delete a YouTube channel section. Use when you need to remove a channel section from a channel. The channel section must exist and the authenticated user must have permission to delete it."
      },
      {
        "slug": "YOUTUBE_DELETE_COMMENT",
        "name": "Delete Comment",
        "description": "Tool to delete a YouTube comment owned by the authenticated user or channel. Use when you need to remove a comment from a video. The comment must exist and be owned by the authenticated channel."
      },
      {
        "slug": "YOUTUBE_DELETE_PLAYLIST",
        "name": "Delete Playlist",
        "description": "Tool to delete a YouTube playlist owned by the authenticated user/channel. Use when you need to permanently remove a playlist from YouTube. Requires explicit confirmation via `confirmDelete: true` to prevent accidental deletions."
      },
      {
        "slug": "YOUTUBE_DELETE_PLAYLIST_ITEM",
        "name": "Delete Playlist Item",
        "description": "Tool to delete a playlist item (remove a video from a playlist). Use when removing specific videos from playlists."
      },
      {
        "slug": "YOUTUBE_DELETE_VIDEO",
        "name": "Delete Video",
        "description": "Tool to delete a YouTube video owned by the authenticated user/channel. Use when you need to permanently remove a video from YouTube. Requires explicit confirmation via `confirmDelete: true` to prevent accidental deletions. The video must exist and be owned by the authenticated channel."
      },
      {
        "slug": "YOUTUBE_GET_CHANNEL_ACTIVITIES",
        "name": "Get Channel Activities",
        "description": "Gets recent activities from a YouTube channel including video uploads, playlist additions, likes, and other channel events."
      },
      {
        "slug": "YOUTUBE_GET_CHANNEL_ID_BY_HANDLE",
        "name": "Get channel ID by handle",
        "description": "Retrieves the YouTube Channel ID for a specific YouTube channel handle."
      },
      {
        "slug": "YOUTUBE_GET_CHANNEL_STATISTICS",
        "name": "Get Channel Statistics",
        "description": "Gets detailed statistics for YouTube channels including subscriber counts, view counts, and video counts. Channels can be identified using their ID, handle (e.g., @Google), or username."
      },
      {
        "slug": "YOUTUBE_GET_VIDEO_DETAILS_BATCH",
        "name": "Video Details Batch",
        "description": "Retrieves multiple YouTube video resource parts in a single batch call. Use when you need cohort-level metrics for many videos to reduce quota usage and latency."
      },
      {
        "slug": "YOUTUBE_GET_VIDEO_RATING",
        "name": "Get Video Rating",
        "description": "Retrieves the ratings that the authorized user gave to a list of specified videos. Use when you need to check if a user has liked or disliked specific videos."
      },
      {
        "slug": "YOUTUBE_LIST_CAPTION_TRACK",
        "name": "List captions",
        "description": "Retrieves a list of caption tracks for a YouTube video. Returns an empty items list if no captions are available. Raises ExecutionFailed if the video ID is invalid or not found."
      },
      {
        "slug": "YOUTUBE_LIST_CHANNELS",
        "name": "List Channels",
        "description": "Lists YouTube channels by ID, handle, username, or ownership status, returning detailed channel information including metadata, statistics, and content details. Use this action when you need to retrieve comprehensive channel information by channel ID, handle (e.g., @username), or to list channels owned by or managed by the authenticated user. For finding channels by search query, use the search action instead."
      },
      {
        "slug": "YOUTUBE_LIST_CHANNEL_SECTIONS",
        "name": "List Channel Sections",
        "description": "Tool to retrieve channel sections from YouTube. Use when you need to get the layout sections of a channel's homepage. Channel sections organize content into categories like playlists, uploads, or featured channels."
      },
      {
        "slug": "YOUTUBE_LIST_CHANNEL_VIDEOS",
        "name": "List channel videos",
        "description": "Lists videos from a specified YouTube channel. This action primarily uses the playlistItems.list endpoint with the channel's uploads playlist, which is the recommended approach by YouTube. The uploads playlist ID is obtained by fetching the channel resource via the Channels API and extracting the playlist ID from contentDetails.relatedPlaylists.uploads field. If the uploads playlist returns a 404 error (which can happen due to a known YouTube API bug where the returned playlist ID doesn't actually exist), the action automatically falls back to the search.list endpoint to retrieve channel videos. Note that the search fallback has higher quota cost (100 units vs 1 unit) and is limited to 500 results. If a channel exists but has no uploads playlist (e.g., brand accounts, channels with all videos deleted, or channels that haven't uploaded any public content), an empty result set is returned instead of an error."
      },
      {
        "slug": "YOUTUBE_LIST_COMMENTS",
        "name": "List Comments",
        "description": "List individual comments from YouTube videos. Returns comment details including author, text, timestamps, and engagement metrics. Use 'id' parameter to retrieve specific comments or 'parentId' to retrieve all replies to a top-level comment."
      },
      {
        "slug": "YOUTUBE_LIST_COMMENT_THREADS",
        "name": "List Comment Threads (Deprecated)",
        "description": "DEPRECATED: Use YOUTUBE_LIST_COMMENT_THREADS2 instead. List comment threads from YouTube videos or channels for qualitative analysis and reporting. Returns top-level comments with optional replies (up to 5 per thread). Use the 'videoId' parameter to retrieve comments on a specific video (most common use case)."
      },
      {
        "slug": "YOUTUBE_LIST_COMMENT_THREADS2",
        "name": "List Comment Threads",
        "description": "Tool to retrieve comment threads from YouTube videos or channels matching API request parameters. Use when you need to fetch comments with filtering by video, channel, or specific thread IDs."
      },
      {
        "slug": "YOUTUBE_LIST_I18N_LANGUAGES",
        "name": "List I18n Languages",
        "description": "Returns a list of application languages that the YouTube website supports. Use this when you need to retrieve all available language options for YouTube's interface or to localize content."
      },
      {
        "slug": "YOUTUBE_LIST_I18N_REGIONS",
        "name": "List I18n Regions",
        "description": "Tool to retrieve a list of content regions that the YouTube website supports. Returns region codes (ISO 3166-1 alpha-2) and localized region names. Use when you need to identify available geographic regions for content filtering or display."
      },
      {
        "slug": "YOUTUBE_LIST_LIVE_CHAT_MESSAGES",
        "name": "List Live Chat Messages",
        "description": "Tool to list live chat messages for a specific chat. Use for monitoring live chat during broadcasts or retrieving chat history. Returns messages with author details, timestamps, and message types (text, Super Chat, moderation events)."
      },
      {
        "slug": "YOUTUBE_LIST_MOST_POPULAR_VIDEOS",
        "name": "List Most Popular Videos",
        "description": "DEPRECATED: Use YOUTUBE_UPDATE_VIDEO instead. Tool to list the current most-popular (charts/trending) YouTube videos for a region and/or category via videos.list(chart=mostPopular). Use when you need to retrieve YouTube's official trending or most popular videos, not keyword-search approximations."
      },
      {
        "slug": "YOUTUBE_LIST_PLAYLIST_IMAGES",
        "name": "List Playlist Images",
        "description": "Tool to retrieve playlist images associated with a specific playlist. Use when fetching custom thumbnail images for playlists."
      },
      {
        "slug": "YOUTUBE_LIST_PLAYLIST_ITEMS",
        "name": "List Playlist Items",
        "description": "Tool to list videos in a playlist, with pagination support. Use when walking through a channel's uploads playlist to enumerate all videos."
      },
      {
        "slug": "YOUTUBE_LIST_SUPER_CHAT_EVENTS",
        "name": "List Super Chat Events",
        "description": "Lists Super Chat events for a channel, showing supporter purchases during live streams. Returns Super Chat and Super Sticker events from the past 30 days. Use to track and acknowledge supporter contributions."
      },
      {
        "slug": "YOUTUBE_LIST_USER_PLAYLISTS",
        "name": "List user playlists",
        "description": "Retrieves playlists owned by the authenticated user, implicitly using mine=True."
      },
      {
        "slug": "YOUTUBE_LIST_USER_SUBSCRIPTIONS",
        "name": "List user subscriptions",
        "description": "Retrieves the authenticated user's YouTube channel subscriptions, allowing specification of response parts and pagination."
      },
      {
        "slug": "YOUTUBE_LIST_VIDEO_ABUSE_REPORT_REASONS",
        "name": "List Video Abuse Report Reasons",
        "description": "Tool to retrieve a list of abuse report reasons that can be used to report abusive videos on YouTube. Use when you need to display available reporting categories or before calling videos.reportAbuse. Returns localized reason labels and optional secondary categorizations."
      },
      {
        "slug": "YOUTUBE_LIST_VIDEO_CATEGORIES",
        "name": "List Video Categories",
        "description": "Tool to list YouTube video categories that can be associated with videos. Use when you need to retrieve available video categories for a specific region or get details about specific category IDs."
      },
      {
        "slug": "YOUTUBE_LOAD_CAPTIONS",
        "name": "Download YouTube caption track",
        "description": "Downloads a specific YouTube caption track, which must be owned by the authenticated user, and returns its content as text. Note: This action requires you to own the video (YouTube Data API v3 restriction). Non-owned videos will return 403 Forbidden errors, including many auto-generated caption tracks."
      },
      {
        "slug": "YOUTUBE_MARK_COMMENT_AS_SPAM",
        "name": "Mark Comment as Spam",
        "description": "Tool to mark one or more YouTube comments as spam. Use when moderating comments to flag spam content. Note: This endpoint is deprecated but still functional according to YouTube API documentation."
      },
      {
        "slug": "YOUTUBE_MULTIPART_UPLOAD_VIDEO",
        "name": "Multipart upload video",
        "description": "Uploads a video to YouTube using multipart upload in a single request. Use when you want to upload both metadata and video file together. This action uploads the video file and metadata in one request, unlike resumable upload which requires two steps."
      },
      {
        "slug": "YOUTUBE_POST_COMMENT",
        "name": "Post Comment on Video",
        "description": "Tool to post a new top-level comment on a YouTube video. Use when creating comments to engage with video content or respond to user requests."
      },
      {
        "slug": "YOUTUBE_RATE_VIDEO",
        "name": "Rate Video",
        "description": "Tool to add a like or dislike rating to a YouTube video, or remove an existing rating. Use when you need to rate videos on behalf of the authenticated user."
      },
      {
        "slug": "YOUTUBE_REPORT_VIDEO_ABUSE",
        "name": "Report Video for Abuse",
        "description": "Tool to report a YouTube video for containing abusive content. Use when you need to flag videos that violate YouTube's community guidelines or contain harmful content."
      },
      {
        "slug": "YOUTUBE_SEARCH_YOU_TUBE",
        "name": "Search YouTube",
        "description": "Searches YouTube for videos, channels, or playlists using a query term, returning the raw API response."
      },
      {
        "slug": "YOUTUBE_SET_COMMENT_MODERATION_STATUS",
        "name": "Set Comment Moderation Status",
        "description": "Tool to set the moderation status of one or more YouTube comments. Use when moderating comments to hold for review, publish, or reject them. Optionally ban the comment author when rejecting."
      },
      {
        "slug": "YOUTUBE_SUBSCRIBE_CHANNEL",
        "name": "Subscribe to channel",
        "description": "Subscribes the authenticated user to a specified YouTube channel, identified by its unique `channelId` which must be valid and existing."
      },
      {
        "slug": "YOUTUBE_UNSUBSCRIBE_CHANNEL",
        "name": "Unsubscribe from channel",
        "description": "Tool to unsubscribe the authenticated user from a YouTube channel by deleting a subscription. Use when you need to remove an existing subscription. The subscription ID can be obtained from the `YOUTUBE_LIST_USER_SUBSCRIPTIONS` tool."
      },
      {
        "slug": "YOUTUBE_UPDATE_CAPTION",
        "name": "Update caption track",
        "description": "Updates a YouTube caption track's metadata such as name, language, or draft status. Use this to modify existing caption track properties without uploading new caption content. Note: Only properties specified in the snippet will be updated; unspecified properties retain their current values."
      },
      {
        "slug": "YOUTUBE_UPDATE_CHANNEL",
        "name": "Update channel",
        "description": "Updates a channel's metadata including branding settings and localizations. Only brandingSettings, invideoPromotion, and localizations properties can be updated. Requires the channel to be owned by the authenticated user."
      },
      {
        "slug": "YOUTUBE_UPDATE_CHANNEL_SECTION",
        "name": "Update Channel Section",
        "description": "Tool to update an existing YouTube channel section by ID. Use when modifying section properties like title, position, or featured content."
      },
      {
        "slug": "YOUTUBE_UPDATE_COMMENT",
        "name": "Update Comment",
        "description": "Tool to modify the text of an existing YouTube comment. Use when updating or correcting a previously posted comment."
      },
      {
        "slug": "YOUTUBE_UPDATE_PLAYLIST",
        "name": "Update Playlist",
        "description": "Tool to modify an existing YouTube playlist's metadata (title, description, privacy status). Use when updating playlist information for the authenticated user's channel."
      },
      {
        "slug": "YOUTUBE_UPDATE_PLAYLIST_ITEM",
        "name": "Update Playlist Item",
        "description": "Tool to modify a playlist item's properties such as position or note. Use when reordering videos in a playlist or updating item metadata."
      },
      {
        "slug": "YOUTUBE_UPDATE_THUMBNAIL",
        "name": "Update thumbnail",
        "description": "Sets the custom thumbnail for a YouTube video using an image from a URL. Requirements: - The authenticated user must own the video or have permission to edit it - The YouTube channel must be verified (phone verification required) to upload custom thumbnails - Image must be JPG, PNG, or GIF; under 2MB; recommended 1280x720 resolution (16:9 aspect ratio)"
      },
      {
        "slug": "YOUTUBE_UPDATE_VIDEO",
        "name": "Update video",
        "description": "Updates metadata for a YouTube video identified by videoId, which must exist; an empty list for tags removes all existing tags."
      },
      {
        "slug": "YOUTUBE_UPLOAD_VIDEO",
        "name": "Upload video",
        "description": "Uploads a video file to a YouTube channel; the video file must be in a YouTube-supported format."
      }
    ],
    "triggers": [
      {
        "slug": "YOUTUBE_NEW_ACTIVITY_TRIGGER",
        "name": "New YouTube Activity",
        "description": "Triggers when a new activity is detected on a YouTube channel."
      },
      {
        "slug": "YOUTUBE_NEW_PLAYLIST_ITEM_TRIGGER",
        "name": "New Item in YouTube Playlist",
        "description": "Triggers when a new item is added to a YouTube playlist."
      },
      {
        "slug": "YOUTUBE_NEW_PLAYLIST_TRIGGER",
        "name": "New Playlist in YouTube Channel",
        "description": "Triggers when a new playlist is added to a YouTube channel."
      },
      {
        "slug": "YOUTUBE_NEW_SUBSCRIPTION_TRIGGER",
        "name": "New YouTube Channel Subscription",
        "description": "Triggers when a new channel is subscribed."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "OAUTH2",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Scopes",
                "type": "string",
                "description": "Scopes to request from the user, comma separated",
                "required": false,
                "default": "https://www.googleapis.com/auth/youtube,https://www.googleapis.com/auth/youtube.channel-memberships.creator,https://www.googleapis.com/auth/youtube.force-ssl,https://www.googleapis.com/auth/youtube.readonly,https://www.googleapis.com/auth/youtube.upload,https://www.googleapis.com/auth/youtubepartner,https://www.googleapis.com/auth/youtubepartner-channel-audit"
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": []
          }
        }
      }
    ]
  },
  {
    "slug": "slackbot",
    "name": "Slackbot",
    "logo": "https://logos.composio.dev/api/slackbot",
    "description": "Slackbot gives agents workspace-wide read access to a Slack workspace on behalf of the installing user - search messages and files, browse channel and thread history, and look up users and channels - while continuing to post and react as the bot. Includes direct messages and user email addresses so agents can search across DMs and resolve users by email.",
    "category": "team chat",
    "authSchemes": [
      "OAUTH2"
    ],
    "composioManagedAuthSchemes": [
      "OAUTH2"
    ],
    "toolCount": 101,
    "triggerCount": 9,
    "version": "20260826_00",
    "tools": [
      {
        "slug": "SLACKBOT_ADD_CALL_PARTICIPANTS",
        "name": "Add call participants",
        "description": "Registers new participants added to a Slack call."
      },
      {
        "slug": "SLACKBOT_ADD_REACTION_TO_AN_ITEM",
        "name": "Add reaction to message",
        "description": "Adds a specified emoji reaction to an existing message in a Slack channel, identified by its timestamp; does not remove or retrieve reactions."
      },
      {
        "slug": "SLACKBOT_ADD_REMOTE_FILE",
        "name": "Add a remote file",
        "description": "Adds a reference to an external file (e.g., Google Drive, Dropbox) to Slack for discovery and sharing, requiring a unique `external_id` and an `external_url` accessible by Slack."
      },
      {
        "slug": "SLACKBOT_ARCHIVE_CONVERSATION",
        "name": "Archive a Slack conversation",
        "description": "Archives a Slack conversation by its ID, rendering it read-only and hidden while retaining history, ideal for cleaning up inactive channels; be aware that some channels (like #general or certain DMs) cannot be archived and this may impact connected integrations."
      },
      {
        "slug": "SLACKBOT_CLOSE_DM",
        "name": "Close conversation channel",
        "description": "Closes a Slack direct message (DM) or multi-person direct message (MPDM) channel, removing it from the user's sidebar without deleting history; this action affects only the calling user's view."
      },
      {
        "slug": "SLACKBOT_CREATE_A_REMINDER",
        "name": "Create a reminder",
        "description": "Creates a Slack reminder with specified text and time; time accepts Unix timestamps, seconds from now, or natural language (e.g., 'in 15 minutes', 'every Thursday at 2pm')."
      },
      {
        "slug": "SLACKBOT_CREATE_CANVAS",
        "name": "Create Slack Canvas",
        "description": "Creates a new Slack Canvas with the specified title and optional content."
      },
      {
        "slug": "SLACKBOT_CREATE_CHANNEL",
        "name": "Create channel",
        "description": "Initiates a public or private channel-based conversation in a Slack workspace. Immediately creates the channel; invoke only after explicit user confirmation."
      },
      {
        "slug": "SLACKBOT_CREATE_LIST",
        "name": "Create Slack List",
        "description": "Creates a new Slack List via `slackLists.create`. Provide a `name` and, optionally, a `description_blocks` description and a `schema` of typed columns. You can instead copy an existing List's structure with `copy_from_list_id` (and its rows via `include_copied_list_records`), or enable task-tracking columns with `todo_mode`. Returns the new List's `list_id`. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACKBOT_CREATE_LIST_ITEM",
        "name": "Create Slack List item",
        "description": "Creates a new item (row) in a Slack List via `slackLists.items.create`. Set initial cell values with `initial_fields`; text columns require Block Kit `rich_text` (a plain string is wrapped automatically). Optionally duplicate an existing row with `duplicated_item_id` or create a subtask with `parent_item_id`. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACKBOT_CREATE_USER_GROUP",
        "name": "Create a Slack user group",
        "description": "Creates a new User Group (often referred to as a subteam) in a Slack workspace."
      },
      {
        "slug": "SLACKBOT_CUSTOMIZE_URL_UNFURL",
        "name": "Customize URL unfurl",
        "description": "Customizes URL previews (unfurling) in a specific Slack message using a URL-encoded JSON in `unfurls` to define custom content or remove existing previews."
      },
      {
        "slug": "SLACKBOT_DELETE_CANVAS",
        "name": "Delete Slack Canvas",
        "description": "Deletes a Slack Canvas permanently and irreversibly. Always confirm with the user before calling this tool."
      },
      {
        "slug": "SLACKBOT_DELETE_FILE",
        "name": "Delete a file by ID",
        "description": "Permanently deletes an existing file from a Slack workspace using its unique file ID; this action is irreversible and also removes any associated comments or shares."
      },
      {
        "slug": "SLACKBOT_DELETE_FILE_COMMENT",
        "name": "Delete file comment",
        "description": "Deletes a specific comment from a file in Slack; this action is irreversible."
      },
      {
        "slug": "SLACKBOT_DELETE_LIST_ACCESS",
        "name": "Delete Slack List access",
        "description": "Revokes sharing access on a Slack List via `slackLists.access.delete`. Provide the `list_id` and EXACTLY ONE of `channel_ids` or `user_ids` (they are mutually exclusive) to remove access for those channels or users. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACKBOT_DELETE_LIST_ITEM",
        "name": "Delete Slack List item",
        "description": "Deletes an item (row) from a Slack List via `slackLists.items.delete`. Identify the List with `list_id` and the row to remove with `id`. Deletion is permanent and cannot be undone. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACKBOT_DELETE_MULTIPLE_LIST_ITEMS",
        "name": "Delete multiple Slack List items",
        "description": "Deletes several items (rows) from a Slack List in one call via `slackLists.items.deleteMultiple`. This operation is ALL-OR-NOTHING: Slack returns a single `{\"ok\": true}` on success or `{\"ok\": false, \"error\": ...}` on failure, with NO per-item result array, so partial state cannot be reported. On failure, treat the whole batch as not deleted and retry the entire batch. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACKBOT_DELETE_REMINDER",
        "name": "Delete a Slack reminder",
        "description": "Deletes an existing Slack reminder, typically when it is no longer relevant or a task is completed; this operation is irreversible."
      },
      {
        "slug": "SLACKBOT_DELETES_A_MESSAGE_FROM_A_CHAT",
        "name": "Delete a message from a chat",
        "description": "Deletes a message, identified by its channel ID and timestamp, from a Slack channel, private group, or direct message conversation; the authenticated user or bot must be the original poster."
      },
      {
        "slug": "SLACKBOT_DELETE_SCHEDULED_MESSAGE",
        "name": "Delete scheduled chat message",
        "description": "Deletes a pending, unsent scheduled message from the specified Slack channel, identified by its `scheduled_message_id`."
      },
      {
        "slug": "SLACKBOT_DISABLE_USER_GROUP",
        "name": "Disable a Slack user group",
        "description": "Disables a specified, currently enabled Slack User Group by its unique ID, effectively archiving it by setting its 'date_delete' timestamp; the group is not permanently deleted and can be re-enabled."
      },
      {
        "slug": "SLACKBOT_DOWNLOAD_FILE",
        "name": "Download Slack file",
        "description": "Tool to download Slack file content and convert it to a publicly accessible URL. Use when you need to retrieve and download files that have been shared in Slack channels or conversations."
      },
      {
        "slug": "SLACKBOT_EDIT_CANVAS",
        "name": "Edit Slack Canvas",
        "description": "Edits a Slack Canvas with granular control over content placement. Supports replace, insert (before/after/start/end) operations for flexible content management."
      },
      {
        "slug": "SLACKBOT_ENABLE_PUBLIC_SHARING_OF_A_FILE",
        "name": "Share file public url",
        "description": "Enables public sharing for an existing Slack file by generating a publicly accessible URL; this action does not create new files. Once enabled, the file is accessible to anyone with the URL — verify intent before sharing sensitive or confidential files."
      },
      {
        "slug": "SLACKBOT_ENABLE_USER_GROUP",
        "name": "Enable a user group",
        "description": "Enables a disabled User Group in Slack using its ID, reactivating it for mentions and permissions; this action only changes the enabled status and cannot create new groups or modify other properties."
      },
      {
        "slug": "SLACKBOT_END_CALL",
        "name": "End a call",
        "description": "Ends an ongoing Slack call, identified by its ID (obtained from `calls.add`), optionally specifying the call's duration."
      },
      {
        "slug": "SLACKBOT_FETCH_CONVERSATION_HISTORY",
        "name": "Fetch conversation history",
        "description": "Fetches a chronological list of messages and events from a specified Slack conversation, accessible by the authenticated user/bot, with options for pagination and time range filtering. IMPORTANT LIMITATION: This action only returns messages from the main channel timeline. Threaded replies are NOT returned by this endpoint. To retrieve threaded replies, use the SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION action (conversations.replies API) instead. The oldest/latest timestamp filters work reliably for filtering the main channel timeline, but cannot be used to retrieve individual threaded replies - even if you know the exact reply timestamp, setting oldest=latest to that timestamp will return an empty messages array. To get threaded replies: 1. Use this action to get parent messages (which include thread_ts, reply_count, latest_reply fields) 2. Use SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION with the parent's thread_ts to fetch all replies in that thread"
      },
      {
        "slug": "SLACKBOT_FETCH_ITEM_REACTIONS",
        "name": "Fetch item reactions",
        "description": "Fetches reactions for a Slack message, file, or file comment. Exactly one identifier path must be provided: `channel`+`timestamp`, `file`, or `file_comment`. Mixing identifiers (e.g., providing both `channel`+`timestamp` and `file`) causes errors. If the response omits the `reactions` field, the item has zero reactions."
      },
      {
        "slug": "SLACKBOT_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION",
        "name": "Retrieve conversation replies",
        "description": "Retrieves replies to a specific parent message in a Slack conversation, using the channel ID and the parent message's timestamp (`ts`). Note: The parent message in the response contains metadata (reply_count, reply_users, latest_reply) that indicates expected thread activity. If the returned messages array contains fewer replies than reply_count indicates, check: (1) has_more=true means pagination is needed, (2) recently posted replies may have timing delays, (3) some replies may be filtered by permissions or deleted. The composio_execution_message field will warn about any detected mismatches."
      },
      {
        "slug": "SLACKBOT_FETCH_TEAM_INFO",
        "name": "Fetch team info",
        "description": "Fetches comprehensive metadata about the current Slack team, or a specified team if the provided ID is accessible."
      },
      {
        "slug": "SLACKBOT_FIND_CHANNELS",
        "name": "Find channels",
        "description": "Find channels in a Slack workspace by any criteria - name, topic, purpose, or description. Returns channel IDs (C*/G* prefixed) required by most Slack tools — always resolve names to IDs here before passing to other tools. NOTE: This action searches channels and conversations visible to the authenticated user. Empty results may indicate: - No channels match the search query in name, topic, or purpose - The target private channel or DM is not accessible to the authenticated user because they are not a member - The connection lacks required read scopes (channels:read, groups:read, im:read, mpim:read). If empty, retry with exact_match=false or exclude_archived=false to avoid false negatives. In large workspaces, paginate using next_cursor to avoid missing matches. Check 'composio_execution_message' and 'total_channels_searched' in the response for details."
      },
      {
        "slug": "SLACKBOT_FIND_USER_BY_EMAIL_ADDRESS",
        "name": "Lookup users by email",
        "description": "Retrieves the Slack user object for an active user by their registered email address; requires the users:read.email OAuth scope. Fails with 'users_not_found' if the email is unregistered, the user is inactive, the account is a guest, or the email is hidden by workspace privacy settings."
      },
      {
        "slug": "SLACKBOT_FIND_USERS",
        "name": "Find users",
        "description": "Find users in a Slack workspace by any criteria - email, name, display name, or other text. Includes optimized email lookup for exact email matches. Zero results may reflect email visibility restrictions or workspace policies, not global absence. Repeated calls may trigger HTTP 429; honor the Retry-After header."
      },
      {
        "slug": "SLACKBOT_GET_BOT_USER",
        "name": "Fetch bot user information",
        "description": "Fetches information for a specified, existing Slack bot user; will not work for regular user accounts or other integration types."
      },
      {
        "slug": "SLACKBOT_GET_CALL_INFO",
        "name": "Retrieve call information",
        "description": "Retrieves a point-in-time snapshot of a specific Slack call's information."
      },
      {
        "slug": "SLACKBOT_GET_CANVAS",
        "name": "Get Slack Canvas (Deprecated)",
        "description": "DEPRECATED: Use SLACK_RETRIEVE_DETAILED_INFORMATION_ABOUT_A_FILE instead. Retrieves a specific Slack Canvas by its ID, including its content and metadata."
      },
      {
        "slug": "SLACKBOT_GET_LIST_ITEM",
        "name": "Get Slack List item",
        "description": "Fetches a single item (row) from a Slack List via `slackLists.items.info`. Returns the row's `column_id`-keyed typed values along with metadata about the parent List. Set `include_is_subscribed` to also report whether the calling user is subscribed to the row. Requires a user token with the `lists:read` scope."
      },
      {
        "slug": "SLACKBOT_GET_REMINDER",
        "name": "Get reminder information",
        "description": "Retrieves detailed information for an existing Slack reminder specified by its ID; this is a read-only operation."
      },
      {
        "slug": "SLACKBOT_GET_REMOTE_FILE",
        "name": "Get remote file",
        "description": "Retrieve information about a remote file added to Slack via the files.remote API. Does not work for standard Slack-hosted file uploads."
      },
      {
        "slug": "SLACKBOT_GET_TEAM_PROFILE",
        "name": "Retrieve team profile details",
        "description": "Retrieves all profile field definitions for a Slack team, optionally filtered by visibility, to understand the team's profile structure."
      },
      {
        "slug": "SLACKBOT_GET_UNREAD_MESSAGES_FROM_USER",
        "name": "Get unread messages from user",
        "description": "Retrieves unread direct messages from a specific user by opening their DM conversation, checking for unread messages, and fetching message history since the last read timestamp. Use this action when you need to check if a specific user has sent unread direct messages to the authenticated user, or when monitoring incoming DMs from particular users. Returns an empty messages array if there are no unread messages from the specified user. Note: This action only works for direct messages (DMs), not channel messages or group conversations."
      },
      {
        "slug": "SLACKBOT_GET_USER_DND_STATUS",
        "name": "Get team DND status",
        "description": "Retrieves a user's current Do Not Disturb status."
      },
      {
        "slug": "SLACKBOT_GET_USER_PRESENCE",
        "name": "Retrieve user presence",
        "description": "Retrieves a Slack user's current real-time presence (e.g., 'active', 'away') to determine their availability, noting this action does not provide historical data or status reasons."
      },
      {
        "slug": "SLACKBOT_INVITE_USERS_TO_A_CHANNEL",
        "name": "Invite users to a Slack channel",
        "description": "Invites users to an existing Slack channel using their valid Slack User IDs. Response is always HTTP 200; inspect `ok`, `error`, and `errors` fields to confirm users were added."
      },
      {
        "slug": "SLACKBOT_JOIN_AN_EXISTING_CONVERSATION",
        "name": "Join conversation by channel id",
        "description": "Joins an existing Slack conversation (public channel, private channel, or multi-person direct message) by its ID, if the authenticated user has permission. Joining an already-joined channel returns a non-fatal no-op response. Private or restricted channel joins may fail with a permission error."
      },
      {
        "slug": "SLACKBOT_LEAVE_CONVERSATION",
        "name": "Leave conversation channel",
        "description": "Leaves a Slack conversation given its channel ID; fails if leaving as the last member of a private channel or if used on a Slack Connect channel."
      },
      {
        "slug": "SLACKBOT_LIST_ALL_CHANNELS",
        "name": "List all channels",
        "description": "Lists conversations available to the user with various filters and search options. Always use resolved `channel_id` (not display names) for downstream operations, as names may be non-unique. The `created` field in results is a Unix epoch timestamp (UTC). Pagination across large workspaces may return HTTP 429 with a `Retry-After` header; honor the delay and resume from the last successful cursor."
      },
      {
        "slug": "SLACKBOT_LIST_ALL_USERS",
        "name": "List all users",
        "description": "Retrieves a paginated list of all users with profile details, status, and team memberships in a Slack workspace; data may not be real-time. Filter response fields `is_bot`, `is_app_user`, and `deleted` to build human-only rosters. Profile fields like `email` and `phone` may be absent depending on OAuth scopes and workspace privacy settings. Guest/restricted accounts may be omitted based on scopes—do not treat results as a complete directory. High-frequency calls risk HTTP 429; honor the `Retry-After` header and throttle to ~1–2 requests/second. Use stable user IDs rather than display names for mapping. Prefer SLACK_FIND_USERS for targeted lookups; cache results to avoid full-workspace fetches."
      },
      {
        "slug": "SLACKBOT_LIST_AVAILABLE_WORKSPACES",
        "name": "List available workspaces",
        "description": "List Slack workspaces where both the connection and target user have access. Returns each workspace's team_id and name. Use this when: (1) the user references a workspace by name, (2) a user-specific tool requires team_id and you don't have one, or (3) a user-specific call fails with a team/workspace access error. Match the user's workspace name to a team_id from the results and pass that team_id to subsequent tools. If the name matches zero or multiple workspaces, ask the user to clarify. Only meaningful for org-level installs; single-workspace connections return the workspace only if the specified user's membership is visible to this token."
      },
      {
        "slug": "SLACKBOT_LIST_CANVASES",
        "name": "List Slack Canvases (Deprecated)",
        "description": "DEPRECATED: Use SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK instead (pass types=\"canvas\" for equivalent behavior). Lists Slack Canvases with filtering by channel, user, timestamp, and page-based pagination. Uses Slack's files.list API with types=canvas filter. Only canvases accessible to the authenticated app are returned; missing canvases indicate permissions restrictions, not empty data. Use `paging.pages` in the response to determine total pages; iterate `page` with `count` to retrieve all results. Known limitations: - The 'user' filter may return canvases accessible to the specified user, not just canvases they created. - The 'ts_from' and 'ts_to' timestamp filters may not work reliably for canvas types. Consider client-side filtering on the 'created' field in the response if precise date filtering is required."
      },
      {
        "slug": "SLACKBOT_LIST_CONVERSATIONS",
        "name": "List conversations",
        "description": "List conversations (channels/DMs) accessible to a specified user (or the authenticated user if no user ID is provided), respecting shared membership for non-public channels. Returns conversation IDs (C* for channels, G* for group DMs), not display names. Absence of private channels, DMs, or MPIMs from results indicates token scope or membership limits, not that the conversation is nonexistent."
      },
      {
        "slug": "SLACKBOT_LIST_CUSTOM_EMOJIS",
        "name": "List team custom emojis",
        "description": "Retrieves all custom emojis for the Slack workspace (image URLs or aliases), not standard Unicode emojis; does not include usage statistics or creation dates."
      },
      {
        "slug": "SLACKBOT_LIST_FILES_WITH_FILTERS_IN_SLACK",
        "name": "List Slack files",
        "description": "Lists files and their metadata within a Slack workspace, filterable by user, channel, timestamp, or type; returns metadata only, not file content. Results are limited to files visible to the authenticated user — files in private channels or restricted to certain members require appropriate membership and permissions. For large workspaces, check `paging.pages` in the response to determine total pages when paginating."
      },
      {
        "slug": "SLACKBOT_LIST_LIST_ITEMS",
        "name": "List Slack List items",
        "description": "Lists the rows (items) in a Slack List via `slackLists.items.list`. Each row exposes `column_id`-keyed typed values (e.g. `rich_text`, `select`, `user`, `date`, `number`); the legacy `key`/`value` fields are deprecated. Results are cursor-paginated—you must paginate using `response_metadata.next_cursor` until it is empty, or rows are silently truncated to the first page. Set `archived=true` to return archived rows instead of active ones. Requires a user token with the `lists:read` scope."
      },
      {
        "slug": "SLACKBOT_LIST_PINNED_ITEMS",
        "name": "List pinned items in a channel",
        "description": "Retrieves all messages and files pinned to a specified channel; the caller must have access to this channel."
      },
      {
        "slug": "SLACKBOT_LIST_REMINDERS",
        "name": "List reminders",
        "description": "Lists all reminders with their details for the authenticated Slack user; returns an empty array if no reminders exist (valid state, not an error). Reminder text is not unique—perform client-side matching on returned objects before extracting a reminder ID for use with SLACK_DELETE_A_SLACK_REMINDER."
      },
      {
        "slug": "SLACKBOT_LIST_REMOTE_FILES",
        "name": "List remote files",
        "description": "Retrieve information about a team's remote files."
      },
      {
        "slug": "SLACKBOT_LIST_UNREAD_CHANNEL_MESSAGES",
        "name": "List unread channel messages",
        "description": "Lists all unread messages in a specified Slack channel for the authenticated user. This action fetches messages that have been posted since the user's last read position in the channel. Use this action when you need to retrieve messages the user hasn't seen yet. The action determines the user's read position and returns all messages posted after that timestamp. Note: This only returns messages from the main channel timeline, not threaded replies. For threaded replies, use SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION."
      },
      {
        "slug": "SLACKBOT_LIST_USER_GROUP_MEMBERS",
        "name": "List all users in a user group",
        "description": "Retrieves a list of all user IDs within a specified Slack user group, with an option to include users from disabled groups."
      },
      {
        "slug": "SLACKBOT_LIST_USER_GROUPS",
        "name": "List user groups",
        "description": "Lists user groups in a Slack workspace, including user-created and default groups; results for large workspaces may be paginated."
      },
      {
        "slug": "SLACKBOT_LIST_USER_REACTIONS",
        "name": "List user reactions",
        "description": "Lists all reactions added by a specific user to messages, files, or file comments in Slack, useful for engagement analysis when the item content itself is not required. Results are paginated; check `response_metadata.next_cursor` and iterate with the `cursor` parameter to retrieve complete reaction history."
      },
      {
        "slug": "SLACKBOT_LOOKUP_CANVAS_SECTIONS",
        "name": "Lookup Canvas Sections",
        "description": "Looks up section IDs in a Slack Canvas for use with targeted edit operations. Section IDs are needed for insert_after, insert_before, delete, and section-specific replace operations."
      },
      {
        "slug": "SLACKBOT_OPEN_DM",
        "name": "Open DM",
        "description": "Opens or resumes a Slack direct message (DM) or multi-person direct message (MPIM) by providing either user IDs or an existing channel ID. Returns `already_open=true` when the DM exists — treat as success and reuse the returned `channel.id` (starts with 'D') for subsequent SLACK_SEND_MESSAGE calls; passing a username, email, or user ID directly to SLACK_SEND_MESSAGE causes `channel_not_found`. Avoid redundant calls when an existing DM channel ID is available."
      },
      {
        "slug": "SLACKBOT_PIN_ITEM",
        "name": "Pin an item to a channel",
        "description": "Pins a message to a specified Slack channel; the message must not already be pinned."
      },
      {
        "slug": "SLACKBOT_REMOVE_CALL_PARTICIPANTS",
        "name": "Remove call participants",
        "description": "Registers participants removed from a Slack call."
      },
      {
        "slug": "SLACKBOT_REMOVE_REACTION_FROM_ITEM",
        "name": "Remove reaction from item",
        "description": "Removes an emoji reaction from a message, file, or file comment in Slack. Provide exactly one targeting method: channel+timestamp together, file, or file_comment. Mixing methods or omitting all returns invalid_arguments."
      },
      {
        "slug": "SLACKBOT_REMOVE_REMOTE_FILE",
        "name": "Remove remote file",
        "description": "Removes the Slack reference to an external file (which must have been previously added via the remote files API), specified by either its `external_id` or `file` ID (one of which is required), without deleting the actual external file."
      },
      {
        "slug": "SLACKBOT_REMOVE_USER_FROM_CONVERSATION",
        "name": "Remove user from conversation",
        "description": "Removes a specified user from a Slack conversation (channel); the caller must have permissions to remove users and cannot remove themselves using this action."
      },
      {
        "slug": "SLACKBOT_RENAME_CONVERSATION",
        "name": "Rename a conversation",
        "description": "Renames a Slack channel, automatically adjusting the new name to meet naming conventions (e.g., converting to lowercase), which may affect integrations using the old name."
      },
      {
        "slug": "SLACKBOT_RETRIEVE_CONVERSATION_INFORMATION",
        "name": "Retrieve conversation information",
        "description": "Retrieves metadata for a Slack conversation by ID (e.g., name, purpose, creation date, with options for member count/locale), excluding message content. The `channel` parameter is effectively required. Private channels, DMs, or channels where the app lacks membership may return restricted data; check `is_archived` and `is_member` fields in the response to diagnose access issues. Bulk lookups may trigger HTTP 429 rate limiting; honor the `Retry-After` response header."
      },
      {
        "slug": "SLACKBOT_RETRIEVE_CONVERSATION_MEMBERS_LIST",
        "name": "Get conversation members",
        "description": "Retrieves a paginated list of active member IDs (not names, emails, or presence) for a specified Slack public channel, private channel, DM, or MPIM. Returns only user IDs; use a user-lookup tool to enrich member data."
      },
      {
        "slug": "SLACKBOT_RETRIEVE_CURRENT_USER_DND_STATUS",
        "name": "Retrieve user DND status",
        "description": "Retrieves a Slack user's current Do Not Disturb (DND) status to determine their availability before interaction; any specified user ID must be a valid Slack user ID."
      },
      {
        "slug": "SLACKBOT_RETRIEVE_DETAILED_INFORMATION_ABOUT_A_FILE",
        "name": "Retrieve detailed file information",
        "description": "Retrieves detailed metadata and paginated comments for a specific Slack file ID; does not download file content."
      },
      {
        "slug": "SLACKBOT_RETRIEVE_DETAILED_USER_INFORMATION",
        "name": "Retrieve detailed user information",
        "description": "Retrieves comprehensive information for a valid Slack user ID, excluding message history and channel memberships. Sensitive fields like `email` and `phone` require the `users:read.email` scope and may be silently omitted based on workspace privacy policies."
      },
      {
        "slug": "SLACKBOT_RETRIEVE_USER_PROFILE_INFORMATION",
        "name": "Retrieve user profile information",
        "description": "Retrieves profile information for a specified Slack user (defaults to the authenticated user if `user` ID is omitted); a provided `user` ID must be valid. Sensitive fields like email and phone may be silently omitted if required scopes (e.g., `users:read.email`) are not granted or workspace privacy policies restrict access."
      },
      {
        "slug": "SLACKBOT_REVOKE_FILE_PUBLIC_SHARING",
        "name": "Revoke a file's public url",
        "description": "Revokes a Slack file's public URL, making it private; this is a no-op if not already public and is irreversible."
      },
      {
        "slug": "SLACKBOT_SCHEDULE_MESSAGE",
        "name": "Schedule message",
        "description": "Schedules a message to a Slack channel, DM, or private group for a future time (`post_at`), requiring `text`, `blocks`, or `attachments` for content; scheduling is limited to 120 days in advance."
      },
      {
        "slug": "SLACKBOT_SEARCH_ALL",
        "name": "Search all content",
        "description": "Tool to search all messages and files. Use when you need unified content search across channels and files in one call. Results are scoped to content visible to the authenticated token; missing hits in private or restricted channels reflect permission/membership gaps. Response separates messages and files into distinct sections — explicitly read the files section for document results. Results are index-based and may lag several minutes behind real-time; use SLACK_FETCH_CONVERSATION_HISTORY for near-real-time per-channel coverage. Paginated searches exceeding ~1 req/sec may return HTTP 429 too_many_requests; honor the Retry-After header and resume from the last page."
      },
      {
        "slug": "SLACKBOT_SEARCH_MESSAGES",
        "name": "Search messages",
        "description": "Workspace‑wide Slack message search with date ranges and filters. Use `query` modifiers (e.g., in:#channel, from:@user, before/after:YYYY-MM-DD), sorting (score/timestamp), and pagination."
      },
      {
        "slug": "SLACKBOT_SEND_EPHEMERAL_MESSAGE",
        "name": "Send ephemeral message",
        "description": "Sends an ephemeral message visible only to the specified `user` in a channel; other channel members cannot see it. Both the bot and the target user must be members of the specified channel."
      },
      {
        "slug": "SLACKBOT_SEND_ME_MESSAGE",
        "name": "Share a me message in a channel",
        "description": "Sends a 'me message' (e.g., '/me is typing') to a Slack channel, where it's displayed as a third-person user action; messages are plain text and the channel must exist and be accessible."
      },
      {
        "slug": "SLACKBOT_SEND_MESSAGE",
        "name": "Send message",
        "description": "Posts a message to a Slack channel, DM, or private group. Provide exactly one visible content mode: `markdown_text` for normal Markdown content, or `blocks` for raw Slack Block Kit layouts. Use `fallback_text` only with `blocks`; it maps to Slack's top-level `text` fallback. Fails with `not_in_channel`, `channel_not_found`, or `channel_is_archived` if the bot lacks access. Rate-limited at ~1 req/sec (HTTP 429, honor `Retry-After`). Not idempotent — duplicate calls post duplicate messages."
      },
      {
        "slug": "SLACKBOT_SET_CONVERSATION_PURPOSE",
        "name": "Set a conversation's purpose",
        "description": "Sets the purpose (a short description of its topic/goal, displayed in the header) for a Slack conversation; the calling user must be a member."
      },
      {
        "slug": "SLACKBOT_SET_LIST_ACCESS",
        "name": "Set Slack List access",
        "description": "Grants or sets sharing access on a Slack List via `slackLists.access.set`. Grant `read`, `write`, or `owner` access to either channels (`channel_ids`) or users (`user_ids`) — exactly one of the two is required. The `owner` level is user-only and subject to additional server-side rules. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACKBOT_SET_READ_CURSOR_IN_A_CONVERSATION",
        "name": "Set conversation read cursor",
        "description": "Marks a message, specified by its timestamp (`ts`), as the most recently read for the authenticated user in the given `channel`, provided the user is a member of the channel and the message exists within it."
      },
      {
        "slug": "SLACKBOT_SET_THE_TOPIC_OF_A_CONVERSATION",
        "name": "Set conversation topic",
        "description": "Sets or updates the topic for a specified Slack conversation."
      },
      {
        "slug": "SLACKBOT_SET_USER_ACTIVE",
        "name": "Mark user as active",
        "description": "Tool to mark a user as active in Slack. Note: This endpoint is deprecated and non-functional - it exists for backwards compatibility but does not perform any action."
      },
      {
        "slug": "SLACKBOT_SET_USER_PRESENCE",
        "name": "Set user presence",
        "description": "Manually sets a user's Slack presence, overriding automatic detection; this setting persists across connections but can be overridden by user actions or Slack's auto-away (e.g., after 10 mins of inactivity)."
      },
      {
        "slug": "SLACKBOT_SHARE_REMOTE_FILE",
        "name": "Share a remote file in channels",
        "description": "Shares a remote file, which must already be registered with Slack, into specified Slack channels or direct message conversations."
      },
      {
        "slug": "SLACKBOT_START_CALL",
        "name": "Start call",
        "description": "Registers a new call in Slack using `calls.add` for third-party call integration; `created_by` is required if not using a user-specific token."
      },
      {
        "slug": "SLACKBOT_UNARCHIVE_CHANNEL",
        "name": "Unarchive channel",
        "description": "Reverses conversation archival."
      },
      {
        "slug": "SLACKBOT_UNPIN_ITEM",
        "name": "Unpin message from channel",
        "description": "Unpins a message, identified by its timestamp, from a specified channel if the message is currently pinned there; this operation is destructive."
      },
      {
        "slug": "SLACKBOT_UPDATE_CALL_INFO",
        "name": "Update call information",
        "description": "Updates the title, join URL, or desktop app join URL for an existing Slack call identified by its ID."
      },
      {
        "slug": "SLACKBOT_UPDATE_LIST",
        "name": "Update Slack List",
        "description": "Updates a Slack List's metadata via `slackLists.update`. Only the List's `name`, `description_blocks`, and `todo_mode` are editable here. The List to update is identified by its `id` (not `list_id`). Descriptions are rich text — a plain string is wrapped into a `rich_text` block automatically. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACKBOT_UPDATE_LIST_ITEM",
        "name": "Update Slack List item",
        "description": "Updates one or more cells in an EXISTING Slack List row via `slackLists.items.update`. Each cell is identified by `row_id` (an existing row ID matching `^Rec[A-Z0-9]{8,}$`) and `column_id` and carries a typed value; text columns require Block Kit `rich_text` (a plain string is wrapped automatically), and `select` takes the column's choice values (e.g. `[\"todo\"]`). Use it to UPDATE existing rows; the live API rejects `row_id_to_create` inside a cell (despite Slack's inline example), so to ADD a row use `create_slack_list_item`. Requires a user token with the `lists:write` scope."
      },
      {
        "slug": "SLACKBOT_UPDATE_REMOTE_FILE",
        "name": "Update an existing remote file",
        "description": "Updates metadata or content details for an existing remote file in Slack; this action cannot upload new files or change the fundamental file type."
      },
      {
        "slug": "SLACKBOT_UPDATES_A_MESSAGE",
        "name": "Update a Slack message",
        "description": "Updates a Slack message by timestamp. Provide exactly one visible content mode: `markdown_text` for normal Markdown content, or `blocks` for raw Slack Block Kit layouts. Use `fallback_text` only with `blocks`; it maps to Slack's top-level `text` fallback."
      },
      {
        "slug": "SLACKBOT_UPDATE_USER_GROUP",
        "name": "Update Slack user group",
        "description": "Updates an existing Slack User Group, which must be specified by an existing `usergroup` ID, with new optional details such as its name, description, handle, or default channels."
      },
      {
        "slug": "SLACKBOT_UPDATE_USER_GROUP_MEMBERS",
        "name": "Update user group members",
        "description": "Replaces all members of an existing Slack User Group with a new list of valid user IDs."
      },
      {
        "slug": "SLACKBOT_UPLOAD_OR_CREATE_A_FILE_IN_SLACK",
        "name": "Upload or create a file in Slack",
        "description": "Upload files, images, screenshots, documents, or any media to Slack channels or threads. Supports all file types including images (PNG, JPG, JPEG, GIF), documents (PDF, DOCX, TXT), code files, and more. Can share files publicly in channels or as thread replies with optional comments. Large files may fail with `upload_too_large`; use SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICE for large uploads. If the API returns `ok=false` with `method_deprecated`, fall back to SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICE or SLACK_SEND_MESSAGE with a URL."
      }
    ],
    "triggers": [
      {
        "slug": "SLACKBOT_CHANNEL_CREATED",
        "name": "New Channel Created Trigger",
        "description": "Triggered when a new channel is created in Slack."
      },
      {
        "slug": "SLACKBOT_CHANNEL_MESSAGE_RECEIVED",
        "name": "Channel Message Received",
        "description": "Triggered when a message is posted in a Slack channel\n(public, private, or multi-party IM). Does NOT match direct messages."
      },
      {
        "slug": "SLACKBOT_DIRECT_MESSAGE_RECEIVED",
        "name": "Direct Message Received",
        "description": "Triggered when a new direct message (DM) is sent to a user in Slack.\nCatches all DMs across all DM channels."
      },
      {
        "slug": "SLACKBOT_MESSAGE_REACTION_ADDED",
        "name": "Message Reaction Added",
        "description": "Triggered when a reaction is added to a message in Slack.\nSupports optional filtering by channel and emoji name."
      },
      {
        "slug": "SLACKBOT_MESSAGE_REACTION_REMOVED",
        "name": "Message Reaction Removed",
        "description": "Triggered when a reaction is removed from a message in Slack.\nSupports optional filtering by channel and emoji name."
      },
      {
        "slug": "SLACKBOT_REACTION_ADDED",
        "name": "Reaction Added Trigger",
        "description": "DEPRECATED: use `SLACK_MESSAGE_REACTION_ADDED` instead.\n\nTriggered when a reaction is added to a message in Slack."
      },
      {
        "slug": "SLACKBOT_REACTION_REMOVED",
        "name": "Reaction Removed Trigger",
        "description": "DEPRECATED: use `SLACK_MESSAGE_REACTION_REMOVED` instead.\n\nTriggered when a reaction is removed from a message."
      },
      {
        "slug": "SLACKBOT_RECEIVE_BOT_MESSAGE",
        "name": "New Bot Message Received Trigger",
        "description": "DEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` with\n`is_bot_message=true` instead.\n\nTriggered when a new bot message is posted to a Slack channel."
      },
      {
        "slug": "SLACKBOT_RECEIVE_MESSAGE",
        "name": "New Message Received Trigger",
        "description": "DEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` instead.\n\nTriggered when a new message is posted to a Slack channel."
      }
    ],
    "authConfigDetails": [
      {
        "mode": "OAUTH2",
        "name": "slack_oauth",
        "fields": {
          "auth_config_creation": {
            "required": [
              {
                "name": "client_id",
                "displayName": "Client id",
                "type": "string",
                "description": "Client id of the app",
                "required": true,
                "default": null
              },
              {
                "name": "client_secret",
                "displayName": "Client secret",
                "type": "string",
                "description": "Client secret of the app",
                "required": true,
                "default": null
              }
            ],
            "optional": [
              {
                "name": "oauth_redirect_uri",
                "displayName": "Redirect URI",
                "type": "string",
                "description": "Add this Redirect URL to your app's OAuth allow list.",
                "required": false,
                "default": "https://backend.composio.dev/api/v1/auth-apps/add"
              },
              {
                "name": "scopes",
                "displayName": "Bot Scopes",
                "type": "string",
                "description": "Scopes to request from the bot",
                "required": false,
                "default": "channels:history,chat:write,team:read,channels:read,users:read,reactions:read,reactions:write"
              },
              {
                "name": "verification_token",
                "displayName": "Verification Token",
                "type": "string",
                "description": "Verification token required to verify the request is coming from slack. You can find it in the slack app settings just below the client id and secret. It is required to enable Slack triggers.",
                "required": false,
                "default": null
              }
            ]
          },
          "connected_account_initiation": {
            "required": [],
            "optional": [
              {
                "name": "generic_id",
                "displayName": "Slack Team ID",
                "type": "string",
                "description": "Optional Slack workspace ID used to scope the OAuth authorize flow to a specific team. When provided, Slack will only allow installation in this workspace. Leave unset to let users pick any workspace they have access to.",
                "required": false,
                "default": null
              }
            ]
          }
        }
      }
    ]
  },
  {
    "slug": "canvas",
    "name": "Canvas",
    "logo": "https://logos.composio.dev/api/canvas",
    "description": "Canvas is a learning management system supporting online courses, assignments, grading, and collaboration, widely used by schools and universities for virtual classrooms",
    "category": "online courses",
    "authSchemes": [
      "OAUTH2",
      "API_KEY"
    ],
    "toolCount": 574,
    "triggerCount": 6,
    "version": "20260729_00",
    "tools": [
      {
        "slug": "CANVAS_ABORT_QUIZ_REPORT_GENERATION",
        "name": "Abort Quiz Report Generation",
        "description": "Aborts the generation of a quiz report or removes a previously generated one. Use when you need to cancel a report generation request or clean up an old report."
      },
      {
        "slug": "CANVAS_ADD_CONVERSATION_MESSAGE",
        "name": "Add conversation message",
        "description": "Tool to add a message to an existing Canvas conversation. Use when sending a follow-up message to a conversation thread with specified recipients."
      },
      {
        "slug": "CANVAS_ADD_COURSE_TO_FAVORITES",
        "name": "Add course to favorites",
        "description": "Tool to add a course to the current user's favorites. Use when you need to favorite a course for the authenticated user. If the course is already in the user's favorites, nothing happens."
      },
      {
        "slug": "CANVAS_ADD_GROUP_TO_FAVORITES",
        "name": "Add group to favorites",
        "description": "Tool to add a group to the current user's favorites. Use when you need to mark a group as favorite for the authenticated user. If the group is already in the user's favorites, nothing happens."
      },
      {
        "slug": "CANVAS_ADD_LAST_ATTENDED_DATE",
        "name": "Add last attended date",
        "description": "Tool to add or update the last attended date for a student enrollment in a course. Use when tracking student attendance by recording the last date a student attended the course."
      },
      {
        "slug": "CANVAS_ADD_RECIPIENTS_TO_CONVERSATION",
        "name": "Add recipients to conversation",
        "description": "Tool to add recipients to an existing group conversation. Use when you need to add new participants to an ongoing conversation. Response includes the latest message showing who was added."
      },
      {
        "slug": "CANVAS_ADD_USERS_TO_CONTENT_SHARE",
        "name": "Add users to content share",
        "description": "Tool to send a previously created content share to additional users. Use when you need to add more recipients to an existing content share."
      },
      {
        "slug": "CANVAS_ANSWER_QUIZ_QUESTIONS",
        "name": "Answer quiz questions",
        "description": "Tool to provide or update answers to quiz questions for a quiz submission. Use when submitting answers for a quiz attempt. Requires a valid validation_token from quiz submission creation and the latest attempt number."
      },
      {
        "slug": "CANVAS_ASSIGN_UNASSIGNED_MEMBERS_TO_GROUP_CATEGORY",
        "name": "Assign unassigned members to group category",
        "description": "Tool to assign unassigned members to groups within a group category. Use when you need to distribute users who are not yet in any group within the category. Returns a Progress object for async tracking by default, or group memberships when sync=true."
      },
      {
        "slug": "CANVAS_CLEAR_COURSE_NICKNAMES",
        "name": "Clear Course Nicknames",
        "description": "Tool to remove all stored course nicknames for the current user. Use when you need to clear all custom course name preferences."
      },
      {
        "slug": "CANVAS_CLOSE_NOTIFICATION_FOR_USER",
        "name": "Close notification for user",
        "description": "Tool to excuse/close an account notification for the current user. Use when the current user no longer wants to see a specific notification. If the `remove` parameter is set to true, the notification is permanently destroyed for all users (admin action)."
      },
      {
        "slug": "CANVAS_CONCLUDE_DEACTIVATE_OR_DELETE_ENROLLMENT",
        "name": "Conclude, deactivate, or delete an enrollment",
        "description": "Tool to conclude, deactivate, or delete an enrollment in a Canvas course. Use when you need to end or remove a user's enrollment. If the task argument isn't given, the enrollment will be concluded."
      },
      {
        "slug": "CANVAS_COPY_FILE_TO_FOLDER",
        "name": "Copy File to Folder",
        "description": "Copies an existing Canvas file to a specified destination folder. Use when you need to duplicate a file to another location."
      },
      {
        "slug": "CANVAS_COPY_FOLDER",
        "name": "Copy Folder",
        "description": "Tool to copy a folder to another folder in Canvas. Use when you need to duplicate a folder structure with its contents to a destination folder."
      },
      {
        "slug": "CANVAS_CREATE_ACCOUNT_NOTIFICATION",
        "name": "Create account notification",
        "description": "Creates a global notification within a Canvas account, ensuring `end_at` is after `start_at` and any specified `notification_roles` are valid."
      },
      {
        "slug": "CANVAS_CREATE_A_CONTENT_MIGRATION4",
        "name": "Create a user content migration",
        "description": "Tool to create a content migration for a Canvas user. Use when you need to import content into a user's files from various sources (zip files, cartridges, etc.). If the migration requires a file upload, the actual processing starts once the file upload completes."
      },
      {
        "slug": "CANVAS_CREATE_APPOINTMENT_GROUP",
        "name": "Create appointment group",
        "description": "Creates a new appointment group in Canvas for schedulable time slots within specified course or group contexts."
      },
      {
        "slug": "CANVAS_CREATE_ASSIGNMENT",
        "name": "Create an assignment",
        "description": "Creates a new assignment within a specified course in Canvas LMS."
      },
      {
        "slug": "CANVAS_CREATE_ASSIGNMENT_GRAPH_QL",
        "name": "Create assignment via GraphQL",
        "description": "Tool to create a new assignment in a Canvas course using the GraphQL API. Use when you need to create assignments with detailed configuration options including peer reviews, moderated grading, or assignment overrides."
      },
      {
        "slug": "CANVAS_CREATE_ASSIGNMENT_GROUP",
        "name": "Create assignment group",
        "description": "Create a new assignment group for a course. Use when you need to add a new assignment group to organize assignments in a Canvas course."
      },
      {
        "slug": "CANVAS_CREATE_ASSIGNMENT_OVERRIDE",
        "name": "Create assignment override",
        "description": "Creates an assignment override to adjust due/unlock/lock dates for an assignment in a course, targeting specific students (requires `title`), a group, or a course section; at least one target (`student_ids`, `group_id`, or `course_section_id`) is required."
      },
      {
        "slug": "CANVAS_CREATE_BATCH_OVERRIDES_IN_A_COURSE",
        "name": "Batch create overrides in a course",
        "description": "Tool to batch create assignment overrides for multiple assignments in a course. Use when creating multiple overrides at once in a transactional manner (all succeed or none are created). Each override requires assignment_id and one of student_ids, group_id, or course_section_id."
      },
      {
        "slug": "CANVAS_CREATE_BLACKOUT_DATE_FOR_COURSE",
        "name": "Create blackout date for course",
        "description": "Tool to create a blackout date for the given course context. Use when you need to define a period during which certain activities are restricted or unavailable for a specific course."
      },
      {
        "slug": "CANVAS_CREATE_BOOKMARK",
        "name": "Create Bookmark",
        "description": "Creates a new bookmark for the authenticated user. Use when you need to save a shortcut link to a Canvas page or external resource for quick access."
      },
      {
        "slug": "CANVAS_CREATE_CALENDAR_EVENT",
        "name": "Create Calendar Event",
        "description": "Creates a calendar event with options for recurrence (finite `rrule` series only), section-specific timings, and blackout dates within a specified context."
      },
      {
        "slug": "CANVAS_CREATE_COMMUNICATION_CHANNEL",
        "name": "Create communication channel",
        "description": "Creates a new communication channel (e.g., email, SMS, push) for an existing Canvas user to receive notifications."
      },
      {
        "slug": "CANVAS_CREATE_CONTENT_SHARE",
        "name": "Create content share",
        "description": "Shares a Canvas content item to specified users, if the sender has necessary permissions and receiver IDs are valid."
      },
      {
        "slug": "CANVAS_CREATE_CONVERSATION",
        "name": "Create conversation",
        "description": "Use to send messages in Canvas by creating a new conversation or adding to an existing one; an existing conversation with the same recipients (and matching scope/filter, if specified) may be reused unless `force_new` is true."
      },
      {
        "slug": "CANVAS_CREATE_CONVERSATION_GRAPH_QL",
        "name": "Create conversation via GraphQL",
        "description": "Tool to create a new conversation (message) between users in Canvas via GraphQL. Use when initiating a new conversation thread with specified recipients."
      },
      {
        "slug": "CANVAS_CREATE_COURSE",
        "name": "Create a course",
        "description": "Creates a new course in Canvas within a specified account, with comprehensive configuration options. Returns a course object including `id` (course_id); retain this for subsequent module, page, and upload calls."
      },
      {
        "slug": "CANVAS_CREATE_COURSE_GRADING_STANDARD",
        "name": "Create Course Grading Standard",
        "description": "Tool to create a new grading standard in a Canvas course. Use when you need to define a custom grading scale with grade labels and percentage thresholds for a specific course."
      },
      {
        "slug": "CANVAS_CREATE_CUSTOM_GRADEBOOK_COLUMN",
        "name": "Create a custom gradebook column",
        "description": "Creates a new custom gradebook column in a course. Use when you need to add custom tracking fields like participation scores or extra credit to the gradebook."
      },
      {
        "slug": "CANVAS_CREATE_DISCUSSION_ENTRY",
        "name": "Create discussion entry",
        "description": "Tool to create a new entry in a Canvas discussion topic. Use when posting a message with optional attachments to a discussion topic."
      },
      {
        "slug": "CANVAS_CREATE_DISCUSSION_ENTRY_GRAPH_QL",
        "name": "Create discussion entry (GraphQL)",
        "description": "Tool to create a new entry in a Canvas discussion topic via GraphQL. Use when posting a message or reply to a discussion topic with optional file attachments."
      },
      {
        "slug": "CANVAS_CREATE_DISCUSSION_TOPIC",
        "name": "Create discussion topic",
        "description": "Creates a new discussion topic in a specified Canvas course, allowing comprehensive configuration of its content, type, publication settings, engagement features, and associations."
      },
      {
        "slug": "CANVAS_CREATE_DISCUSSION_TOPIC_GRAPH_QL",
        "name": "Create discussion topic (GraphQL)",
        "description": "Tool to create a new discussion topic in a course or group using the Canvas GraphQL API. Use when creating discussion topics with the GraphQL interface."
      },
      {
        "slug": "CANVAS_CREATE_ENROLLMENT",
        "name": "Create enrollment",
        "description": "Enrolls a user in a Canvas course with a specified role and status; `associated_user_id` is required if `enrollment_type` is 'ObserverEnrollment'."
      },
      {
        "slug": "CANVAS_CREATE_EPUB_EXPORT",
        "name": "Create ePub export",
        "description": "Tool to initiate an ePub export for a course. Use when you need to export course content in ePub format. Track progress using the Progress API URL returned in the response."
      },
      {
        "slug": "CANVAS_CREATE_EXTERNAL_FEED",
        "name": "Create External Feed",
        "description": "Creates a new external RSS or Atom feed for a Canvas course. Use when you need to import external content into a course feed."
      },
      {
        "slug": "CANVAS_CREATE_EXTERNAL_FEED_FOR_GROUP",
        "name": "Create External Feed for Group",
        "description": "Tool to create a new external RSS or Atom feed for a Canvas group. Use when you need t

File truncated at 1 MB.