---
title: "Create Filesystem Source"
method: POST
path: "/companies/{company_id}/filesystem-sources"
tags: ["companies"]
---

# Create Filesystem Source

`POST /companies/{company_id}/filesystem-sources`

## 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}/filesystem-sources`
- Auth: none declared

Add a filesystem ingest source to a company (platform admin — a server path).
No secret.

## Path parameters

- `company_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- FilesystemSourceCreate: ``POST /companies/<id>/filesystem-sources`` body (admin). No secret.
  - `label` string, required
  - `root_path` string, required
  - `direction` 'payable' | 'receivable'
  - `enabled` boolean
  - `poll_batch_cap` integer, nullable

## Response `201`

Successful Response

- FilesystemSourceResponse: ``GET/POST/PUT /filesystem-sources/...`` → ``{"filesystem_source": ...}``.
  - `filesystem_source` FilesystemSourceOut, required: Serialized filesystem ingest source (no secret — this entity has none).
    - `id` string, required
    - `company_id` string, required
    - `label` string, required
    - `enabled` boolean, required
    - `poll_batch_cap` integer, nullable
    - `root_path` string, required
    - `direction` 'payable' | 'receivable', required

## 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)