Graph API Start transcription not working

Question

I am trying to start the transcription of a teams call using the graph api http request. Refer the link below:

https://learn.microsoft.com/en-us/graph/api/call-starttranscription?view=graph-rest-beta&tabs=http

This api is returning a 400 bad request. Refer the request & response bodies below

{
  "language": "en-us"
}

{
    "error": {
        "code": "",
        "message": "The input was not valid.",
        "details": [
            {
                "code": "",
                "message": "The input was not valid."
            }
        ]
    }
}
 

Would be great if someone can help me with this issue

Answer 1

The error message "The input was not valid" suggests that there may be an issue with the parameters being sent in your request to start the transcription. Here are a few things you can check:

1. Language Parameter: Ensure that the language code you are using ("en-us") is supported by the transcription service. You may want to verify if there are any specific requirements for the language parameter in the API documentation.
2. Call State: Make sure that the call you are trying to transcribe is in an established state. If the call is not active or has not been properly set up, the transcription request may fail.
3. Cognitive Services Configuration: Check if the Cognitive Services configuration is correctly set up during the call setup. If the transcription URL or configuration is missing, it could lead to a bad request.
4. Request Format: Ensure that your HTTP request is correctly formatted according to the API specifications. This includes the headers and the body of the request.

If you have verified all of the above and are still encountering issues, consider logging the request ID and date from the HTTP response headers, as these can be useful when reporting the issue to Microsoft Support.

---

References:

• How to debug Microsoft Graph API calls
• Add real-time transcription into your application (programming-language-python)

Answer 2

Hi Rushitha Perera,

Thank you for posting your question in the Microsoft Q&A forum. 

To clarify, I’m a forum moderator and I don’t have the resources or environment to reproduce the issue you described as I don’t have a custom calling bot to create a Graph Communications call, so I can’t provide a definite fix. In this case I can help research the error code and the endpoint, but I haven’t found any previously reported behavior or articles that match this specific HTTP 400 with “The input was not valid” for startTranscription.

Given that, here are a few actions to investigate further:

1. Confirm the API version and URL: This action is available only in beta, so please make sure you’re calling the beta endpoint (not v1.0).
2. Replicate Microsoft’s sample request headers: Some clients/libraries are strict about headers. Try matching the sample from the docs: Content-Type: application/json, Content-Length: 56 and also Accept-Language: en-US
3. Ensure transcription is enabled in your tenant: In the Teams admin center, confirm that call/meeting transcription is turn on: https://learn.microsoft.com/en-us/microsoftteams/call-recording-transcription-captions#enable-call-transcription

If the error persists, please log the request-id and date from the failing response headers and open a support ticket for Microsoft Graph in your Azure portal, you can follow here: https://developer.microsoft.com/en-us/graph/support
The support team has the tools to trace the internal error and provide the most accurate guidance.

---

If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.