Processing status - Audream API

Audio and AI generation requests may continue after the initial HTTP request returns. Poll the corresponding GET endpoint until it reaches a terminal state.

Status	Meaning	Client action
`200`	The requested result is ready	Read and persist the response
`202`	Processing is queued or running	Wait at least 2 seconds, then poll again
`404`	The note or result does not exist	Verify the note ID and workflow order
`409`	The requested operation conflicts with current note state	Wait for active processing or complete prerequisites
`422`	Transcription failed	Read `detail`; do not keep polling the failed job
`429`	The service is temporarily rate-limited	Respect `Retry-After` when present
`503`	AI generation is temporarily unavailable or failed	Retry later or inspect the returned detail

Recommended polling

Use a 2-second initial interval with a bounded timeout. Add random jitter when many jobs may finish together. Stop polling immediately for terminal errors.

async function waitForTranscription(noteId, apiKey) {
  const deadline = Date.now() + 30 * 60 * 1000;

  while (Date.now() < deadline) {
    const response = await fetch(
      `https://audream-api.tulingbc.com/v1/notes/${noteId}/transcription`,
      { headers: { Authorization: `Bearer ${apiKey}` } },
    );

    if (response.status === 200) return response.json();
    if (response.status !== 202) {
      throw new Error(await response.text());
    }
    await new Promise((resolve) => setTimeout(resolve, 2000));
  }
  throw new Error("Transcription timed out");
}

Idempotency

The note ID is the workflow identity. Repeating a transcription submission for a note that already has a result returns the existing state instead of creating a second note. Generate a new UUID for a distinct recording.