Delete a flow

Permanently delete a flow and all associated assets (inputs, outputs, intermediates).

Requirements: Flow can only be deleted if it is in one of the following states:

• created: Flow was created but never started
• completed: Flow finished successfully
• aborted: Flow was manually aborted
• failed: Flow encountered an error

Restrictions: Cannot delete flows in active states (starting, running, aborting). These flows must first reach a terminal state before deletion.

When to Delete: Delete flows when you no longer need them to free up storage space. For example, after successfully downloading the generated 3D model, you can delete the flow to avoid unnecessary storage costs. This is especially recommended for completed flows where outputs have been retrieved.

Warning: This operation is irreversible. All flow data will be permanently removed.

info

This endpoint allows you to delete a flow.

Endpoint

DELETE https://flows.generio.ai/flows/{flow_id}

Parameters

flow_id (required)

• Location: path
• Type: string

Responses

200

Successful Response

422

Validation Error

Code Examples

Copy and run these examples in your terminal or code editor. Make sure to replace YOUR_TOKEN with your actual authentication token.

cURL

curl -X DELETE "https://flows.generio.ai/flows/{flow_id}" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

wget

wget --header="Authorization: Bearer YOUR_TOKEN" \
  "https://flows.generio.ai/flows/{flow_id}" -O -

Python

import requests

url = "https://flows.generio.ai/flows/{flow_id}"
headers = {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
}

response = requests.delete(url, headers=headers)
print(response.json())

JavaScript

const url = "https://flows.generio.ai/flows/{flow_id}";
fetch(url, {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

PHP

<?php
$url = "https://flows.generio.ai/flows/{flow_id}";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_TOKEN",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>