Files
dashback/docs/api/routes/entity/create.md
seb e6c24654dd Align store calls with selected-company scoping and add entity numbers.
Drop companyId from company-scoped store wrappers and routes, add GET /entity/next-number plus optional number on entity create/update, and document dashdbschema API.md lookup in sibling-repos.
2026-08-07 06:22:13 +02:00

1.1 KiB

POST /entity

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

Create entity

Creates an entity in a company customer group and writes entityhistory (Erstellt). Optional number: omit to allocate the next customer number (type entity).

Body (JSON)

{
  "customergroupId": 1,
  "name": "Müller",
  "firstName": "Anna",
  "number": "10042"
}

Response 201

Created entity

{
  "entity": {
    "id": 1,
    "customergroupId": 1,
    "firstName": "…",
    "name": "…",
    "number": "…",
    "createdAt": "2026-08-10T00:00:00.000Z",
    "updatedAt": "2026-08-10T00:00:00.000Z"
  }
}

Errors

Status Description
400 Name/number required or no company selected — {"error":"…"}
401 Unauthorized — {"error":"…"}
403 Not authorized — {"error":"…"}
404 Company or customer group not found — {"error":"…"}
409 Number already in use — {"error":"…"}

Generated from @openapi JSDoc. Do not edit by hand — run npm run docs:api.