Appscp: added more detail around async errors

2014-04-18T22:49:40Z

added more detail around async errors

Appscp: v1 documentation

2013-12-04T22:18:41Z

v1 documentation

New page

The following applies to Exchange routes that link to this page. No v0 route supports these concepts.

__TOC__

== Data Models ==

=== Mailbox ===

Required for Create[[*]]

{| class="wikitable"
!''Field Name''
!''Data Type''
!''Verbs''
!''Description''
|-
| Common Name[[*]]
| String
| GET, POST
| The resource's username
|-
| Display Name[[*]]
| String
| GET, POST, PUT
| The resource's display name
|-
| Alias
| String
| GET
| Read only
|-
| IsHiddenFromAddressList
| Boolean
| GET, POST, PUT
| If true, not displayed in public address book.
|-
| Status
| String
| GET
| Current status of resource. (See [[#Asynchronous_Statuses|Asynchronous Statuses]])
|-
| Error
| [[#Error|Error]]
| GET
| Returns error information about the latest operation on the resource. (See [[#Asynchronous_Errors|Asynchronous Errors]])
|
|}

=== Error ===

(See [[#Asynchronous_Errors|Asynchronous Errors]])

{| class="wikitable"
!''Field Name''
!''Data Type''
!''Verbs''
!''Description''
|-
| Action
| "get", "post", "put", "delete"
| GET
|
|-
| Message
| String
| GET
|
|-
| Details
| String
| GET
|
|-
| Code
| Integer
| GET
|
|-
| Uri
| Uri
| GET
| URI to GET to retrieve full detail
|}

=== Serialization ===

XML and JSON are supported.

For XML, fields called "Value" are represented by the inner XML of a node.

== Listings ==

Query parameters for listings:

{| class="wikitable"
!''Field Name''
!''Data Type''
!''Description''
|-
| Search
| String
| A value to filter the list by Common Name and Display Name.
|-
| Marker
| String
| The common name of the last item from the previous listing call. Use this to get the next page of data.
|-
| Limit
| Integer
| The maximum number of items to return.
|-
| Sort
| String
| The value to sort by; must be "CN" or "DisplayName" for primary resources like [[Exchange_Distribution_List_(Rest_API)#List|Distribution Lists]] and [[Exchange_Resource_Mailbox_(Rest_API)#List|Resources]]
|-
| Order
| String
| asc or desc, to specify which way to order the data
|-
| PreviousPage
| Boolean
| Returns the previous page based on Marker. If Marker is not specified, then the last page is returned.
|-
| ExportTo
| String
| For listings that support exporting, this value can be a valid email address. An email will be sent containing a link to a CSV file of the requested data.
|}

Listings use markers for pagination. To get the next page of data, set the marker parameter to common name of the last item of the list that was most recently returned. To get the previous page of data, set the marker to the common name of the first item of the list that was most recently returned, and set PreviousPage to true.

=== Demonstration ===

In this demonstration, there are 5 Resources on the example.com domain, room.101 through room.105.

We can list all of the Resources Mailboxes on the domain. The response includes a Resource Mailbox’s property in an array of the list results. For listings, the name of this property is dependent on the resource type. (For the Resources resource, the property is called ResourceMailboxes, but for the Distribution List resource, the property is called DistributionLists.)”

The Total property shows that there are 5 items total, that the limit for this page is 50, and that the items are sorted by Common Name ascending.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources

Response:
200 OK
{
"ResourceMailboxes":[
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.101@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.101",
"DisplayName":"Room 101",
"Alias":"room.101.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.101f16"
},
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.102@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.102",
"DisplayName":"Room 102",
"Alias":"room.102.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.10269d"
},
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.103@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.103",
"DisplayName":"Room 103",
"Alias":"room.103.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.1037e9"
},
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.104@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.104",
"DisplayName":"Room 104",
"Alias":"room.104.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.10400c"
},
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.105@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.105",
"DisplayName":"Room 105",
"Alias":"room.105.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.105f62"
}
],
"Sort":"cn",
"Limit":50,
"Total":5,
"Order":"asc"
}
</pre>

==== Search ====
The request below demonstrates the Search option. We search for "3", which returns results that match both the Common Name and Display Name.

Total denotes that there is only 1 item that matches this search criteria. This example shows all items on one page, however the Total can be more than the Limit if the results do not fit in one response.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources?search=g

Response:
200 OK
{
"ResourceMailboxes":[
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.103@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.103",
"DisplayName":"Room 103",
"Alias":"room.103.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.1037e9"
}
],
"Sort":"cn",
"Search":"3",
"Limit":50,
"Total":5,
"Order":"asc"
}
</pre>

==== Limit ====
The request below demonstrates the Limit option

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources?limit=2

Response:
200 OK
{
"ResourceMailboxes":[
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.101@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.101",
"DisplayName":"Room 101",
"Alias":"room.101.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.101f16"
},
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.102@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.102",
"DisplayName":"Room 102",
"Alias":"room.102.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.10269d"
}
],
"Sort":"cn",
"Limit":2,
"Total":5,
"Order":"asc"
}
</pre>

==== Marker ====
The request below demonstrates the Marker option. We are getting the next page of results from the previous example.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources?marker=room.103

Response:
200 OK
{
"ResourceMailboxes":[
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.104@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.104",
"DisplayName":"Room 104",
"Alias":"room.104.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.10400c"
},
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.105@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.105",
"DisplayName":"Room 105",
"Alias":"room.105.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.105f62"
}
],
"Sort":"cn",
"Marker":"room.103",
"Limit":50,
"Total":5,
"Order":"asc"
}
</pre>

==== PreviousPage ====
This request demonstrates the PreviousPage option. We are getting the previous page of results from the previous example. Notice how the results are the same as from two examples previous.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources?marker=room.103&previousPage=true

Response:
200 OK
{
"ResourceMailboxes":[
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.101@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.101",
"DisplayName":"Room 101",
"Alias":"room.101.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.101f16"
},
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.102@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.102",
"DisplayName":"Room 102",
"Alias":"room.102.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.10269d"
}
],
"Sort":"cn",
"Marker":"room.106",
"Limit":50,
"Total":5,
"Order":"asc"
}
</pre>

==== Sort and Order ====
This request demonstrates the Sort and Order options.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources?sort=DisplayName&Order=desc

Response:
200 OK
{
"ResourceMailboxes":[
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.105@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.105",
"DisplayName":"Room 105",
"Alias":"room.105.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.105f62"
},
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.104@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.104",
"DisplayName":"Room 104",
"Alias":"room.104.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.10400c"
},
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.103@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.103",
"DisplayName":"Room 103",
"Alias":"room.103.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.1037e9"
},
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.102@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.102",
"DisplayName":"Room 102",
"Alias":"room.102.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.10269d"
},
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"room.101@example.com",
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"room.101",
"DisplayName":"Room 101",
"Alias":"room.101.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=room.101f16"
}
],
"Sort":"DisplayName",
"Limit":50,
"Total":5,
"Order":"desc"
}
</pre>

