View as Markdown
Slack icon

Slack ACTION

List Files

Return a list of files within a team. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Slack account once, then configure and run List Files from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "slack_v2-list-files",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    slack_v2: { authProvisionId: "apn_xxxxxxx" },
    conversation: "Channel",
    addToChannel: true,
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Files inputs
Property Type Description
conversation Channel string
Prefer a channel ID (e.g. C1234567890) — use List Channels to look it up; it resolves instantly. A channel NAME (e.g. general or #general) is also accepted: it is looked up among the channels you are a member of first, then the workspace's public channels. That lookup is slower than an ID and, on large workspaces, can be rate-limited or fail with a ConfigurationError if the channel isn't found within ~5,000 channels — pass the ID whenever you have it. Depending on the action, this may also accept a user ID (opens a direct message) or a group DM ID — use Find User by Email / Find User by ID to resolve a user ID, or List Group Conversations for group DM IDs.
Required
addToChannel Add app to channel automatically? boolean
If true, the app will be added to the specified non-DM channel(s) automatically. If false, you must add the app to the channel manually. Defaults to true.
Required
team_id Team string
The encoded team ID (e.g. T1234567890). Only required when the connected token spans multiple teams (Enterprise Grid); omit otherwise. Use List Teams to find valid IDs.
Optional
user User string
The user's ID (e.g. U1234567890). Use Find User by Email to resolve an ID from an email address, or List Users to browse all users.
Optional
pageSize Page Size integer
The number of results to include in a page. Default: 250
Optional
numPages Number of Pages integer
The number of pages to retrieve. Default: 1
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
slack_v2-list-files
Version
0.1.18
App
Slack
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes