---
title: "Partially update a Connector"
method: PATCH
path: "/workspace/connectors/{connector_id}"
tags: ["Connectors"]
---

# Partially update a Connector

`PATCH /workspace/connectors/{connector_id}`

Update one or more fields of an existing Connector without affecting other fields.

## Path parameters

- `connector_id` integer, required

## Request body

- union
  - object
    - `name` string
    - `active` boolean
    - `type` 'http' | 'storage' | 'live_ingest', required — * `http` - HTTP * `storage` - Storage * `live_ingest` - Live Ingest
    - `attributes` ConnectorHTTPAttributesRequest
      - `addresses` AddressRequest[], required
        - `active` boolean — Indicates if the address is active for use
        - `address` string, required — IPv4/IPv6 address or CNAME to resolve
        - `http_port` integer — Port number for HTTP connections
        - `https_port` integer — Port number for HTTPS connections
        - `modules` AddressModulesRequest
          - `load_balancer` AddressLoadBalancerModuleRequest
            - `server_role` 'primary' | 'backup' — * `primary` - Primary * `backup` - Backup
            - `weight` integer — Weight used in load balancing strategy
      - `connection_options` HTTPConnectionOptionsRequest
        - `dns_resolution` 'both' | 'force_ipv4' — * `both` - Both * `force_ipv4` - Force IPv4
        - `transport_policy` 'preserve' | 'force_https' | 'force_http' — * `preserve` - Preserve * `force_https` - Force HTTPS * `force_http` - Force HTTP
        - `http_version_policy` 'http1_1' — * `http1_1` - HTTP/1.1
        - `host` string — Optional custom host used to override the default target hostname during connection.
        - `path_prefix` string — Optional prefix to add to all request paths (e.g., '/v1').
        - `following_redirect` boolean — If true, automatically follows HTTP redirects from the target server.
        - `real_ip_header` string — Header name used to forward the original client IP address.
        - `real_port_header` string — Header name used to forward the original client port.
      - `modules` HTTPModulesRequest
        - `load_balancer` LoadBalancerModuleRequest
          - `enabled` boolean
          - `config` LoadBalancerModuleConfigRequest
            - `method` 'round_robin' | 'least_conn' | 'ip_hash' — * `round_robin` - Round Robin * `least_conn` - Least Connections * `ip_hash` - IP Hash
            - `max_retries` integer — Maximum number of retry attempts on connection failure.
            - `connection_timeout` integer — Maximum time (in seconds) to wait for a connection to be established.
            - `read_write_timeout` integer — Maximum time (in seconds) to wait for data read/write after connection.
        - `origin_shield` OriginShieldModuleRequest
          - `enabled` boolean
          - `config` OriginShieldConfigRequest
            - `origin_ip_acl` OriginIPACLRequest
              - …
            - `hmac` HMACRequest
              - …
  - object
    - `name` string
    - `active` boolean
    - `type` 'http' | 'storage' | 'live_ingest', required — * `http` - HTTP * `storage` - Storage * `live_ingest` - Live Ingest
    - `attributes` ConnectorStorageAttributesRequest
      - `bucket` string, required
      - `prefix` string

## Response `200`

Connector partially updated successfully.

- ConnectorResponse
  - `state` string
  - `data` union, required
    - object
      - `id` integer, required
      - `name` string, required
      - `last_editor` string, required
      - `last_modified` string, date-time, required
      - `created_at` string, date-time, required
      - `active` boolean
      - `product_version` string, required
      - `type` 'http' | 'storage' | 'live_ingest', required — * `http` - HTTP * `storage` - Storage * `live_ingest` - Live Ingest
      - `attributes` ConnectorHTTPAttributes, required
        - `addresses` Address[], required
          - `active` boolean — Indicates if the address is active for use
          - `address` string, required — IPv4/IPv6 address or CNAME to resolve
          - `http_port` integer — Port number for HTTP connections
          - `https_port` integer — Port number for HTTPS connections
          - `modules` AddressModules
            - `load_balancer` AddressLoadBalancerModule
              - …
        - `connection_options` HTTPConnectionOptions
          - `dns_resolution` 'both' | 'force_ipv4' — * `both` - Both * `force_ipv4` - Force IPv4
          - `transport_policy` 'preserve' | 'force_https' | 'force_http' — * `preserve` - Preserve * `force_https` - Force HTTPS * `force_http` - Force HTTP
          - `http_version_policy` 'http1_1' — * `http1_1` - HTTP/1.1
          - `host` string — Optional custom host used to override the default target hostname during connection.
          - `path_prefix` string — Optional prefix to add to all request paths (e.g., '/v1').
          - `following_redirect` boolean — If true, automatically follows HTTP redirects from the target server.
          - `real_ip_header` string — Header name used to forward the original client IP address.
          - `real_port_header` string — Header name used to forward the original client port.
        - `modules` HTTPModules
          - `load_balancer` LoadBalancerModule
            - `enabled` boolean
            - `config` LoadBalancerModuleConfig
              - …
          - `origin_shield` OriginShieldModule
            - `enabled` boolean
            - `config` OriginShieldConfig
              - …
    - object
      - `id` integer, required
      - `name` string, required
      - `last_editor` string, required
      - `last_modified` string, date-time, required
      - `created_at` string, date-time, required
      - `active` boolean
      - `product_version` string, required
      - `type` 'http' | 'storage' | 'live_ingest', required — * `http` - HTTP * `storage` - Storage * `live_ingest` - Live Ingest
      - `attributes` ConnectorStorageAttributes, required
        - `bucket` string, required
        - `prefix` string

## Other responses

- `400` — Validation Error
- `401` — Authentication Failed
- `403` — Permission Denied
- `404` — Not Found
- `405` — Method Not Allowed
- `406` — Not Acceptable
- `429` — Throttled
- `500` — Internal Server Error

---

[API](https://skmtc.dev/azion/apis/azion-api.md) · [All operations](https://skmtc.dev/azion/apis/azion-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azion/azion-api/revisions/bb3250697218/schema)