companies

Create Storage Connection

Add a storage connection from typed configuration (platform admin). First one becomes default; secret encrypted, never returned.

A company's owners and accountants connect their OAuth drives (Dropbox, Google Drive, OneDrive, Box) with POST /storage-connections/oauth/{provider}/authorize instead — this create also accepts service-account / app-only modes and server-side providers (local, SharePoint, WebDAV, S3), which stay with a platform administrator (ZET-434).

post/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

Path parameters

company_idstring required

Headers

authorizationstring nullable

Cookies

access_tokenstring nullable

Request body

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.

labelstring required
credentialstring nullable
is_defaultboolean
enabledboolean
path_template_payablestring nullable
file_template_payablestring nullable
path_template_receivablestring nullable
file_template_receivablestring nullable

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.