Add support for the connection status API (#601)

* Add support for the connection status API * Code review items * Align doco
auth0 · Oct 19, 2022 · 2e81abc · 2e81abc
1 parent 659f6ad
commit 2e81abc
Show file tree

Hide file tree

Showing 2 changed files with 19 additions and 0 deletions.
diff --git a/src/Auth0.ManagementApi/Clients/ConnectionsClient.cs b/src/Auth0.ManagementApi/Clients/ConnectionsClient.cs
@@ -132,5 +132,16 @@ public Task<Connection> UpdateAsync(string id, ConnectionUpdateRequest request,
         {
             return Connection.SendAsync<Connection>(new HttpMethod("PATCH"), BuildUri($"connections/{EncodePath(id)}"), request, DefaultHeaders, cancellationToken: cancellationToken);
         }
+
+        /// <summary>
+        /// Retrieves the status of an ad/ldap connection.
+        /// </summary>
+        /// <param name="id">ID of the connection to check.</param>
+        /// <param name="cancellationToken">The cancellation token to cancel operation.</param>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous check operation. Will throw if the check fails.</returns>
+        public Task CheckStatusAsync(string id, CancellationToken cancellationToken = default)
+        {
+            return Connection.GetAsync<object>(BuildUri($"connections/{EncodePath(id)}/status"), DefaultHeaders, cancellationToken: cancellationToken);
+        }
     }
 }
diff --git a/src/Auth0.ManagementApi/Clients/IConnectionsClient.cs b/src/Auth0.ManagementApi/Clients/IConnectionsClient.cs
@@ -62,5 +62,13 @@ public interface IConnectionsClient
     /// <param name="cancellationToken">The cancellation token to cancel operation.</param>
     /// <returns>The <see cref="Connection"/> that has been updated.</returns>
     Task<Connection> UpdateAsync(string id, ConnectionUpdateRequest request, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Retrieves the status of an ad/ldap connection.
+    /// </summary>
+    /// <param name="id">ID of the connection to check.</param>
+    /// <param name="cancellationToken">The cancellation token to cancel operation.</param>
+    /// <returns>A <see cref="Task"/> that represents the asynchronous check operation. Will throw if the status check fails.</returns>
+    Task CheckStatusAsync(string id, CancellationToken cancellationToken = default);
   }
 }