Logo
Akamai APIs API Documentation

Generate a diagnostic link

POST https://{{host}}/edge-diagnostics/v1/user-diagnostic-data/groups

Generates a diagnostic link for you to share with end users of a particular URL or IP acceleration hostname experiencing similar issues. After an end user clicks the link, the tool gathers necessary diagnostic data and asks the end user to submit it. Once submitted, you can check the collected data with the Get diagnostic data of a group operation. Each link is valid for 7 days of 50 submissions. To get the list of IP acceleration hostname you can collect diagnostic data for, run the List IP acceleration hostnames operation first.

 

Body PARAM

Key Datatype Required Description 
accountSwitchKey
string (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).



HEADERS

Key Datatype Required Description 
Content-Type
string
Accept
string




RESPONSES

status Created

{ "createdBy": "szhang", "createdTime": "2021-07-24T04:25:40Z", "diagnosticLink": "www.t1info.net/623b8c", "diagnosticLinkStatus": "ACTIVE", "groupId": "623b8c", "note": "Diagnostic group", "recordCount": 0, "url": "https://www.example.com" }



Curl
curl -X POST 'https://undefined/edge-diagnostics/v1/user-diagnostic-data/groups?accountSwitchKey=' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"note":"Diagnostic group","url":"https://www.example.com"}'

ENDPOINTS