Initiate session audio upload

POST/v1/event/{eventId}/sessions/{sessionId}/recordings

US Region: https://public-api.sessionboard.com · EU Region: https://public-api-eu.sessionboard.com

Returns a presigned upload URL for the audio file. Requires write:transcriptions.

Request example

cURL

curl --request POST \
  --url 'https://public-api.sessionboard.com/v1/event/{eventId}/sessions/{sessionId}/recordings' \
  --header 'x-access-token: <api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "filename": "<string>",
  "content_type": "<string>",
  "size_bytes": 123
}'

JavaScript

const response = await fetch('https://public-api.sessionboard.com/v1/event/{eventId}/sessions/{sessionId}/recordings', {
  method: 'POST',
  headers: {
    "x-access-token": "<api-token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "filename": "<string>",
    "content_type": "<string>",
    "size_bytes": 123
  }),
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "POST",
    "https://public-api.sessionboard.com/v1/event/{eventId}/sessions/{sessionId}/recordings",
    headers={
        "x-access-token": "<api-token>",
        "Content-Type": "application/json"
    },
    json={
        "filename": "<string>",
        "content_type": "<string>",
        "size_bytes": 123
    },
)

print(response.json())

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://public-api.sessionboard.com/v1/event/{eventId}/sessions/{sessionId}/recordings",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => '{
  "filename": "<string>",
  "content_type": "<string>",
  "size_bytes": 123
}',
    CURLOPT_HTTPHEADER => [
        "x-access-token: <api-token>",
        "Content-Type: application/json",
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "strings"
)

func main() {
  req, _ := http.NewRequest("POST", "https://public-api.sessionboard.com/v1/event/{eventId}/sessions/{sessionId}/recordings", strings.NewReader(`{
  "filename": "<string>",
  "content_type": "<string>",
  "size_bytes": 123
}`))
  req.Header.Add("x-access-token", "<api-token>")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(string(body))
}

Java

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://public-api.sessionboard.com/v1/event/{eventId}/sessions/{sessionId}/recordings"))
    .header("x-access-token", "<api-token>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\n  \"filename\": \"<string>\",\n  \"content_type\": \"<string>\",\n  \"size_bytes\": 123\n}"))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

Try it

RegionUS Region — https://public-api.sessionboard.comEU Region — https://public-api-eu.sessionboard.com

Authorization

Send asAPI token (x-access-token)OAuth access token (Bearer)

Token

Your token stays in this page. It is sent only to the region above and is never saved; it is gone when you leave or reload the page.

Path parameters

eventId*

sessionId*

Body application/json

{ "filename": "<string>", "content_type": "<string>", "size_bytes": 123 }

POST

Send request

Authorizations

• x-access-tokenstringheader

  Organization API token. Generate from Organization Settings → API Tokens.

• AuthorizationBearer <token>headeror

  OAuth 2.1 access token. Obtained via the OAuth PKCE flow at /oauth/token.

Send one of these. See Authentication.

Path parameters

• eventIdintegerpathrequired

  Event ID

• sessionIdstring<uuid>pathrequired

  Session UUID

Request body

application/jsonrequired

• filenamestringrequired
• content_typestring
• size_bytesintegerrequired

Example

{
  "filename": "<string>",
  "content_type": "<string>",
  "size_bytes": 123
}

Responses

201application/json

Created

• dataobject
  Show child attributes

  • idstring<uuid>
  • typestring

    Example

    "recording"

  • session_idstring<uuid>
  • s3_bucketstring
  • s3_keystring

    After complete, non-PCM uploads are stored as .pcm keys.

  • encodingstring

    Example

    "linear16"

  • sample_rateinteger

    Example

    16000

  • channelsinteger

    Example

    1

  • statusstring

    Allowed values

    "recording", "completed"

  • duration_secondsnumber
  • file_size_bytesinteger
  • started_atstring<date-time>
  • completed_atstring<date-time>
  • created_atstring<date-time>
  • updated_atstring<date-time>
  • mp3_urlstring<uri> | null

    6-hour presigned HTTPS URL for an MP3 sibling of the original PCM take. Null while the recording is in progress or if transcode has not succeeded yet. Download and store this file — do not hotlink it as a permanent CDN URL. Session PDFs and user-uploaded files stay on /content and /files.

  • mp3_expires_atstring<date-time> | null

    When mp3_url stops working. Request the recording again to refresh the URL.

  • uploadobject
    Show child attributes

    • urlstring
    • methodstring

      Example

      "PUT"

    • headersobject
      Show child attributes

      • Content-Typestring

403

Missing write:transcriptions scope

Response examples

201

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "recording",
    "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "s3_bucket": "<string>",
    "s3_key": "<string>",
    "encoding": "linear16",
    "sample_rate": 16000,
    "channels": 1,
    "status": "recording",
    "duration_seconds": 123.45,
    "file_size_bytes": 123,
    "started_at": "2026-01-15T09:30:00Z",
    "completed_at": "2026-01-15T09:30:00Z",
    "created_at": "2026-01-15T09:30:00Z",
    "updated_at": "2026-01-15T09:30:00Z",
    "mp3_url": "https://example.com",
    "mp3_expires_at": "2026-01-15T09:30:00Z",
    "upload": {
      "url": "<string>",
      "method": "PUT",
      "headers": {
        "Content-Type": "<string>"
      }
    }
  }
}