Open Context Protocol is live! 🚀 Read the launch post

filesRemoteList

Retrieve information about a remote file added to Slack

Details

  • Method: GET
  • Path: /files.remote.list
  • Operation ID: files_remote_list

Parameters

{
  "token": {
    "description": "Authentication token. Requires scope: `remote_files:read`",
    "required": false,
    "location": "query",
    "type": "string"
  },
  "channel": {
    "description": "Filter files appearing in a specific channel, indicated by its ID.",
    "required": false,
    "location": "query",
    "type": "string"
  },
  "ts_from": {
    "description": "Filter files created after this timestamp (inclusive).",
    "required": false,
    "location": "query",
    "type": "string"
  },
  "ts_to": {
    "description": "Filter files created before this timestamp (inclusive).",
    "required": false,
    "location": "query",
    "type": "string"
  },
  "limit": {
    "description": "The maximum number of items to return.",
    "required": false,
    "location": "query",
    "type": "string"
  },
  "cursor": {
    "description": "Paginate through collections of data by setting the `cursor` parameter to a `next_cursor` attribute returned by a previous request's `response_metadata`. Default value fetches the first \"page\" of the collection. See [pagination](/docs/pagination) for more detail.",
    "required": false,
    "location": "query",
    "type": "string"
  }
}

Response Schema

{
  "additionalProperties": true,
  "description": "This method either only returns a brief _OK_ response or a verbose schema is not available for this method.",
  "properties": {
    "ok": {
      "enum": [
        true
      ],
      "title": "default success response",
      "type": "boolean"
    }
  },
  "required": [
    "ok"
  ],
  "title": "Default success template",
  "type": "object"
}

Usage

from ocp_agent import OCPAgent

agent = OCPAgent()
await agent.register_api('slack')

# Call this tool
result = await agent.call_tool('filesRemoteList', {
    # Add required parameters here
})