name: persona-upgrade-migration description: 'Upgrade Persona API versions and handle breaking changes.

Use when working with Persona identity verification.

Trigger with phrases like "persona upgrade-migration", "persona upgrade-migration".

' allowed-tools: Read, Write, Edit, Bash(npm:), Bash(git:) version: 2.0.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io tags:

• saas
• persona
• identity
• kyc
• verification compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw

persona upgrade migration | sed 's/\b(.)/\u\1/g'

Overview

API versioning via Persona-Version header, deprecated field migration, test against sandbox.

Prerequisites

• Completed persona-install-auth setup
• Valid Persona API key (sandbox or production)

Instructions

Step 1: Implementation

import os, requests

HEADERS = {
    "Authorization": f"Bearer {os.environ['PERSONA_API_KEY']}",
    "Persona-Version": "2023-01-05",
}
BASE = "https://withpersona.com/api/v1"

# Upgrade Persona API versions and handle breaking changes
resp = requests.get(f"{BASE}/inquiries?page[size]=10", headers=HEADERS)
resp.raise_for_status()
inquiries = resp.json()["data"]
for inq in inquiries:
    print(f"  {inq['id']}: {inq['attributes']['status']}")

Output

• API versioning via Persona-Version header, deprecated field migration, test against sandbox.

Error Handling

Resources

• Persona API Reference
• Persona Documentation

Next Steps

See related Persona skills for more workflows.