---
title: "Delete a connection"
method: DELETE
path: "/v3/connections/{connectionId}"
tags: ["Resources"]
---

# Delete a connection

`DELETE /v3/connections/{connectionId}`

Deletes a connection. Pass `targetConnectionId` to move its maps and
workflows to another connection of the same provider first.

## Path parameters

- `connectionId` string, uuid, required

## Request body

- object
  - `targetConnectionId` string, uuid

## Response `204`

The connection was deleted.

## Other responses

- `400` — The request is malformed or a parameter failed validation.
- `401` — The token is missing, malformed or expired.
- `403` — The token doesn't grant access to this resource.
- `404` — The resource doesn't exist.
- `409` — The connection is in use by other users in your organization.

---

[API](https://skmtc.net/gitbookio/apis/carto-api.md) · [All operations](https://skmtc.net/gitbookio/apis/carto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitbookio/carto-api/revisions/019f79ecdd6c/schema)