Skip to main content
The reference pages on this tab are auto-generated from the live OpenAPI spec at /docs/json. They stay in sync with the deployed API automatically — no manual maintenance.

​
Base URL

EnvironmentURL
Sandboxhttps://parlay-api-dev-o7nogixtqq-uc.a.run.app
Liveannounced at production launch

​
Conventions

  • Every endpoint expects Authorization: Bearer <key>. See authentication.
  • Mutating endpoints (POST, PATCH, PUT, DELETE) expect Idempotency-Key: <uuid>.
  • Times are ISO-8601 with timezone (2026-04-24T18:53:17.867123+00:00).
  • All ids are either UUIDs (analysis_id, playbook_id, etc.) or partner-supplied opaque strings (org_id, rep_id).
  • All collection endpoints are cursor-paginated. The response includes { data, has_more, next_cursor }.

​
Try it

Each reference page has a live request panel in the right column. Paste your sandbox key, fill in any params, hit “Send”. The request goes against parlay-api-dev-o7nogixtqq-uc.a.run.app and returns real responses.

​
Endpoint groups

Analyses

Submit recordings, fetch results, list, archive

Orgs & Reps

Partner-supplied identity for everything else

Rep intelligence

Persona, methodology, synthesis (async)

Scout chat

Multi-turn coaching chat per analysis

Playbooks

Manual + AI-drafted, versioned

Custom prompts

Org-level scoring criteria

Dispositions

Tag call outcomes for win/loss analysis

Webhooks

Stop polling — register callbacks

Reference data

Personas, methodologies, industries, environments

​
Status, versioning, deprecation

  • Versioning: the API path is /v1/*. Breaking changes ship at /v2/* with a 12-month parallel-support window. Non-breaking additions land in /v1/* continuously.
  • Status: parlay-api-dev-o7nogixtqq-uc.a.run.app/v1/status (always-on health page).
  • Deprecation: any endpoint slated for removal returns a Deprecation header with the sunset date 6+ months in advance.

​
Help

Stuck on an integration? Email integrations@goparlay.io with the request_id from the failing response (every error envelope contains one).