---
title: "Update an API connector"
method: PATCH
path: "/v2/api-connectors/{apiConnectorId}"
tags: ["API connectors"]
---

# Update an API connector

`PATCH /v2/api-connectors/{apiConnectorId}`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/api-connectors/{apiConnectorId}`
- Auth: HTTP bearer

This endpoint updates one or more fields on an existing API connector. For more information on API connectors, see [Configure API credentials and connectors in Sigma](https://help.sigmacomputing.com/docs/configure-api-credentials-and-connectors-in-sigma).

### Usage notes
- Retrieve the **apiConnectorId** by calling the [/v2/api-connectors](https://help.sigmacomputing.com/reference/list-api-connectors) endpoint.
- The user making this request must be assigned an account type with the **Manage API connectors** permission enabled and must have **Can edit** access to the connector.
- Omitted fields are left unchanged. Pass `null` for `authId` to remove the credential association.

### Usage scenarios
- **Endpoint migration:** Update the connector URL or parameters when an external API changes its interface.
- **Credential rotation:** Rebind the connector to a new credential after rotating secrets.

## Path parameters

- `apiConnectorId` string, required

## Request body

- object
  - `name` string: New display name.
  - `description` string, nullable: New description. Pass `null` to clear.
  - `params` V2ApiConnectorsApiConnectorIdPatchRequestBodyContentApplicationJsonSchemaParams
    - `method` 'GET' | 'POST' | 'DELETE' | 'PATCH' | 'PUT' | 'OPTIONS' | 'HEAD', required: HTTP method to invoke.
    - `url` string, required: Request URL. Must resolve to a hostname matching the associated credential's allowlist.
    - `headers` V2ApiConnectorsApiConnectorIdPatchRequestBodyContentApplicationJsonSchemaParamsHeadersItems[], required: Static or dynamic request headers.
      - `key` string, required
      - `mode` 'static' | 'dynamic', required
      - `value` string, nullable
      - `type` 'array' | 'boolean' | 'number' | 'object' | 'raw' | 'string'
      - `shape` union
        - ParamShapeNode0
          - `type` ParamShapeNodeOneOf0TypeItems[], required
        - ParamShapeNode1
          - `type` ParamShapeNodeOneOf1TypeItems[], required
        - ParamShapeNode2
          - `type` ParamShapeNodeOneOf2TypeItems[], required
        - ParamShapeNode3
          - `type` ParamShapeNodeOneOf3TypeItems[], required
          - `properties` object, required
        - ParamShapeNode4
          - `type` ParamShapeNodeOneOf4TypeItems[], required
          - `items` ParamShapeNode, required (recursive)
        - object
    - `pathParams` V2ApiConnectorsApiConnectorIdPatchRequestBodyContentApplicationJsonSchemaParamsPathParamsItems[], required: Path parameter placeholders resolved into the URL.
      - `key` string, required
      - `mode` 'static' | 'dynamic', required
      - `value` string, nullable
      - `type` 'array' | 'boolean' | 'number' | 'object' | 'raw' | 'string'
      - `shape` union
        - ParamShapeNode0
          - `type` ParamShapeNodeOneOf0TypeItems[], required
        - ParamShapeNode1
          - `type` ParamShapeNodeOneOf1TypeItems[], required
        - ParamShapeNode2
          - `type` ParamShapeNodeOneOf2TypeItems[], required
        - ParamShapeNode3
          - `type` ParamShapeNodeOneOf3TypeItems[], required
          - `properties` object, required
        - ParamShapeNode4
          - `type` ParamShapeNodeOneOf4TypeItems[], required
          - `items` ParamShapeNode, required (recursive)
        - object
    - `queryParams` V2ApiConnectorsApiConnectorIdPatchRequestBodyContentApplicationJsonSchemaParamsQueryParamsItems[], required: Query string parameters.
      - `key` string, required
      - `mode` 'static' | 'dynamic', required
      - `value` string, nullable
      - `type` 'array' | 'boolean' | 'number' | 'object' | 'raw' | 'string'
      - `shape` union
        - ParamShapeNode0
          - `type` ParamShapeNodeOneOf0TypeItems[], required
        - ParamShapeNode1
          - `type` ParamShapeNodeOneOf1TypeItems[], required
        - ParamShapeNode2
          - `type` ParamShapeNodeOneOf2TypeItems[], required
        - ParamShapeNode3
          - `type` ParamShapeNodeOneOf3TypeItems[], required
          - `properties` object, required
        - ParamShapeNode4
          - `type` ParamShapeNodeOneOf4TypeItems[], required
          - `items` ParamShapeNode, required (recursive)
        - object
    - `body` string, required: Raw request body template.
  - `config` V2ApiConnectorsApiConnectorIdPatchRequestBodyContentApplicationJsonSchemaConfig
    - `timeout` V2ApiConnectorsApiConnectorIdPatchRequestBodyContentApplicationJsonSchemaConfigTimeout: Per-request timeout configuration.
      - `requestSec` number, double, required
    - `retry` V2ApiConnectorsApiConnectorIdPatchRequestBodyContentApplicationJsonSchemaConfigRetry: Retry policy. `retryableStatusCodes` are HTTP codes that should trigger a retry.
      - `maxRetries` number, double, required
      - `retryableStatusCodes` number[], required
    - `redirects` V2ApiConnectorsApiConnectorIdPatchRequestBodyContentApplicationJsonSchemaConfigRedirects: HTTP redirect handling.
      - `maxRedirects` number, double, required
    - `rateLimit` V2ApiConnectorsApiConnectorIdPatchRequestBodyContentApplicationJsonSchemaConfigRateLimit: Rate limit applied to outbound requests from this connector.
      - `maxRequestsPerWindow` number, double, required
  - `authId` string, nullable: New credential binding. Pass `null` to remove the credential.

## Response `200`

The response body.

- ApiConnectorsUpdateApiConnectorResponse200
  - `apiConnectorId` string, required: Unique identifier of the API connector.
  - `name` string, required: Display name of the connector.
  - `params` V2ApiConnectorsApiConnectorIdPatchResponsesContentApplicationJsonSchemaParams, required
    - `method` 'GET' | 'POST' | 'DELETE' | 'PATCH' | 'PUT' | 'OPTIONS' | 'HEAD', required: HTTP method to invoke.
    - `url` string, required: Request URL. Must resolve to a hostname matching the associated credential's allowlist.
    - `headers` V2ApiConnectorsApiConnectorIdPatchResponsesContentApplicationJsonSchemaParamsHeadersItems[], required: Static or dynamic request headers.
      - `key` string, required
      - `mode` 'static' | 'dynamic', required
      - `value` string, nullable
      - `type` 'array' | 'boolean' | 'number' | 'object' | 'raw' | 'string'
      - `shape` union
        - ParamShapeNode0
          - `type` ParamShapeNodeOneOf0TypeItems[], required
        - ParamShapeNode1
          - `type` ParamShapeNodeOneOf1TypeItems[], required
        - ParamShapeNode2
          - `type` ParamShapeNodeOneOf2TypeItems[], required
        - ParamShapeNode3
          - `type` ParamShapeNodeOneOf3TypeItems[], required
          - `properties` object, required
        - ParamShapeNode4
          - `type` ParamShapeNodeOneOf4TypeItems[], required
          - `items` ParamShapeNode, required (recursive)
        - object
    - `pathParams` V2ApiConnectorsApiConnectorIdPatchResponsesContentApplicationJsonSchemaParamsPathParamsItems[], required: Path parameter placeholders resolved into the URL.
      - `key` string, required
      - `mode` 'static' | 'dynamic', required
      - `value` string, nullable
      - `type` 'array' | 'boolean' | 'number' | 'object' | 'raw' | 'string'
      - `shape` union
        - ParamShapeNode0
          - `type` ParamShapeNodeOneOf0TypeItems[], required
        - ParamShapeNode1
          - `type` ParamShapeNodeOneOf1TypeItems[], required
        - ParamShapeNode2
          - `type` ParamShapeNodeOneOf2TypeItems[], required
        - ParamShapeNode3
          - `type` ParamShapeNodeOneOf3TypeItems[], required
          - `properties` object, required
        - ParamShapeNode4
          - `type` ParamShapeNodeOneOf4TypeItems[], required
          - `items` ParamShapeNode, required (recursive)
        - object
    - `queryParams` V2ApiConnectorsApiConnectorIdPatchResponsesContentApplicationJsonSchemaParamsQueryParamsItems[], required: Query string parameters.
      - `key` string, required
      - `mode` 'static' | 'dynamic', required
      - `value` string, nullable
      - `type` 'array' | 'boolean' | 'number' | 'object' | 'raw' | 'string'
      - `shape` union
        - ParamShapeNode0
          - `type` ParamShapeNodeOneOf0TypeItems[], required
        - ParamShapeNode1
          - `type` ParamShapeNodeOneOf1TypeItems[], required
        - ParamShapeNode2
          - `type` ParamShapeNodeOneOf2TypeItems[], required
        - ParamShapeNode3
          - `type` ParamShapeNodeOneOf3TypeItems[], required
          - `properties` object, required
        - ParamShapeNode4
          - `type` ParamShapeNodeOneOf4TypeItems[], required
          - `items` ParamShapeNode, required (recursive)
        - object
    - `body` string, required: Raw request body template.
    - `bodyParams` V2ApiConnectorsApiConnectorIdPatchResponsesContentApplicationJsonSchemaParamsBodyParamsItems[], required: Dynamic parameters extracted from `body`.
      - `key` string, required
      - `mode` 'static' | 'dynamic', required
      - `value` string, nullable
      - `type` 'array' | 'boolean' | 'number' | 'object' | 'raw' | 'string'
      - `shape` union
        - ParamShapeNode0
          - `type` ParamShapeNodeOneOf0TypeItems[], required
        - ParamShapeNode1
          - `type` ParamShapeNodeOneOf1TypeItems[], required
        - ParamShapeNode2
          - `type` ParamShapeNodeOneOf2TypeItems[], required
        - ParamShapeNode3
          - `type` ParamShapeNodeOneOf3TypeItems[], required
          - `properties` object, required
        - ParamShapeNode4
          - `type` ParamShapeNodeOneOf4TypeItems[], required
          - `items` ParamShapeNode, required (recursive)
        - object
  - `config` V2ApiConnectorsApiConnectorIdPatchResponsesContentApplicationJsonSchemaConfig, required
    - `timeout` V2ApiConnectorsApiConnectorIdPatchResponsesContentApplicationJsonSchemaConfigTimeout, required: Per-request timeout configuration.
      - `requestSec` number, double, required
    - `retry` V2ApiConnectorsApiConnectorIdPatchResponsesContentApplicationJsonSchemaConfigRetry, required: Retry policy. `retryableStatusCodes` are HTTP codes that should trigger a retry.
      - `maxRetries` number, double, required
      - `retryableStatusCodes` number[], required
    - `redirects` V2ApiConnectorsApiConnectorIdPatchResponsesContentApplicationJsonSchemaConfigRedirects, required: HTTP redirect handling.
      - `maxRedirects` number, double, required
    - `rateLimit` V2ApiConnectorsApiConnectorIdPatchResponsesContentApplicationJsonSchemaConfigRateLimit, required: Rate limit applied to outbound requests from this connector.
      - `maxRequestsPerWindow` number, double, required
  - `createdBy` string, required: The identifier of the user who created this object.
  - `updatedBy` string, required: The identifier of the user or process that last updated this object.
  - `createdAt` string, date-time, required: When the object was created.
  - `updatedAt` string, date-time, required: When the object was last updated.
  - `description` string: Human-readable description.
  - `authId` string, nullable: Identifier of the API credential (`apiCredentialId`) used to authenticate requests. `null` if unauthenticated.

---

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