Worked request and response samples for global search and Intercom
The global search reference now shows a fully populated response — per-pillar hits with stable ids and dashboard links, per-pillar counts, and partial-failure hints — alongside a scoped two-pillar round trip and its error envelopes, and the integrations reference walks the Intercom OAuth connect through the read-back and re-pull calls.
The global search API reference previously sketched the response envelope without a populated example, so there was no shape to code a palette or telemetry integration against. The page now opens with a complete round trip: a scoped two-pillar query and the 200 it returns, with results[] and by_pillar entries carrying id, title, href, and score, the per-pillar counts, and the partial array a client renders as a discreet per-pillar failure hint. A short note explains static_match_count — send the number of client-side shortcuts you rendered so a query that matched only static entries is never recorded as zero-result.
The integrations reference gains the Intercom connect flow on the same worked-sample pattern: start the OAuth install, hand the authorization URL to a workspace admin, read back the connected workspace and its subscribed topics, then confirm freshness with the status read-back and force a re-pull after a large import.