impl: support for removing the workspace

- calls the coder REST API endpoints to remove a workspace id.

Author: fioan89

src/main/kotlin/com/coder/toolbox/sdk/CoderRestClient.kt

@@ -240,10 +240,14 @@ open class CoderRestClient(
     }
 
     /**
-     * @throws [APIResponseException].
+     * @throws [APIResponseException] if issues are encountered during deletion
      */
     fun removeWorkspace(workspace: Workspace) {
-        // TODO - implement this
+        val buildRequest = CreateWorkspaceBuildRequest(null, WorkspaceTransition.DELETE, false)
+        val buildResponse = retroRestClient.createWorkspaceBuild(workspace.id, buildRequest).execute()
+        if (buildResponse.code() != HttpURLConnection.HTTP_CREATED) {
+            throw APIResponseException("delete workspace ${workspace.name}", url, buildResponse)
+        }
     }
 
     /**

src/main/kotlin/com/coder/toolbox/sdk/v2/models/CreateWorkspaceBuildRequest.kt

@@ -8,8 +8,9 @@ import java.util.UUID
 data class CreateWorkspaceBuildRequest(
     // Use to update the workspace to a new template version.
     @Json(name = "template_version_id") val templateVersionID: UUID?,
-    // Use to start and stop the workspace.
+    // Use to start, stop and delete the workspace.
     @Json(name = "transition") val transition: WorkspaceTransition,
+    @Json(name = "orphan") var orphan: Boolean? = null
 ) {
     override fun equals(other: Any?): Boolean {
         if (this === other) return true