---
title: "List Connectors"
method: GET
path: "/workspace/connectors"
tags: ["Connectors"]
---

# List Connectors

`GET /workspace/connectors`

List all Connectors owned by your account.

## Query parameters

- `active` boolean
- `fields` string
- `id` integer
- `last_editor` string
- `last_modified__gte` string, date-time
- `last_modified__lte` string, date-time
- `name` string
- `ordering` string
- `page` integer
- `page_size` integer
- `search` string
- `type__in` string

## Response `200`

List of connectors retrieved successfully.

- PaginatedConnectorList
  - `count` integer — Total number of items
  - `total_pages` integer — Total number of pages
  - `page` integer — Current page number
  - `page_size` integer — Number of items per page
  - `next` string, uri, nullable — URL to the next page of results
  - `previous` string, uri, nullable — URL to the previous page of results
  - `results` Connector[]
    - union
      - 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
              - …
          - `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
              - …
            - `origin_shield` OriginShieldModule
              - …
      - 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)