Skip to content

Commit e7f242a

Browse files
ouiliameclaude
ouiliame
and
claude
committed
docs: regenerate after staging merge — Slack trigger update + file block re-visible
Staging's mothership v0.2 (#4923) expanded the Slack trigger payload (interactivity, slash commands: event_type, command, action_id/value/actions, response_url, trigger_id, callback_id, ...) — regenerated so it lands on the unified integrations/slack page; the old-layout triggers/slack.mdx from staging's generator was dropped in the merge. The file block is visible again upstream, so integrations/file.mdx is back in the catalog. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 641a281 commit e7f242a

3 files changed

Lines changed: 131 additions & 2 deletions

File tree

‎apps/docs/content/docs/en/integrations/file.mdx‎

Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,119 @@
1+
---
2+
title: File
3+
description: Read, get content, fetch, write, and append files
4+
---
5+
6+
import { BlockInfoCard } from "@/components/ui/block-info-card"
7+
8+
<BlockInfoCard
9+
type="file_v5"
10+
color="#F5F5F5"
11+
/>
12+
13+
## Usage Instructions
14+
15+
Read workspace file objects, extract the text content of files, fetch and parse files from URLs with optional headers, write new workspace files, or append content to existing files.
16+
17+
18+
19+
## Actions
20+
21+
### `file_read`
22+
23+
#### Input
24+
25+
| Parameter | Type | Required | Description |
26+
| --------- | ---- | -------- | ----------- |
27+
28+
#### Output
29+
30+
| Parameter | Type | Description |
31+
| --------- | ---- | ----------- |
32+
| `files` | file[] | Workspace file objects \(read\) or fetched file objects \(fetch\) |
33+
| `contents` | array | Array of file text contents, one entry per file \(get content\) |
34+
| `combinedContent` | string | All fetched file contents merged into a single text string \(fetch\) |
35+
| `id` | string | File ID \(write and append\) |
36+
| `name` | string | File name \(write and append\) |
37+
| `size` | number | File size in bytes \(write and append\) |
38+
| `url` | string | URL to access the file \(write and append\) |
39+
40+
### `file_get_content`
41+
42+
#### Input
43+
44+
| Parameter | Type | Required | Description |
45+
| --------- | ---- | -------- | ----------- |
46+
47+
#### Output
48+
49+
| Parameter | Type | Description |
50+
| --------- | ---- | ----------- |
51+
| `files` | file[] | Workspace file objects \(read\) or fetched file objects \(fetch\) |
52+
| `contents` | array | Array of file text contents, one entry per file \(get content\) |
53+
| `combinedContent` | string | All fetched file contents merged into a single text string \(fetch\) |
54+
| `id` | string | File ID \(write and append\) |
55+
| `name` | string | File name \(write and append\) |
56+
| `size` | number | File size in bytes \(write and append\) |
57+
| `url` | string | URL to access the file \(write and append\) |
58+
59+
### `file_fetch`
60+
61+
#### Input
62+
63+
| Parameter | Type | Required | Description |
64+
| --------- | ---- | -------- | ----------- |
65+
66+
#### Output
67+
68+
| Parameter | Type | Description |
69+
| --------- | ---- | ----------- |
70+
| `files` | file[] | Workspace file objects \(read\) or fetched file objects \(fetch\) |
71+
| `contents` | array | Array of file text contents, one entry per file \(get content\) |
72+
| `combinedContent` | string | All fetched file contents merged into a single text string \(fetch\) |
73+
| `id` | string | File ID \(write and append\) |
74+
| `name` | string | File name \(write and append\) |
75+
| `size` | number | File size in bytes \(write and append\) |
76+
| `url` | string | URL to access the file \(write and append\) |
77+
78+
### `file_write`
79+
80+
Create a new workspace file. If a file with the same name already exists, a numeric suffix is added (e.g.,
81+
82+
#### Input
83+
84+
| Parameter | Type | Required | Description |
85+
| --------- | ---- | -------- | ----------- |
86+
| `fileName` | string | Yes | File name \(e.g., "data.csv"\). If a file with this name exists, a numeric suffix is added automatically. |
87+
| `content` | string | Yes | The text content to write to the file. |
88+
| `contentType` | string | No | MIME type for new files \(e.g., "text/plain"\). Auto-detected from file extension if omitted. |
89+
90+
#### Output
91+
92+
| Parameter | Type | Description |
93+
| --------- | ---- | ----------- |
94+
| `id` | string | File ID |
95+
| `name` | string | File name |
96+
| `size` | number | File size in bytes |
97+
| `url` | string | URL to access the file |
98+
99+
### `file_append`
100+
101+
Append content to an existing workspace file. The file must already exist. Content is added to the end of the file.
102+
103+
#### Input
104+
105+
| Parameter | Type | Required | Description |
106+
| --------- | ---- | -------- | ----------- |
107+
| `fileName` | string | Yes | Name of an existing workspace file to append to. |
108+
| `content` | string | Yes | The text content to append to the file. |
109+
110+
#### Output
111+
112+
| Parameter | Type | Description |
113+
| --------- | ---- | ----------- |
114+
| `id` | string | File ID |
115+
| `name` | string | File name |
116+
| `size` | number | File size in bytes |
117+
| `url` | string | URL to access the file |
118+
119+

‎apps/docs/content/docs/en/integrations/meta.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,7 @@
5555
"exa",
5656
"extend",
5757
"fathom",
58+
"file",
5859
"findymail",
5960
"firecrawl",
6061
"fireflies",

‎apps/docs/content/docs/en/integrations/slack.mdx‎

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1346,21 +1346,30 @@ Trigger workflow from Slack events like mentions, messages, and reactions
13461346
| Parameter | Type | Description |
13471347
| --------- | ---- | ----------- |
13481348
| `event` | object | Slack event data |
1349-
| ↳ `event_type` | string | Type of Slack event \(e.g., app_mention, message\) |
1349+
| ↳ `event_type` | string | Type of Slack payload: an Events API event \(e.g., app_mention, message\), an interactivity type \(e.g., block_actions\), or "slash_command" for slash commands |
13501350
| ↳ `subtype` | string | Message subtype \(e.g., channel_join, channel_leave, bot_message, file_share\). Null for regular user messages |
13511351
| ↳ `channel` | string | Slack channel ID where the event occurred |
13521352
| ↳ `channel_name` | string | Human-readable channel name |
13531353
| ↳ `channel_type` | string | Type of channel \(e.g., channel, group, im, mpim\). Useful for distinguishing DMs from public channels |
13541354
| ↳ `user` | string | User ID who triggered the event |
13551355
| ↳ `user_name` | string | Username who triggered the event |
13561356
| ↳ `bot_id` | string | Bot ID if the message was sent by a bot. Null for human users |
1357-
| ↳ `text` | string | Message text content |
1357+
| ↳ `text` | string | Message text content. For slash commands, the text after the command. For interactivity, the source message text \(falls back to the triggering action value\) |
13581358
| ↳ `timestamp` | string | Message timestamp from the triggering event |
13591359
| ↳ `thread_ts` | string | Parent thread timestamp \(if message is in a thread\) |
13601360
| ↳ `team_id` | string | Slack workspace/team ID |
13611361
| ↳ `event_id` | string | Unique event identifier |
13621362
| ↳ `reaction` | string | Emoji reaction name \(e.g., thumbsup\). Present for reaction_added/reaction_removed events |
13631363
| ↳ `item_user` | string | User ID of the original message author. Present for reaction_added/reaction_removed events |
1364+
| ↳ `command` | string | Slash command name including the leading slash \(e.g., /deploy\). Present for slash commands |
1365+
| ↳ `action_id` | string | action_id of the first interactive element triggered. Present for block_actions \(button/select clicks\) |
1366+
| ↳ `action_value` | string | Value carried by the first interactive element \(button value, selected option, date, etc.\). Present for block_actions |
1367+
| ↳ `actions` | json | Full array of interactive actions from the payload, preserving every element and its value. Present for block_actions |
1368+
| ↳ `response_url` | string | Temporary URL to post a response back to the originating message or command. Present for interactivity and slash commands |
1369+
| ↳ `trigger_id` | string | Short-lived trigger ID used to open a modal in response. Present for interactivity and slash commands |
1370+
| ↳ `callback_id` | string | Callback ID of the shortcut or view. Present for shortcuts and modal submissions |
1371+
| ↳ `api_app_id` | string | Slack app ID. Present for interactivity and slash commands |
1372+
| ↳ `message_ts` | string | Timestamp of the message the interaction originated from. Present for block_actions |
13641373
| ↳ `hasFiles` | boolean | Whether the message has file attachments |
13651374
| ↳ `files` | file[] | File attachments downloaded from the message \(if includeFiles is enabled and bot token is provided\) |
13661375

0 commit comments

Comments
 (0)