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.

Authentication

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

Path parameters

Parameter	Type	Required	Description
`job_id`	string (UUID)	Yes	Job ID from Create Job

Example cURL

curl -X POST "https://api.vachana.ai/stt/v3/batch/jobs/019fa259-b084-71eb-94d7-ba4cdf2e64c6/start" \
  -H "X-API-Key-ID: <YOUR_API_KEY>"

Response

Success (202)

{
  "job_id": "019fa259-b084-71eb-94d7-ba4cdf2e64c6",
  "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

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

Next steps

Poll Get Job Status every 10 seconds (prefer 30 seconds for 100+ file jobs) until a terminal status. Use the playground on the right to try this endpoint with your API key.

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.

Gnani APIs

APIs

Use Cases

Start Job

Overview

Authentication

Path parameters

Example cURL

Response

Success (202)

Error responses

Next steps

Authorizations

Path Parameters

Response

​Overview

​Authentication

​Path parameters

​Example cURL

​Response

​Success (202)

​Error responses

​Next steps

Authorizations

Path Parameters

Response

Overview

Authentication

Path parameters

Example cURL

Response

Success (202)

Error responses

Next steps