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

# Update Connector Endpoint

`PUT /v1/connectors/{connector_id}`

## Request

- Base URL: `https://api.tryardent.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tryardent.com/v1/connectors/{connector_id}`
- Auth: none declared

Update connector. If connection_details changed, re-tests connection and resets indexing_status.

## Path parameters

- `connector_id` string, required

## Request body

- UpdateConnectorRequest
  - `name` string, nullable: New connector name.
  - `project_id` string, nullable: Move the connector to this project.
  - `connection_details` object, nullable: Replacement connection details for the source database.
  - `drop_extensions` string[], nullable: Extensions to drop on branches; omit to leave unchanged, `[]` clears.

## Response `200`

The updated connector row.

- ConnectorRow: Loose core of a connector response. The connector row is the most dynamic shape in the system; extra="allow" is the contract — responses carry many more columns and clients must tolerate fields not listed here. can_update/can_delete are added by the permission projection on create/get/update/list responses.
  - `id` string, required: Connector ID.
  - `org_id` string, required: Organization the connector belongs to.
  - `project_id` string, nullable: Project the connector belongs to.
  - `name` string, required: Connector name.
  - `service_name` string, required: Service type. `postgresql` today.
  - `status` string, nullable: Current connector status.
  - `created_at` string, nullable: When the connector was created.
  - `can_update` boolean, nullable: Whether the caller may update this connector.
  - `can_delete` boolean, nullable: Whether the caller may delete this connector.

## Other responses

- `400`: Validation error.
- `404`: Connector not found (or not visible to the caller).
- `409`: Another update to this connector is already running.
- `422`: Validation Error

## Changes

- **2026-09-11** `b2c512520b47`: 1 info
  - added the non-success response with the status `409`

[Operation history](https://skmtc.dev/tryardent/apis/tryardent-api/changes/v1/connectors/:connector_id/put.md)

---

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