Workspaces

List shared emails and meetings with a workspace contact

Emails and meetings with one workspace contact from every member account shared with the workspace at a content level, read live through each sharing member's own Google or Outlook account and redacte

GET /v2/workspaces/{workspaceId}/contacts/{contactId}/shared-activity

Parameters

Path parameters

workspaceId

string (uuid) required

contactId

string (uuid) required

Query parameters

kinds

string

limit

integer

Responses

200 — Successful response

Content-Type: application/json

data

object required

data.shared_activity

object required

data.shared_activity.items

array<object> required

data.shared_activity.items[].id

string required

data.shared_activity.items[].type

string enum required

Possible values: "EMAIL", "CALENDAR"

data.shared_activity.items[].thread_id

string | null required

data.shared_activity.items[].date

string (date-time) required

data.shared_activity.items[].end_date

string (date-time) | null required

data.shared_activity.items[].is_all_day

boolean required

data.shared_activity.items[].member_user_ids

array<string> required

data.shared_activity.items[].visibility

string enum required

Possible values: "metadata", "full"

data.shared_activity.items[].subject

string required

data.shared_activity.items[].from

object | null required

data.shared_activity.items[].from.email

string required

data.shared_activity.items[].from.name

string | null required

data.shared_activity.items[].participants

array<object> required

data.shared_activity.items[].participants[].email

string required

data.shared_activity.items[].participants[].name

string | null required

data.shared_activity.items[].participants[].role

string enum required

Possible values: "from", "to", "cc", "attendee", "organizer"

data.shared_activity.items[].snippet

string | null required

data.shared_activity.items[].description

string | null required

data.shared_activity.items[].has_body

boolean required

data.shared_activity.items[].provider

string enum required

Possible values: "GOOGLE", "OFFICE365"

data.shared_activity.partial

boolean required

data.shared_activity.reconnect

array<object>

data.shared_activity.reconnect[].credential_id

string

data.shared_activity.reconnect[].provider

string enum

Possible values: "GOOGLE", "OFFICE365"

Example

{
  "data": {
    "shared_activity": {
      "items": [
        {
          "id": "string",
          "type": "EMAIL",
          "thread_id": "string",
          "date": "2026-11-13T08:29:48.855Z",
          "end_date": "2026-11-13T08:29:48.855Z",
          "is_all_day": false,
          "member_user_ids": [
            "string"
          ],
          "visibility": "metadata",
          "subject": "string",
          "from": {
            "email": "string",
            "name": "string"
          },
          "participants": [
            {
              "email": null,
              "name": null,
              "role": null
            }
          ],
          "snippet": "string",
          "description": "string",
          "has_body": false,
          "provider": "GOOGLE"
        }
      ],
      "partial": false
    }
  }
}

400 — Request body failed validation.

Content-Type: application/json

(body)

any

401 — Missing or invalid API key.

Content-Type: application/json

(body)

any

403 — Valid key, insufficient permission.

Content-Type: application/json

(body)

any

404 — Resource does not exist.

Content-Type: application/json

(body)

any

409 — Request conflicts with the current state of the resource.

Content-Type: application/json

(body)

any

429 — Rate limit exceeded.

Content-Type: application/json

(body)

any

500 — Unexpected server error.

Content-Type: application/json

(body)

any

Code samples

curl https://api.prod.getdex.com/v2/workspaces/00000000-0000-0000-0000-000000000000/contacts/00000000-0000-0000-0000-000000000000/shared-activity \
  --header 'Authorization: Bearer YOUR_API_KEY'

fetch('https://api.prod.getdex.com/v2/workspaces/00000000-0000-0000-0000-000000000000/contacts/00000000-0000-0000-0000-000000000000/shared-activity', {
  headers: {
    Authorization: 'Bearer YOUR_API_KEY'
  }
})

requests.get(
    "https://api.prod.getdex.com/v2/workspaces/00000000-0000-0000-0000-000000000000/contacts/00000000-0000-0000-0000-000000000000/shared-activity",
    headers={
      "Authorization": "Bearer YOUR_API_KEY"
    }
)

List workspace contact interactions

Per-member retained email, meeting and shared-note dates, and `linkedin_connected_at`, the date the member connected with the contact on LinkedIn (it counts toward Known by but is not an interaction),

List workspace calendar events

One window of the workspace calendar, `start` to `end` (ISO 8601 with offset, at most 7 days apart, plus an hour for a week that crosses a DST change; the start's offset decides which days teammates'