v0.1.4 to v0.1.5

27 added, 6 removed. Audit A to A.

---

name: user-details

description: Pulls a full profile for any Chili Piper user — teams, workspaces, meeting types, scheduling links, and recent meeting activity — for onboarding audits, offboarding checks, and rep-level troubleshooting

- version: 0.1.4

+ version: 0.1.5

inputs:

- name: user

type: string

description: "Email address, name, or Chili Piper user ID of the user to inspect"

required: true

- name: include_meetings

type: boolean

description: "Include recent meeting volume (last 30 days). Requires meeting.read scope."

required: false

default: true

outputs:

- name: profile

description: User identity, license type, and CRM/calendar connection status

- name: memberships

description: All workspaces and teams the user belongs to

- name: scheduling_links

- description: Personal and round-robin scheduling links owned by this user

+ description: Personal, round-robin, admin one-on-one, group, and ownership scheduling links owned by or including this user

- name: recent_activity

description: Meeting volume and no-show rate for the last 30 days (if include_meetings=true)

tools_required: [chili-piper-mcp]

human_decision_point: "Review the profile and decide: onboard the user to missing teams, fix routing gaps, or proceed with offboarding"

writes_to: "Nothing — read-only diagnostic"

- api_note: "Field names validated against live MCP responses. user-read returns license info but NO calendar/CRM connection status. user-find is needed first if you have an email or name rather than a user ID. workspace-list items use `id` (not `workspaceId`); team-list-put results use `id` (not `teamId`) and include `workspaceId`. As of DISTRO-4472 (2026-05-21): team-list-put member filter is live (server-side filtering by userId); team-list-put also accepts an optional name filter. meeting-export-v2-put supports server-side filters: hostIds, assigneeIds, bookerIds, meetingTypeIds, status. As of CEH-10353 (2026-06-03): licenses gains an optional `tier` field (`RoutingAndScheduling`|`Experiences`|`ChiliDataPlatform`); `distro`, `concierge`, `conciergeLive`, `chat` are now optional booleans (default `false` when absent); `chiliCalOrg` and `handoff` remain required."

+ api_note: "Field names validated against live MCP responses. user-read returns license info but NO calendar/CRM connection status. user-find is needed first if you have an email or name rather than a user ID. workspace-list items use `id` (not `workspaceId`); team-list-put results use `id` (not `teamId`) and include `workspaceId`. As of DISTRO-4472 (2026-05-21): team-list-put member filter is live (server-side filtering by userId); team-list-put also accepts an optional name filter. meeting-export-v2-put supports server-side filters: hostIds, assigneeIds, bookerIds, meetingTypeIds, status. As of CEH-10353 (2026-06-03): licenses gains an optional `tier` field (`RoutingAndScheduling`|`Experiences`|`ChiliDataPlatform`); `distro`, `concierge`, `conciergeLive`, `chat` are now optional booleans (default `false` when absent); `chiliCalOrg` and `handoff` remain required. As of DISTRO-4548 (2026-06-16): scheduling-link-list-admin-one-on-one, scheduling-link-list-group, and scheduling-link-list-ownership are now live — query all five link types to enumerate every scheduling link this user is part of."

---

# User Details

You are a RevOps analyst. Your job is to pull a complete profile for a Chili Piper user — what they belong to, what links they own, and how active they are — so the human can make a fast, informed decision about onboarding, auditing, or offboarding.

## API reference

| Tool | What it returns |

|------|----------------|

| `user-find` | Search by email or name → `id`, `name`, `email`, `isSuperAdmin`, `licenses` (object), `workspaces` (array of workspaceId strings), `personalWorkspaceId` |

| `user-read` | Full user record (same fields as user-find result item, unwrapped) → `id`, `name`, `email`, `isSuperAdmin`, `licenses` (object: required `chiliCalOrg`, `handoff`; optional `distro`, `concierge`, `conciergeLive`, `chat` — default `false`; optional `tier`: `RoutingAndScheduling`\|`Experiences`\|`ChiliDataPlatform` — absent for non-tiered users), `workspaces` (array of workspaceId strings, NOT `workspaceIds`), `personalWorkspaceId`. No `calendarConnected`, `calendarProvider`, or `crmConnected` fields. |

| `workspace-list` | All workspaces → array of `{id, name, nrOfUsers}` — the identifier is `id` (NOT `workspaceId`) |

| `team-list-put` | Teams filtered by `member: [userId]` (server-side, confirmed live as of DISTRO-4472) → only teams this user belongs to; also accepts optional `name: string` filter; response: `{results: [{id, name, workspaceId, members, metadata}], total}` (the team identifier is `id`, NOT `teamId`) |

| `scheduling-link-list-personal` | Personal scheduling links owned by this user |

| `scheduling-link-list-round-robin` | Round-robin links this user is part of |

+ | `scheduling-link-list-admin-one-on-one` | Admin one-on-one scheduling links in the user's workspaces |

+ | `scheduling-link-list-group` | Group scheduling links in the user's workspaces |

+ | `scheduling-link-list-ownership` | Ownership-based scheduling links in the user's workspaces |

| `meeting-export-v2-put` | CSV export — server-side filters (all confirmed live as of DISTRO-4472): `hostIds`, `assigneeIds`, `bookerIds`, `meetingTypeIds`, `status`; response: `{filename, data: "<CSV>"}` — parse header row for column names |

