---
title: "Update a connector (display name and/or re-encrypt secret)"
method: PATCH
path: "/connectors/{connectorId}"
tags: ["connectors"]
---

# Update a connector (display name and/or re-encrypt secret)

`PATCH /connectors/{connectorId}`

## Request

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

## Path parameters

- `connectorId` string, required

## Request body

- UpdateConnectorRequest
  - `displayName` string, nullable
  - `secret` union
    - LinearTrackerSecret
      - `accessToken` string, required
      - `refreshToken` string
      - `expiresAt` integer
      - `workspaceId` string, required
      - `workspaceName` string
      - `apiKey` string
    - GithubScmSecret
      - `appId` string, required
      - `installationId` string, required
      - `privateKeyPem` string, required
      - `botLogin` string
      - `botUserId` string
    - AnthropicLlmSecret
      - `apiKey` string, required
    - OpenaiLlmSecret
      - `apiKey` string

## Response `200`

Updated

- Connector
  - `id` string, required
  - `orgId` string, required
  - `vendor` string, required
  - `vendorKind` 'tracker' | 'scm' | 'llm' | 'notification', required
  - `externalOrgId` string, required
  - `displayName` string, nullable, required
  - `credentialType` 'oauth' | 'api', nullable, required
  - `createdAt` integer, required
  - `updatedAt` integer, required

## Other responses

- `403`: Role insufficient
- `404`: Not found

---

[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)