List all whiteboards
GET {{baseUrl}}/whiteboards?search_key=<string>&user_id=<string>&date_filter_type=modified_date&from=<dateTime>&to=<dateTime>&page_size=10&next_page_token=<string>
Use this API to list whiteboards of current user (
Required Scopes
:
whiteboard:read
) or list all whiteboards under the account (
Required Scopes
:
whiteboard:read:admin
).
Note:
user_id
can intake
Zoom user ID
or
email
which only applies when scope =
whiteboard:read:admin
. Otherwise, the
user_id
can only intake
me
.
Scopes:
whiteboard:read:admin
,
whiteboard:read
Rate Limit Label
:
MEDIUM
Request Params
| Key | Datatype | Required | Description |
| search_key | string | | The name of a whiteboard. If this parameter is provided, only the matched whiteboard will be returned. Otherwise, all whiteboards will be returned. |
| user_id | string | | The email address or user ID of the whiteboard owner. If this parameter is provided, only the whiteboard owned by the provided user will be returned.
If set to me, will return the matched whiteboards of current user. |
| date_filter_type | string | | The whiteboard date filter type.
Enum:
created_date- Whiteboard create date.modified_date- Whiteboard modify date. | |from| string | | The queried start date and time inyyyy-MM-dd'T'HH:mm:ss'Z'UTC format for the created date range for which you would like to retrieve whiteboards. The maximum range can be a month. If no value is provided for this field, the default will be current date. For example, if you make the API request on June 30, 2020, without providing the “from” and “to” parameters, by default the value of 'from' field will be “2020-06-30” and the value of the 'to' field will be “2020-07-01”. | |to| string | | The queried end date and time inyyyy-MM-dd'T'HH:mm:ss'Z'UTC format. | |page_size| number | | The number of records returned from a single API call. | |next_page_token| string | | The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes. |
HEADERS
| Key | Datatype | Required | Description |
| Accept | string | | |
RESPONSES
status: OK
{"whiteboards":[{"whiteboard_id":"\u003cstring\u003e","whiteboard_name":"Untitled","locked":false,"trashed":false,"readonly":false,"non_cloud":false,"created_date":"\u003cdateTime\u003e","modified_date":"\u003cdateTime\u003e","share_link_setting":{"share_scope":0,"share_role":3},"advanced_share_setting":{"can_share":"\u003cboolean\u003e","share_to_external":"\u003cboolean\u003e","external_can_share":"\u003cboolean\u003e"}},{"whiteboard_id":"\u003cstring\u003e","whiteboard_name":"Untitled","locked":false,"trashed":false,"readonly":false,"non_cloud":false,"created_date":"\u003cdateTime\u003e","modified_date":"\u003cdateTime\u003e","share_link_setting":{"share_scope":0,"share_role":4},"advanced_share_setting":{"can_share":"\u003cboolean\u003e","share_to_external":"\u003cboolean\u003e","external_can_share":"\u003cboolean\u003e"}}],"next_page_token":"\u003cstring\u003e","page_size":"\u003cinteger\u003e","total_records":"\u003cinteger\u003e"}