tasks

Create Dialogue Upload Url

Mint a resumable GCS upload session for this user's half of a conversation.

The object name is server-chosen (dialogue/{sessionId}/{uploadId}.wav) and the session is bound to the caller's Origin — the browser PUTs the bytes directly. A repeat call while an attempt is open supersedes it; after /complete → 409.

Two forms (module docstring): with sizeBytes the recording already exists, so its declared length bounds the session and the duration/size rules run here; without it the call has only just started and both the length and the rules move to /complete. Either way the caller gets a one-time complete token, which is what makes that /complete survive a cookie-less webview.

post/api/available/dialogue/{task_uid}/upload-url

Request

  • Base URL
    https://api.ncspeech.org (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

task_uidstring required

Headers

X-Test-UIDstring nullable

Request body

sampleRateinteger nullable
channels1 nullable
bitsPerSample16 nullable
sizeBytesinteger nullable
sessionIdstring required
durationSecondsnumber nullable
endReason'selfStopped' | 'partnerEnded' | 'minDurationNotReached' | 'connectionLost' | 'error' nullable
ratinginteger nullable
gpsstring nullable
deviceTypestring nullable
inputHashstring nullable
inputLabelstring nullable
outputHashstring nullable
outputLabelstring nullable
topicIdstring nullable
topicTitlestring nullable
convLangstring nullable
droppedFramesinteger nullable
startedAtEpochMsinteger nullable

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.