Premium APIsDevice DiagnosticsAPI EndpointsDiagnostics Callbacks
API Reference
Delete a Diagnostics Callback
DELETE /callbacks?accountName={account}&serviceName={service}
Delete a registered Diagnostics callback Url or credential.
Uses and Requirements
You can delete a registered Diagnostics callback Url or credential
Request Components
HTTP Request
Resource Path and Query Parameters
The account name must be included in the path.
| Parameter Name | Data Type | Description |
|---|---|---|
| accountName required | string | The name of the billing account from which you want to delete callback messages. An account name is usually numeric, and must include any leading zeros. |
| serviceName required | string | Service name for Callback Notification. |
Header Parameters
The request header must contain a current ThingSpace authorization bearer token and a valid VZ-M2M session token, and must set the content-type to JSON.
| Parameter Name | Data Type | Description |
|---|---|---|
| Authorization required | string | HTTP Authorization bearer token. |
| VZ-M2M-Token required | string | A valid session token returned by POST /session/login. |
| Content-Type required | string | Must be application/json. |
Request Body
None.
Success Responses
Status 200
A success response contains the current status of the report.
| Parameter Name | Data Type | Description |
|---|---|---|
| accountName | string | The name of the billing account for which callback messages will be sent. |
| serviceName | string | The name of the callback service, which identifies the type and format of messages that will be sent to the registered URL. |
| endpoint | string | The URL for your web server. |
| httpHeaders | string | Your http headers. |
| createdOn | string($date-time) | The date and time of when this request was created. |
Example Success Response
{
"accountName": "TestQAAccount",
"serviceName": "string",
"endpoint": "https://yourwebsite.com",
"httpHeaders": {},
"createdOn": "2019-09-07T23:57:53.292Z"
}Failure Responses
Status 400 All error messages are returned in this format:
{
"errorCode": "error code string",
"errorMessage": "error message string"
}