---
title: "Update Storage Ingest Source"
method: PUT
path: "/storage-ingest-sources/{source_id}"
tags: ["integrations"]
---

# Update Storage Ingest Source

`PUT /storage-ingest-sources/{source_id}`

## 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/storage-ingest-sources/{source_id}`
- Auth: none declared

Partial update of a cloud-drive ingest source — a drive scan (accountant/owner).
Enabling requires a base folder; the base folder can be re-picked but never cleared.

## Path parameters

- `source_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- StorageIngestSourceUpdate: ``PUT /storage-ingest-sources/<id>`` body (admin) — partial update. Unset fields are not modified. ``base_folder_ref`` may be re-picked but never cleared (min_length 1) — an enabled source always stays folder-bounded.
  - `label` string, nullable
  - `base_folder_ref` string, nullable
  - `base_folder_label` string, nullable
  - `direction` 'payable' | 'receivable'
  - `enabled` boolean, nullable
  - `poll_batch_cap` integer, nullable
  - `type_allowlist` string[], nullable
  - `include_existing` boolean, nullable

## Response `200`

Successful Response

- StorageIngestSourceResponse: ``GET/POST/PUT /storage-ingest-sources/...`` → ``{"storage_ingest_source": ...}``.
  - `storage_ingest_source` StorageIngestSourceOut, required: Serialized cloud-drive ingest source (no secret — credentials live on the referenced storage connection).
    - `id` string, required
    - `company_id` string, required
    - `storage_connection_id` string, required
    - `label` string, required
    - `enabled` boolean, required
    - `poll_batch_cap` integer, nullable
    - `base_folder_ref` string, nullable
    - `base_folder_label` string, nullable
    - `direction` 'payable' | 'receivable', required
    - `type_allowlist` string[], nullable
    - `ingest_since` string, date-time, required
    - `include_existing` boolean, required
    - `last_sync_at` string, date-time, nullable
    - `last_sync_error` 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)