List subscriptions
GET {{baseUrl}}/api/-/pulse/subscriptions?user_id={{user-id}}
Lists the subscriptions to a specified metric and/or for a specified user.
If only metric-id is specified, all subscriptions for that metric are returned.
If only user-id is specified, al subscriptions for that user are returned.
If both metric_id or user_id and specified, then the user's subscription for the specified metric is returned.
If no metric_id or user_id is specified, all subscriptions on the site will be returned.
Version: Available in API 3.21 (Tableau Cloud December 2023) and later. Not available for Tableau Server. Versioning Overview
Permissions: Any user that has read or connect permission to the data source used in the definition can list subscriptions. Permissions Overview
License: No additional license required.
Access Scope: tableau:metric_subscriptions:read
Access Scopes Overview: Cloud
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
page_size | string | Specifies the number of results in a paged response. |
Example:
> GET .../subscriptions?pageSize=50
Combining Path Parameters: A page_size expression can be combined with other path parameters using an ampersand (&) as a separator, and is typically used along with a page number expression.
<a href='https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_paging.htm' target='_blank'>Learn more about paginating the response</a>. |
| page_token | string | | Specifies the page of items to be returned from a requested list.
The value of page_token for the next page of returns is found in
the next_page_token of the current response. If there are no
further items to return, the value of next_page_token will be
empty.
Example:
> GET .../definitions?pageToken={next_page_value}
Combining Path Parameters: A page_token expression can be combined with other path parameters using an ampersand (&) as a separator, and is typically used along with a page number expression.
<a href='https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_paging.htm' target='_blank'>Learn more about paginating the response</a>. |
| user_id | string | | The LUID of a user whose subscriptions will be returned. |
| metric_id | string | | The LUID of a metric whose subscriptions will be returned. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
X-Tableau-Auth | string | The Tableau authentication header. The value is a credentials token from a Tableau server's response to an authentication request. | |
| The Content-Type and Accept headers should be the mediatype of the request and response except in cases where you want to explicitly allow other versions of the resource. | |||
Accept | string | ||
Accept | string |
RESPONSES
status: OK
{"subscriptions":[{"id":"ac9f9958-9c5e-4e8e-b9b6-29d4d131d774","metric_id":"d83882d5-82d6-4373-8b15-097be38e6364","follower":{"user_id":"a3302788-5406-4ab7-bbe3-e2dd39b9eb6f"},"create_time":"2023-12-12T14:42:55.365638Z","update_time":"2023-12-12T14:42:55.365638Z"},{"id":"b0df0f1b-a483-4c73-bf67-cc0635cccc8a","metric_id":"6ccfd714-e506-4684-af42-54e2e9c9cd14","follower":{"user_id":"a3302788-5406-4ab7-bbe3-e2dd39b9eb6f"},"create_time":"2023-12-07T21:16:56.136548Z","update_time":"2023-12-07T21:16:56.136548Z"},{"id":"65dc44ba-b1bf-4010-ad83-a5b65c792d93","metric_id":"3a3306ef-e885-4ffd-a41c-a4a578f0b818","follower":{"user_id":"a3302788-5406-4ab7-bbe3-e2dd39b9eb6f"},"create_time":"2023-12-07T21:15:40.915944Z","update_time":"2023-12-07T21:15:40.915944Z"},{"id":"83f13288-aadf-4807-85c6-0a5fbc2326f5","metric_id":"b0d468fa-3cc8-4f7e-9447-21542bbb8244","follower":{"user_id":"a3302788-5406-4ab7-bbe3-e2dd39b9eb6f"},"create_time":"2023-12-07T21:14:36.276962Z","update_time":"2023-12-07T21:14:36.276962Z"}],"next_page_token":""}