Is recordAutomatically: true with allowRecording: false a supported combination? (Graph API transcript-only meetings)

wenceslao avalos 40 Reputation points
2026-08-27T19:13:37.55+00:00

We use app-only Graph to arm scheduled Teams meetings for transcription. Our goal is

transcript only — we do not want a recording to be created.

We PATCH /users/{userId}/onlineMeetings/{meetingId} with:

{

"recordAutomatically": true,

"allowTranscription": true,

"allowRecording": false

}

The results are inconsistent across otherwise identical meetings.

  • Sometimes a transcript is produced and /onlineMeetings/{id}/transcripts returns it.
  • Other times, transcription is visibly running in the Teams client for the entire call,

but when the meeting ends Teams posts "Recording stopped and wasn't saved as it was too

short" along with a 2-second recording, and no transcript is ever created. Recap shows

"No transcript available" and /transcripts stays empty indefinitely. Same settings, same

organizer, same tenant, a 32-minute call.

Our current reading is that recordAutomatically is the only automatic-start property in

Graph and that it starts a recording, so combining it with allowRecording: false puts the

meeting into a state that was never defined.

Questions:

  1. Is recordAutomatically: true together with allowRecording: false a supported combination? If it isn't, is the expected outcome that no transcript is produced?
  2. MC1283816 introduced a "Transcribe only" automatic meeting setting in the Teams UI. Is there a Graph equivalent, in v1.0 or beta, to set it programmatically? I don't see a corresponding property on onlineMeeting or onlineMeetingBase.
  3. If there isn't one, is allowing the recording currently the only supported way to get an automatic transcript?

Two things to rule out up front:

  • These are calendar-backed scheduled meetings, created via POST /users/{id}/events with isOnlineMeeting: true and onlineMeetingProvider: teamsForBusiness. They are not ad-hoc meetings created through POST /onlineMeetings.
  • Permissions and the application access policy are configured correctly: OnlineMeetingTranscript.Read.All is granted, and fetching works normally for the meetings that do produce a transcript. The failing cases return an empty collection, not a 403.
Microsoft Teams | Development
Microsoft Teams | Development

Building, integrating, or customizing apps and workflows within Microsoft Teams using developer tools and APIs

0 comments No comments

Answer accepted by question author
Jay1 Tran 515 Reputation points Independent Advisor
2026-08-27T19:56:46.9+00:00

Hi wenceslao,

Thank you for reaching out.

Based on the currently documented Microsoft Graph behavior, the following configuration should not be used as a transcript-only setting:

{
  "recordAutomatically": true,
  "allowTranscription": true,
  "allowRecording": false
}		
	

recordAutomatically instructs Teams to start recording automatically. allowRecording: false prevents recording, while allowTranscription: true permits transcription but does not independently cause transcription to start.

Microsoft Graph does not currently document recordAutomatically: true together with allowRecording: false as a supported method for automatically starting transcription without recording. Graph may accept the individual properties, but the resulting behavior is not defined. This may explain why some meetings produce a transcript while others fail to finalize it after the recording workflow is stopped.

The new Teams Transcribe only automatic meeting option is not currently represented by a documented property on the Microsoft Graph v1.0 or beta onlineMeeting resource. The Teams UI can configure this behavior, but the corresponding option is not presently available through the published Graph schema.

Until such a property is exposed, the supported Graph-based automatic path is:

{
  "recordAutomatically": true,
  "allowRecording": true,
  "allowTranscription": true
}

If meeting recording is prohibited, automatic transcript-only behavior must currently be configured through the Teams meeting options UI. Alternatively, an authorized participant can start transcription manually after joining the meeting.

User's image

I hope this information clarified your concerns. Thank you for your time and patience.

Was this answer helpful?

1 person found this answer helpful.
0 comments No comments

1 additional answer

Sort by: Newest
  1. Deleted

    This answer has been deleted due to a violation of our Code of Conduct. The answer was manually reported or identified through automated detection before action was taken. Please refer to our Code of Conduct for more information.


    Comments have been turned off. Learn more

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.