Bearer authentication
Create an API key in Settings. The raw key is shown once; later views expose only its safe prefix. Send the complete Authorization header on every request.
Never place an API key in browser code, a public repository, a URL, or logs. Server-side environment variables and secret stores are recommended.
Request example
curl -H "Authorization: Bearer $AUDIOGIST_API_KEY" \
"https://api-staging.knovox.com/api/v1/transcripts?limit=25&offset=0"GET /api/v1/transcripts
Page through transcript metadata owned by the key user. limit is 1–100 and defaults to 25; offset is 0–10,000 and defaults to 0.
GET /api/v1/transcripts/:id
Read one transcript with segments, structured summary data, and action items. Missing IDs and transcripts owned by another user both return 404.
The detail response contains
- transcript: source, status, language, duration, speaker count, progress, and timestamps.
- segments: position, millisecond timestamps, speaker data, text, and optional confidence.
- summary: template key, overview, key points, keywords, timestamped chapters, key decisions, notable quotes with speaker/timestamp context, and model; null until a summary exists.
- actionItems: content, optional owner, and completion state.
Errors and rate limits
- 400 VALIDATION_ERROR: invalid pagination parameters.
- 401 INVALID_API_KEY: missing, malformed, forged, expired, revoked, or no longer backed by a paid entitlement.
- 403 INSUFFICIENT_SCOPE: the key lacks transcripts:read.
- 404 TRANSCRIPT_NOT_FOUND: the resource is missing or not owned by the key user.
- 429 RATE_LIMITED: 120 read requests per key per minute; retry according to Retry-After.
Every response includes X-Request-Id. You can provide it to support, but never provide the complete API key.