Retire a connector

DELETE 
/v1/admin/connectors/:connectorKey

Marks the connector retired. The row is not deleted — existing references stay resolvable so any in-flight request that has already resolved a route still completes — but the connector stops appearing in GET /connectors.

Rejected with 409 (CRT009002) if any active routing policy still targets this connector. Resolution path: PUT a replacement policy that does not target this connector first, then retry the retire.

Request

Responses

204

Connector retired successfully

400

Schema validation failed (GEN000000)

401

Missing or invalid authentication token (GEN001002) or Role unauthorized (GEN001006)

404

Connector not found or already retired.

409

Connector is still referenced by at least one active policy target.

500

Internal server error (GEN100000)

503

Connector-routing datastore temporarily unavailable (CRT103002)