Files
dashback/docs/api/routes/company/create.md
seb 1860f38640 Add delivery and supplier HTTP APIs with expanded response docs.
Wire store-backed CRUD for goods receipts and suppliers, and teach the API doc generator to expand $ref/allOf/array samples so route markdown shows full JSON shapes.
2026-08-06 05:32:48 +02:00

876 B

POST /company

Protected. Requires a valid session cookie (credentials: 'include').

Create company

Creates a company and selects it for the current user.

Body (JSON)

{
  "iso639": "de",
  "name": "Acme GmbH",
  "taxrate": 19,
  "reducedtaxrate": 7
}

Response 201

Created; selected company updated

{
  "company": {
    "id": 1,
    "iso639": "…",
    "name": "…",
    "taxrate": 1,
    "reducedtaxrate": 1
  },
  "user": {
    "id": 1,
    "email": "user@example.com",
    "selectedCompanyId": 1,
    "picture": "…"
  }
}

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.