---
title: "Retrieve details of a Connector"
method: GET
path: "/workspace/connectors/{connector_id}"
tags: ["Connectors"]
---

# Retrieve details of a Connector

`GET /workspace/connectors/{connector_id}`

Retrieve details of a specific Connector in your account.

## Path parameters

- `connector_id` integer, required

## Query parameters

- `fields` string

## Response `200`

Connector details retrieved 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)