Start Job

curl --request POST \
  --url https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/start \
  --header 'X-API-Key-ID: <api-key>'

import requests

url = "https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/start"

headers = {"X-API-Key-ID": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {'X-API-Key-ID': '<api-key>'}};

fetch('https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/start', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
  "status": "STARTING",
  "message": "Job start accepted. File validation and queueing are running in the background. Poll GET /stt/v3/batch/jobs/{job_id} to track progress."
}

POST

stt

batch

jobs

{job_id}

start

Start Job

curl --request POST \
  --url https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/start \
  --header 'X-API-Key-ID: <api-key>'

import requests

url = "https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/start"

headers = {"X-API-Key-ID": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {'X-API-Key-ID': '<api-key>'}};

fetch('https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/start', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
  "status": "STARTING",
  "message": "Job start accepted. File validation and queueing are running in the background. Poll GET /stt/v3/batch/jobs/{job_id} to track progress."
}

Overview

Start transcription for a job in CREATED status. Returns 202 Accepted while validation and queueing run in the background. Creating a job does not start processing — you must call this endpoint. For public-URL jobs, path validation happens here. If every path fails, status becomes START_FAILED.

Authentication

Header	Required	Description
`X-API-Key-ID`	Yes	Your Gnani Prisma v2.5 API key

Path Parameters

In Try it, paste a real job_id from Create Job before clicking Send. Leaving the placeholder {job_id} in the URL returns 422.

string

default:"019fa854-1db0-7e45-a026-7a6b09ff6d7c"

required

Job ID returned by Create Job. Replace with your own job_id before sending.

Example cURL

curl --request POST \
  --url https://api.vachana.ai/stt/v3/batch/jobs/019fa79e-81f9-7a8a-a446-6eff16ddec30/start \
  --header 'X-API-Key-ID: <YOUR_API_KEY>'

Response

Success (`202`)

{
  "job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
  "status": "STARTING",
  "message": "Job start accepted. File validation and queueing are running in the background. Poll GET /stt/v3/batch/jobs/{job_id} to track progress."
}

Error responses

409 Already started / terminal

{
  "error": "JOB_ALREADY_STARTED",
  "message": "Job cannot be restarted from state 'FAILED'"
}

404 Job not found

{
  "error": "JOB_NOT_FOUND",
  "message": "Job 01900000-0000-7000-8000-000000000000 not found"
}

string

Job identifier.

string

Typically STARTING after a successful start.

Use Cases

Kicking off transcription after files are uploaded
Starting a public-URL job after create

Next: poll Get Job Status every 10 seconds (prefer 30 seconds for 100+ file jobs).

Authorizations

X-API-Key-ID

string

header

required

Your Gnani Prisma v2.5 API key

Path Parameters

job_id

string

default:019fa854-1db0-7e45-a026-7a6b09ff6d7c

required

Job ID returned by Create Job. Paste the UUID from the Create Job response.

Response

Accepted

The response is of type object.

Create Job Get Job Status

Gnani APIs

APIs

Use Cases

Start Job

Overview

Authentication

Path Parameters

Example cURL

Response

Success (`202`)

Error responses

Use Cases

Authorizations

Path Parameters

Response

​Overview

​Authentication

​Path Parameters

​Example cURL

​Response

​Success (202)

​Error responses

​Use Cases

Authorizations

Path Parameters

Response

Overview

Authentication

Path Parameters

Example cURL

Response

Success (`202`)

Error responses

Use Cases