u

docs/api/routes/company/create.md

@@ -0,0 +1,41 @@
+# `POST /company`
+
+Protected. Requires a valid session cookie (`credentials: 'include'`).
+
+Create company
+
+Creates a company and selects it for the current user.
+
+## Body (JSON)
+
+```json
+{
+  "iso639": "de",
+  "name": "Acme GmbH",
+  "taxrate": 19,
+  "reducedtaxrate": 7
+}
+```
+
+## Response `201`
+
+Created; selected company updated
+
+```json
+{
+  "company": { … },
+  "user": { … }
+}
+```
+
+## Errors
+
+| Status | Description |
+|--------|-------------|
+| 400 | Validation error — `{"error":"…"}` |
+| 401 | Unauthorized — `{"error":"…"}` |
+| 409 | Company name not available — `{"error":"…"}` |
+
+---
+
+_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._