Common Room Integration (Community)

Use the shared provider API actions

Common Room has no provider-specific action, route, or server client in Analytics. Use the shared provider API substrate:

• provider-api-catalog with provider: "commonroom" to inspect the registered base URL, authentication, official docs, and examples.
• provider-api-docs before relying on a remembered endpoint, filter, or pagination shape.
• provider-api-request for the authenticated request. The server injects COMMONROOM_API_TOKEN as a bearer token; never pass it in action arguments.

For broad member or activity pulls, pass stageAs and the documented pagination settings, then use query-staged-dataset to search or aggregate the complete staged cohort.

Example workflow

pnpm action provider-api-catalog --provider=commonroom
pnpm action provider-api-docs --provider=commonroom
pnpm action provider-api-request --provider=commonroom --method=GET --path=/members

Key Patterns & Gotchas

• Verify member-search, activity, and segment endpoints in provider-api-docs; do not rely on the removed bespoke client's assumptions.
• Report the method, path, filters, returned row count, and pagination coverage.
• Use raw activity/member evidence for exhaustive or absence-sensitive claims.