DELETE /speech/transcriptions/{transcriptionId}

DELETE /speech/transcriptions/{transcriptionId}

Deletes a transcription for a previous file using transcriptionId.


Path parameters

  • transcriptionId string(uuid) Required

    Id of the transcribed audio. It is a UUID string provided in the speech recognition result.

Responses

  • The resource was deleted successfully.

  • This response means that server could not understand the request due to invalid syntax.

    Hide response attributes Show response attributes object
    • status string Required

      HTTP response status code.

    • detail string Required

      Message explaining the issue.

    • title string

      Error message title.

    • type string

      Error type.

  • Authentication is needed to get requested response. This is similar to 403, but in this case, authentication is possible.

    Hide response attributes Show response attributes object
    • status string Required

      HTTP response status code.

    • detail string Required

      Message explaining the issue.

    • title string

      Error message title.

    • type string

      Error type.

  • Client does not have access rights to the content so server is rejecting to give proper response.

    Hide response attributes Show response attributes object
    • status string Required

      HTTP response status code.

    • detail string Required

      Message explaining the issue.

    • title string

      Error message title.

    • type string

      Error type.

  • Server can not find requested resource.

    Hide response attributes Show response attributes object
    • status string Required

      HTTP response status code.

    • detail string Required

      Message explaining the issue.

    • title string

      Error message title.

    • type string

      Error type.

  • The request method is known by the server but has been disabled and cannot be used.

    Hide response attributes Show response attributes object
    • status string Required

      HTTP response status code.

    • detail string Required

      Message explaining the issue.

    • title string

      Error message title.

    • type string

      Error type.

  • The user has sent too many requests in a given amount of time ("rate limiting").

    Hide response attributes Show response attributes object
    • status string Required

      HTTP response status code.

    • detail string Required

      Message explaining the issue.

    • title string

      Error message title.

    • type string

      Error type.

  • The server has encountered a situation it doesn't know how to handle.

    Hide response attributes Show response attributes object
    • status string Required

      HTTP response status code.

    • detail string Required

      Message explaining the issue.

    • title string

      Error message title.

    • type string

      Error type.

  • The request method is not supported by the server and cannot be handled.

    Hide response attributes Show response attributes object
    • status string Required

      HTTP response status code.

    • detail string Required

      Message explaining the issue.

    • title string

      Error message title.

    • type string

      Error type.

DELETE /speech/transcriptions/{transcriptionId}
curl \
 -X DELETE https://api.amerandish.com/v1/speech/transcriptions/{transcriptionId} \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (400)
{
  "code": 400,
  "message": "Bad Request. Invalid JSON object."
}
Response examples (400)
{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}
Response examples (401)
{
  "code": 401,
  "message": "Unautherized. Invalid Authorization Token."
}
Response examples (401)
{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}
Response examples (403)
{
  "code": 403,
  "message": "Forbidden. Do not have access right to resource."
}
Response examples (403)
{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}
Response examples (404)
{
  "code": 404,
  "message": "Not Found. Requested id not found."
}
Response examples (404)
{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}
Response examples (405)
{
  "code": 405,
  "message": "Method Not Allowed."
}
Response examples (405)
{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}
Response examples (429)
{
  "code": 429,
  "message": "Too Many Requests. Your request is blocked due to exceeding rate limiting."
}
Response examples (429)
{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}
Response examples (500)
{
  "code": 500,
  "message": "Internal Server Error. Please retry later."
}
Response examples (500)
{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}
Response examples (501)
{
  "code": 501,
  "message": "Not Implemented. This functionality is not implemented yet."
}
Response examples (501)
{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}