Skip to main content
POST
/
v1
/
analyses
Submit a recording for analysis
curl --request POST \
  --url http://localhost:3000/v1/analyses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "org_id": "<string>",
  "rep_id": "<string>",
  "recording_url": "<string>",
  "transcript_url": "<string>",
  "callback_url": "<string>",
  "options": {
    "persona_id": 123,
    "methodology_id": 123,
    "playbook_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "scoring_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "prompt_overrides": [
      {
        "title": "<string>",
        "content": "<string>"
      }
    ],
    "language": "<string>",
    "skip_diarization": true,
    "recording_type": "<string>",
    "environment": "<string>",
    "sales_motion": "<string>"
  },
  "metadata": {}
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
org_id
string
required

Opaque identifier from your system. Treat this like a foreign key — pass a stable ID (Salesforce User ID, HubSpot Owner ID, your internal UUID), not a display name. Display names ("alex", "brooke") work but cause real problems: collisions between people with the same first name, history loss on rename, no clean migration if employment changes. Once you set this for a rep or org, treat it as immutable. Charset: [A-Za-z0-9._:-], 1-256 chars.

Required string length: 1 - 256
Pattern: ^[A-Za-z0-9._:-]+$
​
rep_id
string
required

Opaque identifier from your system. Treat this like a foreign key — pass a stable ID (Salesforce User ID, HubSpot Owner ID, your internal UUID), not a display name. Display names ("alex", "brooke") work but cause real problems: collisions between people with the same first name, history loss on rename, no clean migration if employment changes. Once you set this for a rep or org, treat it as immutable. Charset: [A-Za-z0-9._:-], 1-256 chars.

Required string length: 1 - 256
Pattern: ^[A-Za-z0-9._:-]+$
​
recording_url
string<uri>
​
transcript_url
string<uri>
​
callback_url
string<uri>
​
options
object
​
metadata
object

Response

202 - application/json

Default Response

​
id
string<uuid>
required
​
status
enum<string>
required
Available options:
queued,
processing,
completed,
failed,
cancelled
​
created_at
string
required