V-Spark Online Help

Possible Error Codes from the /transcribe API

The /transcribe API returns HTTP error codes when called with incorrect or invalid parameters:

400

The /request API returns a 400 in cases when the authentication token that is required to access V‑Spark is missing or invalid, or when S3 authentication information is invalid. The error text differs based on the cause of the error, and helps identify the cause of the problem:

Bad request

Content is being submitted via the S3 protocol and the S3 key information that is required to access a given bucket was invalid or was not provided.

Missing "token" field

No authorization token was provided in your call to the /request API.

Invalid token was provided

The authorization token that was used in your call to the /request API is not correct. Locating your authorization token is shown in V‑Spark API Permission Requirements.

402

The /transcribe API returns a 402 in response to attempts to exceed the usage models that are associated with the V‑Spark instance that you are running on:

Usage Limit is reached

You have reached the size limit of the amount of audio data that you are licensed to process. To increase that limit, contact your Voci sales representative or send email to Voci product support ().

404

The /transcribe API returns a 404 in response to multiple errors. The error text differs based on the cause of the error, and helps identify the cause of the problem:

Company not found

V‑Spark can look up the name of the company that you are using based on the value that you passed for the ORG_SHORT parameter. The value that you specified for this parameter is incorrect.

Folder folder-name not found

The folder that was passed as a parameter does not exist or cannot be accessed.

Organization organization-name not found

The organization whose short name was passed as a parameter does not exist or cannot be accessed.

406

The /transcribe API returns a 406 in response to errors where the data that it is POSTing is not acceptable to its client, the V‑Spark server. The error text differs based on the cause of the error, and helps identify the cause of the problem:

File size is too large. File should be smaller than LIMIT

The size of the uploaded file is larger than the displayed LIMIT. This limit is configurable via the transcribe_api_upload_limit configuration variable, so the text of this error may vary.

500

The /transcribe API returns a 500 in response to serious internal errors that reflect a hardware, software, or configuration error on the system where V‑Spark is running. Contact Voci product support () for assistance in identifying and resolving the problem.