From 4e3a54f6cf008ea64d5043c275315bcc2409fd7c Mon Sep 17 00:00:00 2001
From: Jordan Woods <13803242+jorwoods@users.noreply.github.com>
Date: Tue, 31 Mar 2026 19:36:39 -0500
Subject: [PATCH 1/2] docs: add tasks.create method to api-ref.md

Documents the tasks.create method for creating extract refresh tasks,
added in REST API version 3.19, which was not previously documented.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 docs/api-ref.md | 46 ++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 44 insertions(+), 2 deletions(-)

diff --git a/docs/api-ref.md b/docs/api-ref.md
index 589cd2b5..a48961b8 100644
--- a/docs/api-ref.md
+++ b/docs/api-ref.md
@@ -4793,8 +4793,50 @@ Error   |  Description
 
 ```
 
-<br>   
-<br>  
+<br>
+<br>
+
+#### tasks.create
+
+```py
+tasks.create(extract_item)
+```
+
+Creates a new extract refresh task on the site.
+
+**Parameters**
+
+Name | Description
+:--- | :---
+`extract_item` | The `TaskItem` specifying the extract refresh task to create. The task item must have the target workbook or datasource set.
+
+**Exceptions**
+
+Error | Description
+:--- | :---
+`ValueError` | Raises an exception if no extract item is provided.
+
+**Returns**
+
+Returns the created `TaskItem`.
+
+**Version**
+
+Version 3.19 and later. See [REST API versions](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm).
+
+**Example**
+
+```py
+import tableauserverclient as TSC
+
+task_item = TSC.TaskItem(TSC.TaskItem.Type.ExtractRefresh)
+task_item.target = TSC.Target(datasource_id, 'datasource')
+new_task = server.tasks.create(task_item)
+print("Created task ID: {}".format(new_task.id))
+```
+
+<br>
+<br>
 
 
 ---

From 481f47a68201fb0b5221f8173b6a40c114b88203 Mon Sep 17 00:00:00 2001
From: Jordan Woods <jorwoods@users.noreply.github.com>
Date: Thu, 2 Apr 2026 07:54:37 -0500
Subject: [PATCH 2/2] Clarify extract refresh task creation details

Updated the description for creating an extract refresh task to specify custom scheduling for Tableau Cloud and reference Tableau Server.
---
 docs/api-ref.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/api-ref.md b/docs/api-ref.md
index a48961b8..ae26488a 100644
--- a/docs/api-ref.md
+++ b/docs/api-ref.md
@@ -4802,7 +4802,7 @@ Error   |  Description
 tasks.create(extract_item)
 ```
 
-Creates a new extract refresh task on the site.
+Creates a custom schedule for an extract refresh on Tableau Cloud. For Tableau Server, use the Schedules endpoint to create a schedule.
 
 **Parameters**