Call recordings

Start a recording upload

Opens a recording for audio captured on the phone and returns a token; send the audio in parts with /calls/{token}/chunk, then /finish starts transcription.

POST/api/v1/calls/record

Authorization

Authorizationheaderrequired

Bearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).

Module: callsScope: crm.write

Body application/json

kindstringoptionaldefault: inperson

Conversation type.

Valuesinpersonphoneupload

mimestringoptionaldefault: audio/mp4

Audio type.

titlestringoptional

Title.

customer_id / opp_id / event_idintegeroptional

Records to link.

Errors

HTTP	error	Meaning
`403`	`module`	The module is off in the licence or for the user.
`400`	`invalid`	Missing or invalid field (`message` explains).

Request

curl -X POST https://ornek.solk.app/api/v1/calls/record \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/calls/record", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/calls/record",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())

Response