Skip to main content

delete-cloudflow-connection 

dci delete-cloudflow-connection <connectionId>

Deletes a connection. Returns 409 if the connection is referenced by one or more flows.

  • connectionId — Identifier of the resource.
Confirmation required

Interactive terminals show a confirmation prompt; scripts must pass --yes — see the CLI guide's Destructive commands. Deleting fails with 409 while any flow still references the connection; rebind or delete those flows first.

Examples​

# Preview the deletion locally without sending anything.
dci delete-cloudflow-connection <connection-id> --dry-run
# Delete without a prompt, for scripts.
dci delete-cloudflow-connection <connection-id> --yes
Exit code 0 and no output (HTTP 204); a connection still referenced by a flow returns 409.

Output​

On success, this command produces no response data.

Errors​

On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.

HTTP status to exit code mapping
HTTP statusExit codeError codeMeaning
40030VALIDATION_ERRORThe arguments or request body were rejected. Review the command's flags and payload.
40110AUTHENTICATION_FAILEDNot signed in, or the API token is invalid. Run dci login or check DCI_API_KEY.
40311PERMISSION_DENIEDThe DoiT user or the active customer context does not have access.
40420RESOURCE_NOT_FOUNDThe requested resource does not exist. Check the identifier argument.
40921RESOURCE_CONFLICTThe operation conflicts with the resource's current state.
50040API_SERVER_ERRORThe API failed to process the request. Retryable; contact DoiT support if it persists.

Aliases: deletecloudflowconnection