Quickstart

This is the REST API quickstart. You'll need an API key and a project ID from the Persona team. To use Persona from Claude or Codex without an API key, follow the Persona MCP guide.

Fetch completed interviews

GET /v1/projects/<project_id>/interviews

curl "https://external-api.prod.insightscompany.io/v1/projects/<project_id>/interviews?limit=5" \
-H "x-api-key: <api_key>"

See Interviews for the full parameter and response reference.

Receive webhooks (recommended)

Rather than polling, register a webhook URL with the Persona team and we'll push a signed event to your server the moment each interview completes.

{
  "event": "interview_completed",
  "created_at": "2026-07-10T12:00:00Z",
  "data": {
    "org_id": "80a39f70-...",
    "project_id": "abc123-...",
    "interview_id": "f3a1b2c4-...",
    "user_interview_id": "e5d6c7b8-...",
    "video_url": "https://storage.persona.ai/recordings/e5d6c7b8-....mp4",
    "video_url_expires_at": "2026-07-11T12:00:00Z",
    "completed_at": "2026-07-10T12:00:00Z",
    "completed_participants": 42
  }
}

See Webhooks for signature verification, event reference, and retry behaviour.

Next steps

Interviews

Full parameter and response reference.

Webhooks

Events, payload reference, and verification.

Reports

AI-generated analysis across all interviews.