delete https://api.compose.io/2016-07/deployments//portals/
Removes a portal from a deployment.
Will respond with information about the portals recipe that is being run to delete the selected portal.
A Recipe is a process, or processes, which performs a task; in this case, that task is deleteing a portal. When the API returns a recipe, it gives the id and status information about that process and its current status. The recipe runs asynchronously.
By querying the recipe endpoint - /2016-07/recipes/:id with the returned id, you can get updates on the status of the task being performed. Completion is denoted by the status field being returned as completed.