Add cursor argument to files.list, enabling cursor-based pagination

CHANGELOG.md

@@ -4,6 +4,7 @@ Changelog
 Some notable infrastructure contributions below. See [commits](commits/master) for Slack API updates.
 
 * Your contribution here.
+* [#90](https://github.com/slack-ruby/slack-api-ref/pull/90): Add `cursor` argument to `files.list`, enabling cursor-based pagination - [@rangerscience](https://github.com/rangerscience), [@dblock](https://github.com/dblock).
 * [#89](https://github.com/slack-ruby/slack-api-ref/pull/89): Migrate AI commit message generation to Copilot CLI after GitHub Models retirement - [@dblock](https://github.com/dblock).
 * [#87](https://github.com/slack-ruby/slack-api-ref/pull/87): Generate AI commit summaries for automated API updates - [@dblock](https://github.com/dblock).
 * [#64](https://github.com/slack-ruby/slack-api-ref/pull/64): Add `arg_groups` for groups of arguments whose requirement is interdependent - [@jmanian](https://github.com/jmanian).

methods/_patches/files/files.list.json

@@ -0,0 +1,49 @@
+{
+  "args": {
+    "channel": {
+      "required": false,
+      "desc": "Filter files appearing in a specific channel, indicated by its ID.",
+      "type": "channel"
+    },
+    "cursor": {
+      "required": false,
+      "example": "dXNlcjpVMDYxTkZUVDI=",
+      "desc": "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 for more detail.",
+      "type": "string"
+    },
+    "show_files_hidden_by_limit": {
+      "required": false,
+      "example": "true",
+      "desc": "Show truncated file info for files hidden due to being too old, and the team who owns the file being over the file limit.",
+      "type": "boolean"
+    },
+    "team_id": {
+      "required": false,
+      "desc": "encoded team id to list files in, required if org token is used.",
+      "type": "string"
+    },
+    "ts_from": {
+      "required": false,
+      "example": "123456789",
+      "desc": "Filter files created after this timestamp (inclusive).",
+      "type": "string"
+    },
+    "ts_to": {
+      "required": false,
+      "example": "123456789",
+      "desc": "Filter files created before this timestamp (inclusive).",
+      "type": "string"
+    },
+    "types": {
+      "required": false,
+      "example": "images",
+      "desc": "Filter files by type (see below). You can pass multiple values in the types argument, like types=spaces,snippets.The default value is all, which does not filter the list.",
+      "type": "string"
+    },
+    "user": {
+      "required": false,
+      "desc": "Filter files created by a single user.",
+      "type": "user"
+    }
+  }
+}

methods/files/files.list.json

@@ -9,6 +9,12 @@
       "desc": "Filter files appearing in a specific channel, indicated by its ID.",
       "type": "channel"
     },
+    "cursor": {
+      "required": false,
+      "example": "dXNlcjpVMDYxTkZUVDI=",
+      "desc": "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 for more detail.",
+      "type": "string"
+    },
     "show_files_hidden_by_limit": {
       "required": false,
       "example": "true",