Devices List Team Devices

Deprecated

POST

https://api.dropboxapi.com/2/team/devices/list_team_devices

List all device sessions of a team.

Permission : Team member file access.

Required scope: sessions.list

Endpoint format: RPC

Authentication: Team

List all device sessions of a team. Permission : Team member file access. **Required scope:** `sessions.list` **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.

cursorstring or nullOptional

At the first call to the devices/list_team_devices the cursor shouldn’t be passed. Then, if the result of the call includes a cursor, the following requests should include the received cursors in order to receive the next sub list of team devices.

include_desktop_clientsbooleanOptionalDefaults to true

Whether to list desktop clients of the team members.

include_mobile_clientsbooleanOptionalDefaults to true

Whether to list mobile clients of the team members.

include_web_sessionsbooleanOptionalDefaults to true

Whether to list web sessions of the team members.

Response headers

X-Dropbox-Request-IdstringOptional

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

Response

Successful response

deviceslist of objects

The devices of each member of the team.

has_moreboolean

If true, then there are more devices available. Pass the cursor to devices/list_team_devices to retrieve the rest.

cursorstring or nullOptional

Pass the cursor into devices/list_team_devices to receive the next sub list of team’s devices.

Errors

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error