Skip to content
Proud to collaborate with Microsoft for Startups

spad.site-deletion-delete-domains ​

Delete custom domains (CF aliases, ACM certs, DNS records)

Delete all custom domains for a SPAD site

Overview ​

PropertyValue
Workflow typeLinear
LibraryApp-spad
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
site_uuidstringYes—UUID of the SPAD site
organization_uuidstringYes—Organization UUID
cloud_connection_uuidstringYes—Cloud connection UUID
cloudfront_distribution_refstringNo—CloudFront distribution id (provider-native)
delete_resourcesbooleanNoTrueWhether to delete cloud resources
workflow_run_idstringNo——
workflow_run_uuidstringNo—Parent workflow run ID stamped by the DAG engine (legacy alias)

Output Schema ​

FieldTypeRequiredDefaultDescription
domains_deletedstringYes—'skipped' when delete_resources=False; otherwise True once domains are removed
domains_deleted_countintegerYes—Number of custom domains successfully deleted
domains_deleted_nameslistNo—Names of the domains that were deleted (success path only)
failure_reasonstringNo—Reason recorded on the failure path
workflow_run_idstringNo——
site_uuidstringNo—UUID of the SPAD site
organization_uuidstringNo—Organization UUID
cloud_connection_uuidstringNo—Cloud connection UUID
cloudfront_distribution_refstringNo—CloudFront distribution id (provider-native)
delete_resourcesbooleanNo—Whether to delete cloud resources
workflow_run_uuidstringNo—Parent workflow run ID stamped by the DAG engine (legacy alias)
errorstringNo—Engine-stamped failure metadata
error_typestringNo—Engine-stamped failure metadata
failed_at_statejsonNo—Engine-stamped failure metadata
failed_layerjsonNo—Engine-stamped failure metadata
failed_stepjsonNo—Engine-stamped failure metadata

States ​

StateInitialTerminalSuccessAuto-advanceDescription
pendingYesNo—runDomain deletion step accepted
runNoNo—completeDeleting domain/certificate/DNS resources
completedNoYesYes—Domain deletion completed
failedNoYesNo—Domain deletion failed

State Diagram ​

Transitions ​

FromActionToDescription
pendingrunrunStart domain deletion
runcompletecompletedMark domain deletion completed
* (any state)failfailedMark domain deletion failed

API Usage ​

bash
POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "spad.site-deletion-delete-domains",
  "initial_data": {
    "site_uuid": "value",
    "organization_uuid": "value",
    "cloud_connection_uuid": "value"
  }
}