---
title: "List Storage Connections"
method: GET
path: "/companies/{company_id}/storage-connections"
tags: ["companies"]
---

# List Storage Connections

`GET /companies/{company_id}/storage-connections`

## Request

- Base URL: `https://app.zeno-works.ch` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zeno-works.ch/companies/{company_id}/storage-connections`
- Auth: none declared

List a company's storage connections (jwt, scoped).

## Path parameters

- `company_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- StorageConnectionListResponse: ``GET /companies/<id>/storage-connections`` → ``{"storage_connections": [...]}``.
  - `storage_connections` StorageConnectionOut[], required
    - `id` string, required
    - `company_id` string, required
    - `provider` 'sharepoint' | 'local' | 'dropbox' | 'gdrive' | 'onedrive' | 'box' | 'webdav' | 's3' | 'platform', required: Which storage backend a :class:`~invoiage_db.models.company.StorageConnection` dispatches to (the unified archive-destination model — cloud-storage foundation). ``sharepoint`` (Graph app-only) and ``local`` (mounted volume) are the two behavior-preserving providers folded in from the old per-table drives; the remaining values are reserved for the later provider driver plans. ``platform`` is the **system-managed** default archive target (doc/architecture.md §"Platform archive"): a platform-owned S3 bucket with a per-company key prefix, seeded for every company at creation so archival always has a destination. Its endpoint/bucket/credentials live in platform settings (``PLATFORM_ARCHIVE_*``), never per-row; tenants cannot create, mutate, or delete these rows.
    - `supports_ingest` boolean
    - `label` string, required
    - `enabled` boolean, required
    - `is_default` boolean, required
    - `config` object, required
    - `status` 'connected' | 'reconnect_required' | 'error', required: Operational state of a storage connection (cloud-storage foundation §1). ``connected`` = healthy; ``reconnect_required`` = a revoked/expired credential needs operator re-auth (surfaces a Connect/Reconnect affordance, never a silent retry); ``error`` = a transient/other failure recorded in ``last_error``.
    - `resource_root_id` string, nullable
    - `token_expiry` string, date-time, nullable
    - `last_success_at` string, date-time, nullable
    - `last_error` string, nullable
    - `provider_account_id` string, nullable
    - `path_template_payable` string, nullable
    - `file_template_payable` string, nullable
    - `path_template_receivable` string, nullable
    - `file_template_receivable` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zeno-works/apis/zeno-api.md) · [All operations](https://skmtc.dev/zeno-works/apis/zeno-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeno-works/apis/zeno-api/revisions/1eb93dde146c?raw)