---
title: "Revoke (delete) a connector - moves a model key's projects to another model key"
method: DELETE
path: "/connectors/{connectorId}"
tags: ["connectors"]
---

# Revoke (delete) a connector - moves a model key's projects to another model key

`DELETE /connectors/{connectorId}`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/connectors/{connectorId}`
- Auth: none declared

Removes a connector. Each project that uses a model key moves to another model key of the organization, from the same provider when one exists. The API refuses the revoke with 409 when a project uses a tracker or repository connection, or uses the last model key of the organization. The error names those projects.

## Path parameters

- `connectorId` string, required

## Response `200`

Revoked

- RevokeConnectorResponse
  - `ok` true, required
  - `affectedProjectCount` integer, required
  - `replacementConnectorId` string, nullable, required

## Other responses

- `403`: Role insufficient
- `404`: Not found
- `409`: A project still uses the connector and nothing can take its place

---

[API](https://skmtc.dev/letsship/apis/ship-api.md) · [All operations](https://skmtc.dev/letsship/apis/ship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsship/apis/ship-api/revisions/e6eac1bcadd4?raw)