== Asynchronous Statuses ==

POST, PUT, and DELETE operations are asynchronous. That means that submitting a request will return a success code (204 No Content), but the request itself is not processed immediately. Rather, the request is added to a queue to be completed by another worker. POST, PUT, and DELETE requests will not be accepted unless the resource's status is Ready.

{| class="wikitable"
! Status
! Description
|-
| Creating
| A POST request is being processed.
|-
| Updating
| A PUT request is being processed.
|-
| Deleting
| A DELETE request is being processed.
|-
| Ready
| The last request for the resource was successful.
|-
| Error
| The last request for the resource failed.
|}

The following annotated HTTP requests and responses demonstrate all of the statuses except for Error. For a demonstration of the Error status, see [[#Asynchronous_Errors|Asynchronous Errors]]

=== Demonstration ===

Submit a request to create a basic Resource. The request is accepted and will be processed.

<pre>
Request:
POST /v1/customers/all/domains/example.com/ex/resources/
{
"CommonName": "status.resource.100",
"Type": "Room",
"DisplayName": "Status Resource 100"
}

Response:
204 No Content
</pre>

GET the Resource right away. The status shows that the Resource is being created.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources/status.resource.100

Response:
200 OK
{
"Type":"Room",
"PhoneNumber":null,
"Upn":null,
"ResourceCapacity":0,
"CustomProperties":[
],
"CommonName":"status.resource.100",
"DisplayName":"Status Resource 100",
"Alias":null,
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Creating",
"LegacyExchangeDn":null
}
</pre>

Get the Resource again a bit later. The status shows that the resource is ready.

<pre>
GET /v1/customers/all/domains/example.com/ex/resources/status.resource.100

Response:
200 OK
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"status.resource.100@example.com",
"ResourceCapacity":0,
"CustomProperties":[
],
"CommonName":"status.resource.100",
"DisplayName":"Status Resource 100",
"Alias":"status.resource.100.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=status.resource.100312"
}
</pre>

Submit a request to update the Resource. The request is accepted and will be processed.

<pre>
Request:
PUT /v1/customers/all/domains/example.com/ex/resources/status.resource.100
{
"DisplayName": "Status Resource 100!!!"
}

Response:
204 No Content
</pre>

GET the Resource right away. The status shows that the Resource is being updated.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources/status.resource.100

Response:
200 OK
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"status.resource.100@example.com",
"ResourceCapacity":0,
"CustomProperties":[
],
"CommonName":"status.resource.100",
"DisplayName":"Status Resource 100!!!",
"Alias":"status.resource.100.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Updating",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=status.resource.100312"
}
</pre>

Get the Resource again a bit later. The status shows that the resource is ready.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources/status.resource.100

Response:
200 OK
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"status.resource.100@example.com",
"ResourceCapacity":0,
"CustomProperties":[
],
"CommonName":"status.resource.100",
"DisplayName":"Status Resource 100!!!",
"Alias":"status.resource.100.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Ready",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=status.resource.100312"
}
</pre>

Submit a request to delete the Resource. The request is accepted and will be processed.

<pre>
Request:
DELETE /v1/customers/all/domains/example.com/ex/resources/status.resource.100

Response:
204 No Content
</pre>

