---
title: "List teammates Patricia can introduce herself to"
method: GET
path: "/v1/team-introductions"
tags: ["team-introductions"]
---

# List teammates Patricia can introduce herself to

`GET /v1/team-introductions`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/team-introductions`
- Auth: HTTP bearer

The workspace's chat roster with a per-person answer: who Patricia can say hello to, and who she cannot and why. Guests and teammates she has already met are listed but cannot be chosen. Reading this sends nothing.

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

Successful Response

- TeamIntroductionListResponse: The roster, its freshness, and whether the primary action may fire at all.
  - `roster_state` 'not_connected' | 'unavailable' | 'listed', required: Whether this workspace's chat roster can be shown at all.
  - `can_introduce` boolean, required
  - `blocked_reason` 'workspace_not_activated', required: Why the primary action is refused for the whole workspace.
  - `roster_synced_at` string, date-time, nullable, required
  - `refresh_recommended` boolean, required
  - `teammate_count` integer, required
  - `truncated` boolean, required
  - `items` TeamIntroductionItem[], required
    - `membership_id` string, uuid, required
    - `chat_user_id` string, nullable, required
    - `slack_user_id` string, nullable, required
    - `display_name` string, required
    - `handle` string, nullable, required
    - `role_code` string, required
    - `eligible` boolean, required
    - `excluded_reason` 'already_met' | 'already_queued' | 'no_chat_dm' | 'attempts_exhausted' | 'guest_excluded' | 'guest_unverified', required: Why one teammate is listed but cannot be picked.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden. Inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, TENANT_ACCESS_REQUIRED, ROLE_UNRESOLVED)
- `404`: Not found
- `422`: Validation error

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)