# Parlay

> Sales-call intelligence API. Submit recordings, get AI scoring, coaching feedback, and rep-level intelligence. REST + MCP.

## Docs

- [Archive a session (soft delete — child analyses remain queryable)](https://docs.goparlay.io/api-reference/all-day-sessions/archive-a-session-soft-delete-—-child-analyses-remain-queryable.md)
- [Fetch a session with all detected segments](https://docs.goparlay.io/api-reference/all-day-sessions/fetch-a-session-with-all-detected-segments.md)
- [List all-day sessions for the partner](https://docs.goparlay.io/api-reference/all-day-sessions/list-all-day-sessions-for-the-partner.md)
- [Manually trigger V5 analysis on a detected segment](https://docs.goparlay.io/api-reference/all-day-sessions/manually-trigger-v5-analysis-on-a-detected-segment.md): Only needed when the session was submitted with `options.auto_analyze=false` or when a segment was sent to needs_review (confidence between 0.5 and the min_confidence threshold). The analysis runs asynchronously; poll GET /v1/analyses/:id once the segment row reports `status=analyzed`.
- [Submit a long-form recording for boundary detection + per-segment analysis](https://docs.goparlay.io/api-reference/all-day-sessions/submit-a-long-form-recording-for-boundary-detection-+-per-segment-analysis.md): Upload one HTTPS URL of a multi-hour recording. The server detects conversation boundaries (single-shot Gemini), then auto-analyzes each high-confidence segment with the V5 master prompt. Each segment becomes a first-class Analysis row with `parent_session_id` set, queryable via the existing `/v1/an…
- [Fetch an analysis](https://docs.goparlay.io/api-reference/analyses/fetch-an-analysis.md): Returns the full analysis row. When `status === "completed"` the `analysis` field is populated with the canonical six-pillar shape (clarity / influence / objection / discovery / delivery / close), each pillar exposed as a flat `*_score` field plus `feedback_v5.<pillar>.{positive, negative}` and `act…
- [List analyses](https://docs.goparlay.io/api-reference/analyses/list-analyses.md)
- [Rescore an analysis (Phase 1.B)](https://docs.goparlay.io/api-reference/analyses/rescore-an-analysis-phase-1b.md)
- [Soft-delete an analysis](https://docs.goparlay.io/api-reference/analyses/soft-delete-an-analysis.md)
- [Submit a recording for analysis](https://docs.goparlay.io/api-reference/analyses/submit-a-recording-for-analysis.md): Returns 202 with a job handle. Completion is delivered via webhook (see /v1/webhooks) or via polling GET /v1/analyses/:id. In sandbox, use `mock://perfect-pitch` etc. for deterministic results.
- [4 AI-generated starter questions tailored to this call](https://docs.goparlay.io/api-reference/chat/4-ai-generated-starter-questions-tailored-to-this-call.md)
- [Ask Scout a question about this analysis](https://docs.goparlay.io/api-reference/chat/ask-scout-a-question-about-this-analysis.md): Returns the full response (non-streaming). SSE streaming variant lands in Phase 5.B. Chat history is persisted per-analysis; pass /chat repeatedly to maintain conversation.
- [Clear chat history for this analysis](https://docs.goparlay.io/api-reference/chat/clear-chat-history-for-this-analysis.md)
- [Full chat history for this analysis](https://docs.goparlay.io/api-reference/chat/full-chat-history-for-this-analysis.md)
- [Clear a disposition](https://docs.goparlay.io/api-reference/dispositions/clear-a-disposition.md)
- [Fetch the disposition for an analysis](https://docs.goparlay.io/api-reference/dispositions/fetch-the-disposition-for-an-analysis.md)
- [List dispositions for an org](https://docs.goparlay.io/api-reference/dispositions/list-dispositions-for-an-org.md)
- [Tag a disposition on an analysis (upsert)](https://docs.goparlay.io/api-reference/dispositions/tag-a-disposition-on-an-analysis-upsert.md)
- [Update a disposition](https://docs.goparlay.io/api-reference/dispositions/update-a-disposition.md)
- [Get ](https://docs.goparlay.io/api-reference/get-.md)
- [API version + build info](https://docs.goparlay.io/api-reference/health/api-version-+-build-info.md)
- [Health check (public)](https://docs.goparlay.io/api-reference/health/health-check-public.md): Liveness probe. Returns ok / degraded / down + uptime.
- [Public service status](https://docs.goparlay.io/api-reference/health/public-service-status.md): Per-provider health and queue depth. Safe for public status pages.
- [Fetch the most recent insights snapshot](https://docs.goparlay.io/api-reference/insights/fetch-the-most-recent-insights-snapshot.md)
- [Generate an org insights snapshot (async)](https://docs.goparlay.io/api-reference/insights/generate-an-org-insights-snapshot-async.md): Aggregates the org's completed analyses in the supplied window (default last 30 days), runs a Gemini meta-analysis, and persists an insights_snapshots row. 202 + job_id. Webhook: insights.generated.
- [List insight snapshots over time](https://docs.goparlay.io/api-reference/insights/list-insight-snapshots-over-time.md)
- [Rank reps in an org](https://docs.goparlay.io/api-reference/insights/rank-reps-in-an-org.md): Pure SQL aggregate. sort_by: score (overall_avg desc), volume (analyses_count desc), improvement (first-half vs second-half delta). No AI, no cost.
- [API reference](https://docs.goparlay.io/api-reference/introduction.md): Every endpoint, request schema, response shape, and live try-it panel — auto-generated from the OpenAPI spec.
- [Introspect the current API key](https://docs.goparlay.io/api-reference/keys/introspect-the-current-api-key.md)
- [Revoke the current key immediately](https://docs.goparlay.io/api-reference/keys/revoke-the-current-key-immediately.md)
- [Rotate the current key](https://docs.goparlay.io/api-reference/keys/rotate-the-current-key.md): Mints a new key with identical scopes + environment. Current key stays valid for 24h, then auto-revokes.
- [Async primary + secondary methodology assignment from recordings](https://docs.goparlay.io/api-reference/methodologies/async-primary-+-secondary-methodology-assignment-from-recordings.md)
- [Current methodology assignments (primary + secondary)](https://docs.goparlay.io/api-reference/methodologies/current-methodology-assignments-primary-+-secondary.md)
- [List sales methodologies](https://docs.goparlay.io/api-reference/methodologies/list-sales-methodologies.md)
- [Manually set rep methodologies](https://docs.goparlay.io/api-reference/methodologies/manually-set-rep-methodologies.md)
- [Methodology assignment history](https://docs.goparlay.io/api-reference/methodologies/methodology-assignment-history.md)
- [Create (or upsert) an org](https://docs.goparlay.io/api-reference/orgs/create-or-upsert-an-org.md)
- [Fetch an org](https://docs.goparlay.io/api-reference/orgs/fetch-an-org.md)
- [List orgs](https://docs.goparlay.io/api-reference/orgs/list-orgs.md)
- [Soft-delete an org](https://docs.goparlay.io/api-reference/orgs/soft-delete-an-org.md)
- [Update an org](https://docs.goparlay.io/api-reference/orgs/update-an-org.md)
- [Async persona assignment from recordings](https://docs.goparlay.io/api-reference/personas/async-persona-assignment-from-recordings.md): Submit N recording_urls OR N analysis_ids. We run each through the pipeline (cached 30 days by URL), then meta-analyze to determine the rep's persona. 202 + job_id returned; final result delivered via persona.assigned webhook or polled via GET /v1/orgs/:org_id/reps/:rep_id/intel-jobs/:job_id.
- [Current persona assignment](https://docs.goparlay.io/api-reference/personas/current-persona-assignment.md)
- [List sales personas](https://docs.goparlay.io/api-reference/personas/list-sales-personas.md)
- [Manually set a rep persona](https://docs.goparlay.io/api-reference/personas/manually-set-a-rep-persona.md)
- [Persona assignment history](https://docs.goparlay.io/api-reference/personas/persona-assignment-history.md)
- [Poll a rep-intelligence batch job](https://docs.goparlay.io/api-reference/personas/poll-a-rep-intelligence-batch-job.md)
- [Create a playbook (org-level or per-rep override)](https://docs.goparlay.io/api-reference/playbooks/create-a-playbook-org-level-or-per-rep-override.md): Create a sales playbook. Polymorphic scope: omit `rep_id` to create an **org-level** playbook (every rep in the org uses it as the baseline at analysis time, when `is_active=true`). Pass `rep_id` to create a **rep-level** playbook (overrides the org playbook for that rep only).
- [Fetch a draft (poll for completion)](https://docs.goparlay.io/api-reference/playbooks/fetch-a-draft-poll-for-completion.md)
- [Fetch a playbook](https://docs.goparlay.io/api-reference/playbooks/fetch-a-playbook.md)
- [Fetch a source material](https://docs.goparlay.io/api-reference/playbooks/fetch-a-source-material.md)
- [Generate a playbook draft from source materials (async)](https://docs.goparlay.io/api-reference/playbooks/generate-a-playbook-draft-from-source-materials-async.md): Queues a Gemini job that synthesizes the supplied source materials into a markdown playbook. 202 + draft_id returned; completion delivered via playbook.draft.completed webhook and polling GET /playbook-drafts/:id.
- [List playbook drafts](https://docs.goparlay.io/api-reference/playbooks/list-playbook-drafts.md)
- [List playbooks (org-level + per-rep, with filters)](https://docs.goparlay.io/api-reference/playbooks/list-playbooks-org-level-+-per-rep-with-filters.md): List playbooks belonging to an org, newest first. Returns both org-level and rep-level playbooks by default. Filters:
- [List source materials](https://docs.goparlay.io/api-reference/playbooks/list-source-materials.md)
- [Publish a completed draft as the active playbook](https://docs.goparlay.io/api-reference/playbooks/publish-a-completed-draft-as-the-active-playbook.md): Inserts the draft's generated_content into playbooks (version 1, is_active=true) and marks the draft published_at.
- [Soft-delete a playbook](https://docs.goparlay.io/api-reference/playbooks/soft-delete-a-playbook.md)
- [Soft-delete a source material](https://docs.goparlay.io/api-reference/playbooks/soft-delete-a-source-material.md)
- [Update a playbook (bumps version on content change)](https://docs.goparlay.io/api-reference/playbooks/update-a-playbook-bumps-version-on-content-change.md): If `content` changes, the prior version is appended to playbook_versions and version increments.
- [Upload a playbook source material](https://docs.goparlay.io/api-reference/playbooks/upload-a-playbook-source-material.md)
- [Version history](https://docs.goparlay.io/api-reference/playbooks/version-history.md)
- [Bulk reorder custom prompts](https://docs.goparlay.io/api-reference/prompts/bulk-reorder-custom-prompts.md): Body: {ids: [...]} — new order_index is the position in the array. Atomic.
- [Create a custom prompt](https://docs.goparlay.io/api-reference/prompts/create-a-custom-prompt.md)
- [Fetch a prompt](https://docs.goparlay.io/api-reference/prompts/fetch-a-prompt.md)
- [List custom prompts (ordered)](https://docs.goparlay.io/api-reference/prompts/list-custom-prompts-ordered.md)
- [Soft-delete a prompt](https://docs.goparlay.io/api-reference/prompts/soft-delete-a-prompt.md)
- [Update a custom prompt](https://docs.goparlay.io/api-reference/prompts/update-a-custom-prompt.md)
- [List environments](https://docs.goparlay.io/api-reference/reference/list-environments.md)
- [List industries](https://docs.goparlay.io/api-reference/reference/list-industries.md)
- [List recording types](https://docs.goparlay.io/api-reference/reference/list-recording-types.md)
- [List sales motions](https://docs.goparlay.io/api-reference/reference/list-sales-motions.md)
- [Create (or upsert) a rep](https://docs.goparlay.io/api-reference/reps/create-or-upsert-a-rep.md)
- [Fetch a rep](https://docs.goparlay.io/api-reference/reps/fetch-a-rep.md)
- [List reps in an org](https://docs.goparlay.io/api-reference/reps/list-reps-in-an-org.md)
- [Rep score aggregates and trend](https://docs.goparlay.io/api-reference/reps/rep-score-aggregates-and-trend.md)
- [Soft-delete a rep](https://docs.goparlay.io/api-reference/reps/soft-delete-a-rep.md)
- [Update a rep](https://docs.goparlay.io/api-reference/reps/update-a-rep.md)
- [Generate a strategic coaching synthesis for this rep](https://docs.goparlay.io/api-reference/synthesis/generate-a-strategic-coaching-synthesis-for-this-rep.md): Rolls up the rep's most recent completed analyses (or explicit analysis_ids) into a coaching summary with strengths, gaps, action plan, and score trends. 202 + job_id. Result delivered via profile.synthesized webhook.
- [Latest synthesis for a rep](https://docs.goparlay.io/api-reference/synthesis/latest-synthesis-for-a-rep.md)
- [Synthesis history](https://docs.goparlay.io/api-reference/synthesis/synthesis-history.md)
- [Delete a webhook (soft)](https://docs.goparlay.io/api-reference/webhooks/delete-a-webhook-soft.md)
- [Fetch a single delivery with payload + response](https://docs.goparlay.io/api-reference/webhooks/fetch-a-single-delivery-with-payload-+-response.md)
- [Fetch a webhook](https://docs.goparlay.io/api-reference/webhooks/fetch-a-webhook.md)
- [List deliveries for a webhook](https://docs.goparlay.io/api-reference/webhooks/list-deliveries-for-a-webhook.md)
- [List webhooks](https://docs.goparlay.io/api-reference/webhooks/list-webhooks.md)
- [Register a webhook](https://docs.goparlay.io/api-reference/webhooks/register-a-webhook.md): signing_secret is returned exactly once — store it immediately.
- [Replay a delivery (Phase 9)](https://docs.goparlay.io/api-reference/webhooks/replay-a-delivery-phase-9.md)
- [Send a webhook.test event to the registered URL](https://docs.goparlay.io/api-reference/webhooks/send-a-webhooktest-event-to-the-registered-url.md)
- [Stripe webhook receiver (HMAC-verified)](https://docs.goparlay.io/api-reference/webhooks/stripe-webhook-receiver-hmac-verified.md)
- [Update a webhook](https://docs.goparlay.io/api-reference/webhooks/update-a-webhook.md): Pass rotate_secret=true to regenerate the signing secret — it is returned in the response exactly once.
- [Authentication](https://docs.goparlay.io/authentication.md): Bearer tokens, sandbox vs live, and idempotency.
- [Errors](https://docs.goparlay.io/errors.md): Stable error codes, status codes, and what to do about each.
- [AI playbook drafting](https://docs.goparlay.io/guides/ai-playbook-drafting.md): Turn raw call notes and methodology docs into a publishable playbook in ~20 seconds.
- [All-day sessions](https://docs.goparlay.io/guides/all-day-sessions.md): Submit one long-form recording — get back N scored conversations. Boundary detection + per-segment V5 analysis in a single API call.
- [Submit your first analysis](https://docs.goparlay.io/guides/first-analysis.md): Mock fixture → poll → real audio. Ten minutes start to finish.
- [Rep intelligence](https://docs.goparlay.io/guides/rep-intelligence.md): Persona, methodology, and coaching synthesis — async, batched, and queryable.
- [Webhooks](https://docs.goparlay.io/guides/webhooks.md): Stop polling. Get notified when analyses complete, drafts finish, and personas get assigned.
- [Sales-call intelligence as an API](https://docs.goparlay.io/introduction.md): Submit a recording. Get back 6-pillar AI scoring, coaching feedback, action plans, and rep-level intelligence — typically in 30 to 90 seconds.
- [Examples](https://docs.goparlay.io/mcp/examples.md): Paste-ready prompts that demonstrate real Parlay workflows.
- [Install the MCP server](https://docs.goparlay.io/mcp/installation.md): Connect Parlay to Claude Desktop, Cursor, Windsurf, Continue, Zed, Claude Code, or any custom MCP client.
- [MCP server overview](https://docs.goparlay.io/mcp/overview.md): Why MCP, when to use it instead of REST, and what tools you get.
- [Tool catalog](https://docs.goparlay.io/mcp/tool-catalog.md): All 50 MCP tools grouped by domain, with cost and latency callouts.
- [Quickstart](https://docs.goparlay.io/quickstart.md): Submit your first analysis in 5 minutes — REST or MCP, your pick.

## OpenAPI Specs

- [json](https://api.goparlay.io/docs/json)
- [openapi](https://docs.goparlay.io/api-reference/openapi.json)