GET the Resource right away. The status shows that the Resource is being deleted.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources/status.resource.100

Response:
200 OK
{
"Type":"Room",
"PhoneNumber":null,
"Upn":"status.resource.100@example.com",
"ResourceCapacity":0,
"CustomProperties":[
],
"CommonName":"status.resource.100",
"DisplayName":"Status Resource 100!!!",
"Alias":"status.resource.100.example.com",
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Deleting",
"LegacyExchangeDn":"/o=e14s/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=status.resource.100312"
}
</pre>

Get the Resource again a bit later. The resource cannot be found, because it has been deleted.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources/status.resource.100

Response:
200 OK
{
"itemNotFoundFault":{
"resourceType":"",
"message":"The requested mailbox could not be found",
"details":"10/2/2013 3:18:09 PM",
"code":404
}
}
</pre>

== Asynchronous Errors ==

A mailbox will go into an Error state if an error occurs after the initial request was accepted when creating, updating or deleting a mailbox.<br/>
This means that the mailbox will have a status of "Error" and will contain an [[#Error|Error]] property.

'''Error Uri'''
* The Error property has a Uri field that contains the location of the error details
* A GET on the location returns additional details about the error
* A DELETE on the location will clear the Error
** If the error occurred after a POST, deleting the error will also remove the associated mailbox
** If the error occurred after a PUT or DELETE, deleting the error will return the mailbox to its previous state before the error occurred

The following annotated HTTP requests and responses demonstrate all of the Error statuses and Error objects.

=== Demonstration ===

Adding a Resource with an invalid RequestInPolicy recipient will produce an asynchronous error. The request is accepted and will be processed

<pre>
Request:
POST /v1/customers/all/domains/example.com/ex/resources/
{
"CommonName": "errored.room.100",
"Type": "Room",
"DisplayName": "Errored Error 100",
"RequestInPolicy": {
"Recipients": [
{
"Value": "I do not exist and also contain invalid characters"
}
]
}
}

Response:
204 No Content
</pre>

We can GET the resource immediately. While the resource is processing, the status is "Creating"

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources/errored.room.100

Response:
200 OK
{
"Type":"Room",
"PhoneNumber":null,
"Upn":null,
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"errored.room.100",
"DisplayName":"Errored Error 100",
"Alias":null,
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Creating",
"LegacyExchangeDn":null
}
</pre>

We can GET the resource again, once it is done processing. Now that the resource is done processing, the status has changed to Error, and the Error object has a URI.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources/errored.room.100

Response:
200 OK
{
"Type":"Room",
"PhoneNumber":null,
"Upn":null,
"ResourceCapacity":0,
"CustomProperties":[

],
"CommonName":"errored.room.100",
"DisplayName":"Errored Error 100",
"Alias":null,
"IsHiddenFromAddressList":false,
"PrimarySmtpAddress":null,
"EmailAddresses":null,
"Status":"Error",
"LegacyExchangeDn":null,
"Error":{
"Action":null,
"Message":null,
"Details":null,
"Code":0,
"Uri":"/v1/customers/all/domains/example.com/ex/resources/errored.room.100/errors"
}
}
</pre>

We can perform a GET on that Error URI to get the error.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources/errored.room.100/errors

Response:
200 OK
{
"Errors":[
{
"Action":"post",
"Message":"Error creating new resource mailbox",
"Details":"System.Management.Automation.RemoteException: Couldn't find object \"e14s.mlsrvr.com/hosting/1191941/example.com/I do not exist and also contain invalid characters\". Please make sure that it was spelled correctly or specify a different object.",
"Code":0,
"Uri":null
}
]
}
</pre>

We can perform a DELETE on the Error URI to clear the error.

<pre>
Request:
DELETE /v1/customers/all/domains/example.com/ex/resources/errored.room.100/errors

Response:
204 No Content
</pre>

We can verify that the error is gone.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources/errored.room.100/errors

Response:
404 Not Found
{
"itemNotFoundFault":{
"resourceType":"",
"message":"The requested mailbox could not be found",
"details":"10/2/2013 2:25:39 PM",
"code":404
}
}
</pre>

Since the error was with a POST, performing a GET on the resource now will return a 404.

<pre>
Request:
GET /v1/customers/all/domains/example.com/ex/resources/errored.room.100

Response:
404 Not Found
{
"itemNotFoundFault":{
"resourceType":"",
"message":"The requested mailbox could not be found",
"details":"10/2/2013 2:25:50 PM",
"code":404
}
}
</pre>

@@ Line 770: / Line 770: @@
 === Demonstration ===
 Adding a Resource with an invalid RequestInPolicy recipient will produce an asynchronous error.  The request is accepted and will be processed
@@ Line 875: / Line 877: @@
 </pre>
-We can perform a DELETE on the Error URI to clear the error.
+We can perform a DELETE on the Error URI to clear the error.  This operation is '''synchronous'''.  When the HTTP response returns with success, the error has been deleted.
 <pre>
@@ Line 920: / Line 922: @@
+}
 </pre>

Common Exchange API Concepts - Revision history

Appscp: added more detail around async errors

Appscp: v1 documentation