Skribby

POST/recording

https://platform.skribby.io/api/v1/recording

Upload and transcribe a recording file or re-transcribe an existing meeting bot recording. You have three options: 1. **Upload a file directly** - Provide `recording_file` and `transcription_model` 2. **Provide a URL** - Provide `recording_url` and `transcription_model` 3. **Re-transcribe from meeting bot** - Provide `meeting_bot_id` (optionally override transcription parameters) When using `meeting_bot_id`, the recording and default transcription settings will be copied from the specified meeting bot. You can override `transcription_model`, `lang`, `profanity_filter`, and `custom_vocabulary` parameters if needed.

Request Body

required

application/json

Responses

Returns Recording

idstring<uuid>

Unique recording identifier

statusstring

Current status of the recording

Allowed values:

transcribingfinishedfailed

webhook_urlstring<uri> | null

Webhook URL for receiving status updates. Refer to the Webhooks section for details on webhook format and available events.

recording_urlstring<uri> | null

URL to the original recording file

recording_available_untilstring<date-time> | null

When the recording will be deleted

langstring | null

Language specified when creating the recording

detected_langstring | null

Language detected from the audio

transcriptTranscriptSegment[]

Transcript segments

transcription_modelstring

Model used for transcription

eventsEvent[]

List of processing events

profanity_filterboolean

Whether profanity filter was enabled

custom_vocabularystring[]

Words or phrases provided when creating meeting bot for transcription model

created_atstring<date-time>

When the recording was uploaded

Request

curl -X POST \
  "https://platform.skribby.io/api/v1/recording" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transcription_model": "whisper",
    "recording_url": "https://example.com",
    "meeting_bot_id": "123e4567-e89b-12d3-a456-426614174000",
    "lang": "en",
    "webhook_url": "https://example.com",
    "store_recording_for_1_year": false,
    "profanity_filter": false,
    "custom_vocabulary": [
      "string"
    ]
  }'

Response

200 OKapplication/json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "transcribing",
  "webhook_url": null,
  "recording_url": null,
  "recording_available_until": null,
  "lang": null,
  "detected_lang": null,
  "transcript": [
    {
      "start": 4,
      "end": 5.62,
      "speaker": 0,
      "speaker_name": "John Doe",
      "potential_speaker_names": null,
      "confidence": 0.9980372,
      "transcript": "This is a quick test.",
      "utterances": [
        null
      ]
    }
  ]
}