Devices List Member Devices

POST

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

POST

/2/team/devices/list_member_devices

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

{
  "active_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"
    }
  ],
  "desktop_client_sessions": [
    {
      "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_client_sessions": [
    {
      "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"
    }
  ]
}

List all device sessions of a team’s member.

Required scope: sessions.list

Endpoint format: RPC

Authentication: Team

List all device sessions of a team's member. **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 an object.

team_member_idstringRequired

The team's member id.

include_desktop_clientsbooleanOptionalDefaults to true

Whether to list linked desktop devices of the team's member.

include_mobile_clientsbooleanOptionalDefaults to true

Whether to list linked mobile devices of the team's member.

include_web_sessionsbooleanOptionalDefaults to true

Whether to list web sessions of the team's member.

Response headers

X-Dropbox-Request-IdstringOptional

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

Response

Successful response

active_web_sessionslist of objects or nullOptional

List of web sessions made by this team member.

desktop_client_sessionslist of objects or nullOptional

List of desktop clients used by this team member.

mobile_client_sessionslist of objects or nullOptional

List of mobile client used by this team member.

Errors

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error