API concepts
Changelog
A dated list of the changes to the schema and the behavior of the Prescient GraphQL API, with the newest change first.
This page lists each change to the Prescient GraphQL API that can affect an integration. The newest change is first. The API has one version, and the endpoint has no version number.
2026-09-29
Section titled “2026-09-29”- Fixed: A key with a channel scope now returns the rows of each data source of its channels. Before this fix, some channels returned no rows in
modeledMetricsandreportedMetricsfor a scoped key. A key with no channel scope did not change. - Changed:
channelNamesnow follows the channel scope of the key. A scoped key gets only the channels that it can read. A key with no channel scope did not change.
2026-09-23
Section titled “2026-09-23”- Added: The
sourceCampaignTacticfield onModeledMetricRow. The field is the tactic that the campaign has in the Data Center, ornullif the campaign has no tactic. A query that does not select the field did not change.
2026-07-27
Section titled “2026-07-27”- Changed: The API moved to a new platform. The endpoint, the request, the schema, the pagination, and the shape of an error did not change, so no integration needs a code change.
- Changed: Repeated authentication failures from one IP address now cause a temporary block. See Limits.
- Changed:
modelsandchannelNamesnow return their items in a stable sorted order. The order was never part of the schema, so treat both lists as lists with no order.
2026-06-01
Section titled “2026-06-01”- Added: Channel scope for API keys. A scoped key reads only its channels in
modeledMetricsandreportedMetrics. See Authentication. - Changed: The
salesChannelargument ofmodeledMetricsis now a list. If you leave it out, the query returns bothECOMMERCEandRETAIL. Before this change, the default wasECOMMERCEonly.
2026-05-26
Section titled “2026-05-26”- Added: The
RETAILvalue ofSalesChannelEnum, somodeledMetricscan return retail metrics.
2026-04-24
Section titled “2026-04-24”- Added: More than one API key for a workspace. Each key has a name.
- Added: An expiration date and a revoke action for a key, and a record of the last use of a key. The API rejects an expired key and a revoked key.
2026-04-23
Section titled “2026-04-23”- Added: Subscription metrics in
modeledMetrics, for a model that measures subscriptions.
2026-03-03
Section titled “2026-03-03”- Added: The
reportedMetricsquery, with theReportedMetricQueryandReportedMetricRowtypes.
2025-05-07
Section titled “2025-05-07”- Added: The first release of the API, as a beta.