---
title: "Start Speech to Text Bulk Job V1"
method: POST
path: "/speech-to-text/job/v1/{job_id}/start"
tags: ["speechToTextJob"]
---

# Start Speech to Text Bulk Job V1

`POST /speech-to-text/job/v1/{job_id}/start`

## Request

- Base URL: `https://api.sarvam.ai`
- URL: `https://api.sarvam.ai/speech-to-text/job/v1/{job_id}/start`
- Auth: none declared
- TypeScript: <https://skmtc.dev/sarvam/apis/endpoints/docs/speech-to-text/job/v1/:job_id/start/post.ts> (a function with typed inputs; its response is checked against the schema)

Start processing a speech to text bulk job after all audio files have been uploaded

## Path parameters

- `job_id` string, required

## Query parameters

- `ptu_id` integer, nullable

## Headers

- `api-subscription-key` string, required
- `api-subscription-key` string

## Response `200`

Successful Response

- JobStatusResponse
  - `job_state` 'Accepted' | 'Pending' | 'Running' | 'Completed' | 'Failed', required
  - `created_at` string, required: Created At
  - `updated_at` string, required: Updated At
  - `job_id` string, required: Job Id
  - `total_files` integer: Total Files
  - `successful_files_count` integer: Success Count
  - `failed_files_count` integer: Failed Count
  - `storage_container_type` 'Azure' | 'Local' | 'Google' | 'Azure_V1', required
  - `error_message` string: Error Message
  - `job_details` TaskDetail[]: Job details at file level.
    - `inputs` TaskFileDetails[]
      - `file_name` string, required
      - `file_id` string, required
    - `outputs` TaskFileDetails[]
      - `file_name` string, required
      - `file_id` string, required
    - `state` 'Success' | 'API Error' | 'Internal Server Error'
    - `error_message` string, nullable
    - `exception_name` string, nullable

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `422`: Unprocessable Entity
- `429`: Quota Exceeded
- `500`: Internal Server Error
- `503`: Service Overloaded

## Changes

- **2026-07-26** `2b7f7955b147`: 1 breaking, 1 warning
  - added the new required `header` request parameter `api-subscription-key`
  - deleted the `header` request parameter `api-subscription-key`

[Operation history](https://skmtc.dev/sarvam/apis/endpoints/changes/speech-to-text/job/v1/:job_id/start/post.md)

---

[API](https://skmtc.dev/sarvam/apis/endpoints.md) - [All operations](https://skmtc.dev/sarvam/apis/endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/sarvam/apis/endpoints/revisions/2b7f7955b147?raw)