View as Markdown
Slack icon

Slack ACTION

List Files

Return a list of files within a team. See the documentation
  • Action
  • Read only
  • 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, but resolving it scans up to 5 conversations.list pages (~5,000 channels), which is slow and, on large workspaces, can be rate-limited or fail with a ConfigurationError if the channel is beyond that bound — 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.11
App
Slack
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes