Dated Persona API Version Migration

Overview

Treat Persona-Version as a contract migration. Because the request header overrides the key’s configured version and compatible releases can add or reorder data, migrate parsers, webhook handling, and operational evidence together.

Prerequisites

• Source and target dated API versions
• Endpoint, resource, event, and consumer inventory
• Representative redacted fixtures plus a reversible rollout mechanism

Instructions

Step 1: Freeze the baseline

Record API-key configured versions, explicit headers, endpoints, templates, response hashes, events, dashboards, and consumer assumptions.

Step 2: Read the provider delta