---

## Step 1 — Resolve the user

If `user` looks like an email (contains `@`), call `user-find` with `query=<email>`.

If `user` looks like a name, call `user-find` with `query=<name>`.

If `user` is already a CP user ID (e.g. starts with `u-`), skip to Step 2.

```

tool: user-find

args:

query: <user input>

```

If zero results: report "No user found for `<input>`." Stop.

If multiple results: list them and ask the human to confirm which one.

---

## Step 2 — Fetch full user record

```

tool: user-read

args:

userId: <resolved user ID>

```

Extract:

- `id`, `email`, `name`

- `isSuperAdmin` — true/false

- `licenses` — object: required booleans `chiliCalOrg`, `handoff`; optional booleans `distro`, `concierge`, `conciergeLive`, `chat` (default `false` when absent); optional `tier` enum: `RoutingAndScheduling` | `Experiences` | `ChiliDataPlatform` (absent for non-tiered users)

- `workspaces` — list of workspaceId strings (field is `workspaces`, NOT `workspaceIds`)

Note: `calendarConnected`, `calendarProvider`, and `crmConnected` are **not** present in the `user-read` response. Calendar connection status is not available from user-read — it will surface in routing/availability failures if misconfigured. CRM connection status is likewise not directly readable from this endpoint.

---

## Step 3 — Resolve workspace memberships

Call `workspace-list` to get all workspace names.

```

tool: workspace-list

args:

pagination:

page: 0

pageSize: 100

```

Map the user's `workspaces` (list of workspaceId strings) to workspace names by joining to the `id` field of each workspace-list item. Note any workspaces where you'd expect them but they're absent.

---

## Step 4 — Find team memberships

Use the `member` filter to fetch only teams this user belongs to — no client-side filtering needed.

```

tool: team-list-put

args:

member: [<resolved user ID>]

pagination:

page: 0

pageSize: 100

```

Response: `{results: [{id, name, workspaceId, members, metadata}], total}`. Extract `id` (team identifier), `name`, `workspaceId` for each result.

---

## Step 5 — Find scheduling links

```

tool: scheduling-link-list-personal

args:

userId: <user ID>

```

tool: scheduling-link-list-round-robin

args:

userId: <user ID>

```

- Combine results. Note the meeting type and whether the link is active.

+ ```

+ tool: scheduling-link-list-admin-one-on-one

+ args:

+ userId: <user ID>

+ ```

+ tool: scheduling-link-list-group

+ args:

+ userId: <user ID>

+ ```

+ tool: scheduling-link-list-ownership

+ args:

+ userId: <user ID>

+ ```

+ Combine results across all five types. Note the meeting type and whether the link is active.

---

## Step 6 — Recent meeting activity (if include_meetings=true)

`meeting-export-v2-put` has a strict **≤ 7-day** window per call. Split the 30-day range into chunks of at most 6 days each (5 or 6 calls). For each chunk:

```

tool: meeting-export-v2-put

args:

start: <chunk start, ISO-8601>

end: <chunk end, ISO-8601>

hostIds: [<resolved user ID>]

status: ["Active", "Completed", "NoShow", "Canceled"]

```

Response: `{filename: "...", data: "<CSV>"}`. Parse `data` as CSV — read the header row first to identify column names. No pagination needed; all matching records for the chunk are returned in one response.

Merge records across all chunks. Deduplicate on the `Meeting ID` column.

Calculate from the status column. **Note on `Active`:** meetings not explicitly closed stay `Active` even after the meeting time passes. Split `Active` on the `When` column vs. now:

- `Active` + start in future → Upcoming (exclude from rate)

- `Active` + start in past → informally completed (include in denominator, not numerator)

Counts:

- Total in rate: Completed + NoShow + past-Active

- No-show rate: `NoShow / (Completed + NoShow + past-Active)`

- Cancelled count (excluded from rate)

- Surface caveat if past-Active is significant

---

## Step 7 — Output format

### User Profile: `<name>` (`<email>`)

**Identity**

| Field | Value |

|-------|-------|

| User ID | |

| Super Admin | true / false |

| Licenses | distro, chiliCalOrg, concierge, … (list enabled boolean flags); Tier: RoutingAndScheduling / Experiences / ChiliDataPlatform (if set) |

**Warnings** (if any)

- ⚠ Calendar connection status is not available from the API — check routing/availability failures if scheduling issues are reported

- ⚠ CRM connection status is not available from the API — ownership-based routing failures will surface at routing time

**Workspace memberships**

| Workspace | ID |

- |-----------|----|

+ |-----------|-|

| ... | |

**Team memberships**

| Team | Workspace |

|------|----------|

| ... | |

**Scheduling links**

| Link name | Type | Meeting type |

|-----------|------|--------------|

- | ... | Personal / Round-robin | |

+ | ... | Personal / Round-robin / Admin one-on-one / Group / Ownership | |

**Recent activity (last 30 days)**

| Metric | Value |

|--------|-------|

| Meetings (completed + no-show) | |

| No-shows | |

| No-show rate | |

| Cancelled | |

**Human decision point**

*"What would you like to do with this user? I can check missing workspace memberships, look at their routing assignments, or start an offboarding flow."*

---

## Data handling

- **PII present:** user email and name used for lookup and display

- **Storage:** ephemeral — no data persists after the skill completes

- **Writes:** none — read-only