Skip to main content
GET
Get Voice File Job

인증

Authorization
string
header
필수

API key in format {id}.{secret}.

The notes an endpoint returns depend on the key type. A user key reaches the notes that user can see in the app, including notes in their own private folders. A system key (workspace or organization, no user identity) reaches only notes that sit in a folder shared with all workspace members. Notes in a private folder, in a folder shared with only some members, or in no folder at all fall outside a system key's read scope, and scopes do not widen that boundary.

List and search endpoints drop out-of-scope notes from the response without an error. Single-note reads and their sub-resources return 404, the same response as a deleted note. See What notes a system key reads.

경로 매개변수

jobId
string
필수

The job ID returned from Create Voice File Job

응답

Job details

Represents a voice file processing job. Voice File Jobs handle the complete pipeline of audio transcription and optional translation.

Processing Pipeline:

  1. Job created (CREATED) → Upload URI provided
  2. File uploaded (UPLOADED) → Ready for processing
  3. Processing started (PROCESSING) → STT and translation in progress
  4. Processing complete (COMPLETED) → Results available

Processing Time Estimates:

id
string
필수

Unique job identifier (UUID format)

예시:

"b2d1ab32-3fe2-4201-b0b4-391abdbaa023"

status
enum<string>
필수

Current job processing status:

  • CREATED: Job created, waiting for file upload
  • UPLOADED: File uploaded, waiting for processing to start
  • PROCESSING: Transcription/translation in progress
  • COMPLETED: All processing finished, results available
  • FAILED: Processing failed (check errorMessage)
사용 가능한 옵션:
CREATED,
UPLOADED,
PROCESSING,
COMPLETED,
FAILED
예시:

"PROCESSING"

fileUploadedAt
string<date-time> | null

Timestamp when file upload was completed. Null if not yet uploaded.

예시:

"2025-07-20T10:00:20Z"

processStartedAt
string<date-time> | null

Timestamp when processing started. Null if not yet started.

예시:

"2025-07-20T10:01:00Z"

processCompletedAt
string<date-time> | null

Timestamp when processing completed. Null if still processing.

예시:

null

errorMessage
string | null

Error message if job failed. Null for successful jobs.

예시:

null