From f0502f3c3a7606f7d10a61fb2916e181a49f6d14 Mon Sep 17 00:00:00 2001
From: Jordan Woods <13803242+jorwoods@users.noreply.github.com>
Date: Tue, 31 Mar 2026 19:32:05 -0500
Subject: [PATCH 1/3] docs: add jobs.get method to api-ref.md

Documents the jobs.get method for listing all background jobs on a site,
which was not previously documented despite being in the API since v2.6.

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

diff --git a/docs/api-ref.md b/docs/api-ref.md
index 589cd2b5..682e9ac2 100644
--- a/docs/api-ref.md
+++ b/docs/api-ref.md
@@ -1835,6 +1835,46 @@ Source files: server/endpoint/jobs_endpoint.py
 <br>
 <br>
 
+#### jobs.get
+
+```py
+jobs.get(job_id=None, req_options=None)
+```
+
+Returns a list of active jobs on the current site, or the status of a specific job if `job_id` is provided.
+
+REST API: [Get Background Jobs on Site](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_jobs_tasks_and_schedules.htm#get_background_jobs_on_site){:target="_blank"}
+
+**Parameters**
+
+Name | Description
+:--- | :---
+`job_id` | (Optional) The `job_id` specifies the job to query. When provided, returns the status of that specific job.
+`req_options` | (Optional) You can pass the method a request object that contains additional parameters to filter the request.
+
+**Returns**
+
+Returns a list of `BackgroundJobItem` objects and a `PaginationItem` object.
+
+**Version**
+
+Version 2.6 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
+tableau_auth = TSC.TableauAuth('USERNAME', 'PASSWORD')
+server = TSC.Server('https://SERVERURL')
+
+with server.auth.sign_in(tableau_auth):
+    all_jobs, pagination_item = server.jobs.get()
+    print("\nThere are {} jobs on site: ".format(pagination_item.total_available))
+    print([job.id for job in all_jobs])
+```
+
+<br>
+<br>
 
 #### jobs.get_by_id
 

From ba82339b010c73b57f6e2c9a56bb493ebb8a12f2 Mon Sep 17 00:00:00 2001
From: Jordan Woods <13803242+jorwoods@users.noreply.github.com>
Date: Tue, 31 Mar 2026 21:00:28 -0500
Subject: [PATCH 2/3] docs: add jobs.filter to api-ref.md

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

diff --git a/docs/api-ref.md b/docs/api-ref.md
index 682e9ac2..4f3a166d 100644
--- a/docs/api-ref.md
+++ b/docs/api-ref.md
@@ -2014,6 +2014,45 @@ See the `update_datasource_data.py` or `refresh.py` sample in the Samples direct
 <br>
 <br>
 
+#### jobs.filter
+
+```py
+jobs.filter(**kwargs)
+```
+
+Returns a list of background jobs that match the specified filters. Fields and operators are passed as keyword arguments in the form `field_name=value` or `field_name__operator=value`.
+
+**Supported fields and operators**
+
+Field | Operators
+:--- | :---
+`args` | `has`
+`completed_at` | `eq`, `gt`, `gte`, `lt`, `lte`
+`created_at` | `eq`, `gt`, `gte`, `lt`, `lte`
+`job_type` | `eq`, `in`
+`notes` | `has`
+`priority` | `eq`, `gt`, `gte`, `lt`, `lte`
+`progress` | `eq`, `gt`, `gte`, `lt`, `lte`
+`started_at` | `eq`, `gt`, `gte`, `lt`, `lte`
+`status` | `eq`
+`subtitle` | `eq`, `has`
+`title` | `eq`, `has`
+
+**Returns**
+
+Returns a `QuerySet` of `BackgroundJobItem` objects.
+
+**Example**
+
+```py
+failed_jobs = server.jobs.filter(status='Failed')
+for job in failed_jobs:
+    print(job.id, job.type)
+```
+
+<br>
+<br>
+
 ---
 
 ## Metadata

From 405edd99a68dd818756afa49687c958f41ea39a7 Mon Sep 17 00:00:00 2001
From: Jordan Woods <jorwoods@users.noreply.github.com>
Date: Thu, 2 Apr 2026 08:07:44 -0500
Subject: [PATCH 3/3] Update job retrieval description in API reference

Retrieve jobs for the site with pagination details. Note that specifying a job_id is deprecated and will be removed in a future version.
---
 docs/api-ref.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/api-ref.md b/docs/api-ref.md
index 4f3a166d..85a25d4c 100644
--- a/docs/api-ref.md
+++ b/docs/api-ref.md
@@ -1841,7 +1841,8 @@ Source files: server/endpoint/jobs_endpoint.py
 jobs.get(job_id=None, req_options=None)
 ```
 
-Returns a list of active jobs on the current site, or the status of a specific job if `job_id` is provided.
+Retrieve jobs for the site. Endpoint is paginated and will return a list of jobs and pagination information. If a job_id is provided, the method will return information about that specific job. Specifying a job_id is deprecated and will be removed in a future version.
+
 
 REST API: [Get Background Jobs on Site](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_jobs_tasks_and_schedules.htm#get_background_jobs_on_site){:target="_blank"}