Skip to content

Commit 12a9fd3

Browse files
committed
fix relative links
1 parent a09b476 commit 12a9fd3

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

concepts/callrecords-api-faq.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -10,28 +10,28 @@ ms.subservice: "cloud-communications"
1010

1111
## What is the Microsoft Graph Call Records API?
1212

13-
The Microsoft Graph Call Records API, also known as the call records API, offers usage and diagnostic insights for calls and online meetings that occur within your organization when using Microsoft Teams or Skype for Business. Organizations referred to as tenants, can use the call records API to subscribe to, list, retrieve call records by call IDs, and to look up calls for a participant. For more details, please refer to the [Working with the call records API in Microsoft Graph](../api-reference/v1.0/resources/callrecords-api-overview.md).
13+
The Microsoft Graph Call Records API, also known as the call records API, offers usage and diagnostic insights for calls and online meetings that occur within your organization when using Microsoft Teams or Skype for Business. Organizations referred to as tenants, can use the call records API to subscribe to, list, retrieve call records by call IDs, and to look up calls for a participant. For more details, please refer to the [Working with the call records API in Microsoft Graph](/graph/api/resources/callrecords-api-overview).
1414

1515
## What is the permission required to use the Call Records API?
1616

1717
Your application needs the **CallRecords.Read.All** permission to access call records in Microsoft Graph. An administrator must grant this permission to the application. For more details, please refer to the [Microsoft Graph permissions reference](permissions-reference.md).
1818

1919
## How do I request a call record using the Microsoft Graph Call Records API?
2020

21-
To request a call record, you need to make a `GET` request to the `/communications/callRecords/{id}` endpoint, where `{id}` is the unique identifier of your call. Ensure you have the necessary **CallRecords.Read.All** permission and include the Authorization header with a valid bearer token. For more details, please refer to the [Get callRecord documentation](../api-reference/v1.0/api/callrecords-callrecord-get.md).
21+
To request a call record, you need to make a `GET` request to the `/communications/callRecords/{id}` endpoint, where `{id}` is the unique identifier of your call. Ensure you have the necessary **CallRecords.Read.All** permission and include the Authorization header with a valid bearer token. For more details, please refer to the [Get callRecord documentation](/graph/api/callrecords-callrecord-get).
2222

2323
## Where can I find the call IDs of the calls that occurred in my organization?
2424

2525
You can find and collect call IDs using the following options:
2626

2727
* **Subscribe to notifications**: Subscribe to [change notifications feed](changenotifications-for-callrecords.md) and receive notifications containing call IDs whenever a new call record is created.
28-
* **List call records**: Get a list of call IDs by requesting it from [List callRecords API](../api-reference/v1.0/api/callrecords-cloudcommunications-list-callrecords.md).
28+
* **List call records**: Get a list of call IDs by requesting it from [List callRecords API](/graph/api/callrecords-cloudcommunications-list-callrecords).
2929
* **Manual search**: If you're a [Call Analytics](https://learn.microsoft.com/microsoftteams/use-call-analytics-to-troubleshoot-poor-call-quality) customer, you can manually search for a call ID in a user’s history. However, there's no automated system available to retrieve all call IDs from Call Analytics.
30-
* **Use callChainId:**: Look up the call ID using the `callChainId` from the [Get call](../api-reference/v1.0/resources/call.md) API after the call is completed. The `callChainId` may differ from the call ID in certain scenarios, such as transfer calls due to architecture specifics. Therefore, this method is less preferred compared to other options.
30+
* **Use callChainId:**: Look up the call ID using the `callChainId` from the [Get call](/graph/api/resources/call) API after the call is completed. The `callChainId` may differ from the call ID in certain scenarios, such as transfer calls due to architecture specifics. Therefore, this method is less preferred compared to other options.
3131

3232
## When is a call record available?
3333

34-
A first version of a call record is typically generated and a notification is sent within 15 minutes after a call ends. However, it can take up to 60 minutes for the service to make the call record available. For more details, please refer to the [Latency](../api-reference/v1.0/resources/subscription.md#latency) page.
34+
A first version of a call record is typically generated and a notification is sent within 15 minutes after a call ends. However, it can take up to 60 minutes for the service to make the call record available. For more details, please refer to the [Latency](/graph/api/resources/subscription.md#latency) page.
3535

3636
## How long are call records retained?
3737

@@ -55,7 +55,7 @@ There are multiple options to list all participants who attended a call.
5555

5656
### Option 1: List participants_v2 API
5757

58-
Use the [List participants_v2](../api-reference/v1.0/api/callrecords-callrecord-list-participants_v2.md) API to collect the full list of participants for a requested call ID.
58+
Use the [List participants_v2](/graph/api/callrecords-callrecord-list-participants_v2) API to collect the full list of participants for a requested call ID.
5959

6060
### Option 2: callRecords API with expanded participants_v2 property
6161

@@ -65,13 +65,13 @@ You can call `GET communications/callRecords/{id}?$expand=participants_v2` to re
6565

6666
To see all participants, implement a custom solution to build the participants list from the call records data:
6767

68-
1. Call [Get callRecord](../api-reference/v1.0/api/callrecords-callrecord-get.md) API with expanded sessions endpoint: `GET /communications/callRecords/{id}?$expand=sessions`
68+
1. Call [Get callRecord](/graph/api/callrecords-callrecord-get.md) API with expanded sessions endpoint: `GET /communications/callRecords/{id}?$expand=sessions`
6969
2. Read `caller` property from each session on the received `sessions` list
70-
3. Build your custom participants list based on the `caller` endpoint [identity](../api-reference/v1.0/resources/identity.md) collecting `id`, `displayName`, and other properties you require to gather for a participant
70+
3. Build your custom participants list based on the `caller` endpoint [identity](/graph/api/resources/identity) collecting `id`, `displayName`, and other properties you require to gather for a participant
7171

7272
## Why don't I see all participants who attended a call while calling list participants_v2 API?
7373

74-
You might not see all participants because the [List participants_v2](../api-reference/v1.0/api/callrecords-callrecord-list-participants_v2.md) API supports pagination, limiting the number of participants in the response to 60 per page. If there were more than 60 users on the call, the first call record response contains 60 participants along with a `@odata.nextLink` property. This property includes the URL to call the API and receive the next set of participants. Continue this process until the next link is empty, indicating that there are no more participants to retrieve.
74+
You might not see all participants because the [List participants_v2](/graph/api/callrecords-callrecord-list-participants_v2) API supports pagination, limiting the number of participants in the response to 60 per page. If there were more than 60 users on the call, the first call record response contains 60 participants along with a `@odata.nextLink` property. This property includes the URL to call the API and receive the next set of participants. Continue this process until the next link is empty, indicating that there are no more participants to retrieve.
7575

7676
## Why do I receive a 404 Not Found error?
7777

0 commit comments

Comments
 (0)