Devices List Members Devices

POST

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

POST

/2/team/devices/list_members_devices

import requests
url = "https://api.dropboxapi.com/2/team/devices/list_members_devices"
payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "devices": [
    {
      "team_member_id": "string",
      "desktop_clients": [
        {
          "client_type": {
            ".tag": "windows"
          },
          "client_version": "string",
          "host_name": "string",
          "is_delete_on_unlink_supported": true,
          "platform": "string",
          "session_id": "string",
          "country": "string",
          "created": "2024-01-15T09:30:00Z",
          "ip_address": "string",
          "updated": "2024-01-15T09:30:00Z"
        }
      ],
      "mobile_clients": [
        {
          "client_type": {
            ".tag": "iphone"
          },
          "device_name": "string",
          "session_id": "string",
          "client_version": "string",
          "country": "string",
          "created": "2024-01-15T09:30:00Z",
          "ip_address": "string",
          "last_carrier": "string",
          "os_version": "string",
          "updated": "2024-01-15T09:30:00Z"
        }
      ],
      "web_sessions": [
        {
          "browser": "string",
          "os": "string",
          "session_id": "string",
          "user_agent": "string",
          "country": "string",
          "created": "2024-01-15T09:30:00Z",
          "expires": "2024-01-15T09:30:00Z",
          "ip_address": "string",
          "updated": "2024-01-15T09:30:00Z"
        }
      ]
    }
  ],
  "has_more": true,
  "cursor": "string"
}

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_members_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_members_devices to retrieve the rest.

cursorstring or nullOptional

Pass the cursor into devices/list_members_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