---
title: "Delete Connector Endpoint"
method: DELETE
path: "/v1/connectors/{connector_id}"
tags: ["v1-connectors"]
---

# Delete Connector Endpoint

`DELETE /v1/connectors/{connector_id}`

Delete connector and all associated resources.

Cleanup handled by the DBOS connector-delete workflow:
- Branching engine infrastructure (replication pipeline, compute, slot)
- Delayed stored credential purge after DB finalization
- Database record

Args:
    force: When true, bypass the in-flight WAL/Kafka drain wait
        (ARD-870). Customer accepts that any un-replicated data is
        abandoned; the un-drained delta is recorded in cleanup_failures
        for operator triage.

## Path parameters

- `connector_id` string, required

## Query parameters

- `force` boolean

## Response `202`

Delete accepted (or already in progress). Poll `GET /v1/operations/{operation_id}`.

- OperationHandle — 202 acceptance body for async endpoints (branch create today). Declared on routes so the OpenAPI spec documents the handle shape. Handlers keep building the dict by hand; declaring this model on a route is spec-only and never changes a live response.
  - `operation_id` string, required — Operation to poll at `GET /v1/operations/{operation_id}`.
  - `status` 'pending' | 'running' | 'completed' | 'failed', required — Lifecycle status of an async operation. Mirrors the async_operations_status_valid CHECK constraint.
  - `type` 'connector_engine_setup' | 'connector_reset' | 'connector_deep_reset' | 'connector_discovery' | 'connector_delete' | 'connector_secret_purge' | 'connector_rollout' | 'connector_replication_rollback' | 'connector_debezium_cutover' | 'connector_debezium_shadow_cleanup' | 'environment_deploy' | 'environment_destroy' | 'branch_create' | 'branch_delete', required — Discriminator for an async operation. Must match the async_operations_type_valid CHECK constraint in the migration — extending the set requires a migration to widen the constraint AND a worker registered in the dispatcher.
  - `resource_id` string, nullable, required — ID of the resource being created or acted on (the branch ID for branch create).

## Other responses

- `403` — No delete permission on this connector.
- `404` — Connector not found (or not visible to the caller).
- `409` — Deletion is locked, or a conflicting delete is active.
- `422` — Validation Error
- `503` — Ardent could not start the work — safe to retry.

---

[API](https://skmtc.net/tryardent/apis/fastapi.md) · [All operations](https://skmtc.net/tryardent/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryardent/fastapi/versions/f92d8d54bae2/schema)