From b7f69347f74c15be7e4bb7afb40848f90ac3cc50 Mon Sep 17 00:00:00 2001
From: Matthias <matthias.colin@maecia.com>
Date: Fri, 27 Dec 2024 15:48:42 +0100
Subject: [PATCH] Documentation Slack

---
 plugins/modules/slack.py | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/plugins/modules/slack.py b/plugins/modules/slack.py
index 6676e1154f2..f880aeb8af6 100644
--- a/plugins/modules/slack.py
+++ b/plugins/modules/slack.py
@@ -141,6 +141,33 @@
       - 'auto'
     default: 'auto'
     version_added: 6.1.0
+  upload_file:
+    type: dict
+    description:
+      - Specify details to upload a file to Slack. The file can include metadata such as an initial comment, alt text, snipped and title.
+      - See Slack's file upload API for details: U(https://api.slack.com/methods/files.getUploadURLExternal) and U(https://api.slack.com/methods/files.completeUploadExternal).
+    suboptions:
+      path:
+        type: str
+        description:
+          - Path to the file on the local system to upload.
+        required: true
+      initial_comment:
+        type: str
+        description:
+          - Optional comment to include when uploading the file.
+      alt_text:
+        type: str
+        description:
+          - Optional alternative text to describe the file.
+      snippet_type:
+        type: str
+        description:
+          - Optional snippet type for the file.
+      title:
+        type: str
+        description:
+          - Optional title for the uploaded file.
 """
 
 EXAMPLES = r"""
@@ -262,6 +289,7 @@
       initial_comment: ''
       alt_text: ''
       snippet_type: ''
+      title: ''
 """
 
 import re