Skip to content

New command: teams callrecord list #6737

@milanholemans

Description

@milanholemans

Idea was raised in #6736


Usage

m365 teams callrecord list [options]

Description

Lists all Teams calls within the tenant

Options

Option Description
--userId [userId] Filters call records to only include those where the user participated. Use the Entra user ID of the user. Specify either userId or userName but not both.
--userName [userName] Filters call records to only include those where the user participated. Use the UPN of the user. Specify either userId or userName but not both.
--startDateTime [startDateTime] Only show calls that started after this time. Defaults to the maximum of 30 days ago.
--endDateTime [endDateTime] Only show calls that started before this time (exclusive). Defaults to now.

Examples

Get all call records from the last 30 days

m365 teams callrecord list

Get all call records where a specific user participated in

m365 teams callrecord list --userName "john.doe@contoso.com"

Get all call records that started within a specific timeframe

m365 teams callrecord list --startDateTime "2025-05-1T00:00:00Z" --endDateTime "2025-05-7T00:00:00Z"

Default properties

  • id
  • type
  • startDateTime

Additional Info

API: https://learn.microsoft.com/en-us/graph/api/callrecords-cloudcommunications-list-callrecords?view=graph-rest-1.0&tabs=http


Let's ensure the command only works with app permissions

Remarks:

You can only retrieve call records that did not take place more than 30 days ago.

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions