[mike-engel]

Cross-verified all App API methods against the backends after we found the published OpenAPI spec drifts from the actual handlers. This fixes the SDK params that don't match reality, and the spec will be fixed separately internally.

None of these methods shipped in v5.1.0: they're all in unreleased batches, so there's no released-user impact.

Fixes

Method	Fix	Backend evidence
getCampaignJourneyMetrics	send resolution (not res)	back end reads resolution — previously 400'd every call
getCampaignActionMetrics, getBroadcastActionMetrics	drop type	back end hardcodes all channels
getCampaignActionMetricsLinks, getBroadcastActionMetricsLinks	type → unique	back end reads unique
getBroadcastMessages, getTransactionalMessageDeliveries	drop state	back end never reads state
getCampaignMetrics, getCampaignActionMetrics	version moved into options + made optional	server defaults it; never required
downloadExport	doc: returns { url } not { link }

Type changes

• Added MetricsWindowOptions (base window) and CampaignActionMetricsOptions (campaign action metrics, no type).
• Removed the now-unused DeliveryState.
• getCampaignMetrics(campaignId, options) / getCampaignActionMetrics(campaignId, actionId, options) — version is now an optional field in options rather than a required positional arg.

Assisted by AI 🤖

---

Note

Medium Risk
Breaking signature and query-param changes across many client methods, but PR states these APIs were not yet released; fixes include a journey-metrics bug that caused 400s.

Overview
Aligns unreleased App API client methods with what the backend actually accepts, after audit against real handlers (not the drifting OpenAPI spec).

Query string fixes: getCampaignJourneyMetrics now sends resolution instead of res (previously broke every call). Campaign/broadcast action link metrics send unique instead of type. Action-level metrics no longer send type (all-channel aggregation). Transactional/broadcast message listings no longer send unsupported state.

Signatures & types: getCampaignMetrics and getCampaignActionMetrics drop the required positional version arg; version is optional inside options. Adds MetricsWindowOptions / CampaignActionMetricsOptions, removes DeliveryState. downloadExport JSDoc corrected to { url }.

Docs & tests: docs/app.md, unit tests, and live integration call sites updated to match.

^{Reviewed by Cursor Bugbot for commit ac5f661. Bugbot is set up for automated code reviews on this repo. Configure here.}