Delete Workflow

Delete an existing workflow using workflow id

Endpoint

DELETE /api/workflows/{id}

Authentication

This endpoint requires API key authentication.

Headers

Header	Value	Description
Authorization	Bearer <YOUR_API_KEY>	Your groundcover API key
Accept	*/*	Accept any response format

Path Parameters

Parameter	Type	Description
id	string	The UUID of the workflow to delete

Example Request

curl -L \
  --request DELETE \
  --url 'https://api.groundcover.com/api/workflows/{id}' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Accept: */*'

Response

Success Response

Status Code: 200 OK

{
  "message": "OK"
}

Notes

• Once a workflow is deleted, it cannot be recovered

• The deletion is immediate and permanent

• All associated workflow executions and history are also removed

• The API returns HTTP 200 status code for both successful deletions and "not found" cases