Sharing Allowlist List

Preview

POST

https://api.dropboxapi.com/2/team/sharing_allowlist/list

Lists Approve List entries for given team, from newest to oldest, returning up to limit entries at a time. If there are more than limit entries associated with the current team, more can be fetched by passing the returned cursor to sharing_allowlist/list/continue.

Required scope: team_info.read

Endpoint format: RPC

Authentication: Team

Lists Approve List entries for given team, from newest to oldest, returning up to `limit` entries at a time. If there are more than `limit` entries associated with the current team, more can be fetched by passing the returned `cursor` to [sharing_allowlist/list/continue](api:dropbox-api:POST/2/team/sharing_allowlist/list/continue). **Required scope:** `team_info.read` **Endpoint format:** [RPC](https://docs.dropboxapi.com/dropbox-api/docs/technical-reference/request-response-formats#rpc-endpoints) **Authentication:** [Team](https://docs.dropboxapi.com/dropbox-api/docs/auth-types#team-authentication)

Authentication

AuthorizationBearer

Team-level OAuth 2.0 token issued to a Dropbox Business admin. Use Authorization: Bearer <token>.

Obtain via the authorization code flow with team-scoped permissions.

Grants access to team-wide administrative operations.

You can generate a short-lived access token from the App Console; see Testing with a generated token.

Team-level OAuth 2.0 token issued to a Dropbox Business admin. Use `Authorization: Bearer <token>`. Obtain via the authorization code flow with team-scoped permissions. Grants access to team-wide administrative operations. You can generate a short-lived access token from the App Console; see [Testing with a generated token](https://docs.dropboxapi.com/dropbox-api/docs/oauth#testing-with-a-generated-token).

Request

This endpoint expects a nullable object.

limituintOptional1-1000Defaults to 1000

The number of entries to fetch at one time.

Response headers

X-Dropbox-Request-IdstringOptional

A unique identifier for the request, useful for debugging and support.

Response

Successful response

domainslist of strings

List of domains represented by valid string representation (RFC-1034/5).

emailslist of strings

List of emails represented by valid string representation (RFC-5322/822).

cursorstringOptionalDefaults to

If this is nonempty, there are more entries that can be fetched with sharing_allowlist/list/continue.

has_morebooleanOptionalDefaults to false

if true indicates that more entries can be fetched with sharing_allowlist/list/continue.

Errors

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error