Delete workflow

DELETE

/api/v1/workflows/{id}

Code sample: cURL

curl -X DELETE 'https://api.justcrawl.io/api/v1/workflows/a47ac10b-58cc-4372-a567-0e02b2c3d479' \
  -H 'Authorization: Bearer $JUSTCRAWL_API_KEY'

• Production

Soft-delete a workflow by ID — the row stays in the database with status='deleted' so completed jobs that referenced it can still resolve their workflow at audit time. The accompanying smart-workflow config (if any) is hard-deleted via deleteSmartWorkflow. Returns 204 with no body on success.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

The workflow’s stable logical id — the workflowId field of a workflow object, NOT its id field. id is the per-version row key and 404s here.

Responses

204

Workflow soft-deleted; smart-workflow config (if any) hard-deleted.

401

Missing or invalid authentication token

Media typeapplication/json

object

error

string

Example

{
  "error": "Missing or invalid authentication token"
}

403

Insufficient permissions for this operation

Media typeapplication/json

object

error

string

Example

{
  "error": "No organization. Complete onboarding first."
}

404

Resource not found

Media typeapplication/json

object

error

string

Example

{
  "error": "Workflow not found"
}

500

Unexpected server error. Logs and PostHog $exception capture

Media typeapplication/json

object

error

string

Example

{
  "error": "Something went wrong"
}