Prescient AI API changelog

All notable changes to the Prescient AI GraphQL API will be documented in this file. The format is based on Keep a Changelog.

2026-06-01

Channel-scoped API tokens: Tokens can be restricted to a subset of marketing channels via an api_token_channels join. Scoped tokens see only campaigns, modeled metrics, and reported metrics for their assigned channels in the GraphQL modeledMetrics and reportedMetrics resolvers; unscoped tokens retain full company-wide access. Channel assignments are managed through the API token management UI.

modeledMetrics salesChannel now accepts multiple values and defaults to both channels: The salesChannel argument is now a list ([SalesChannelEnum!]). When omitted it returns both ECOMMERCE and RETAIL metrics (previously defaulted to ECOMMERCE only). Pass one or more enum values to filter (e.g. salesChannel: [RETAIL]).

Retail support in modeledMetrics: Adds RETAIL to the SalesChannelEnum so retail metrics can be queried alongside e-commerce.

Multiple API tokens per company: Companies can now provision and manage multiple named API tokens instead of a single shared token. Existing tokens are preserved and migrated to a Default named token.
Token lifecycle and last-used auditing: API tokens now track last_used_at, expires_at, and revoked_at. Expired and revoked tokens are rejected at authentication; last_used_at is updated on successful GraphQL requests for usage auditing.

Subscription model target support: Modeled metric output now supports subscription-style model targets (e.g. recurring revenue) in addition to one-time revenue. CSV column ids and targets are derived from the model target types so subscription customers see metrics tailored to their target type.

New reportedMetrics query field: Returns spend metrics per campaign/day from marketing channels.
- Supports filtering by: startDate, endDate, campaignIds, processDate
- Includes offset-based pagination with after argument (BigInt cursor)
- Returns spend data with optional campaign name lookup
- Implements same rate limiting patterns as modeledMetrics
New types: ReportedMetricQuery, ReportedMetricRow