API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · customer_org_units

Customer Org Unit Schema

Schema-ID
customer_org_unit
Collection
customer_org_units
Permissions
  • Lesencustomer_org_unit_view
  • Anlegencustomer_org_unit_create
  • Änderncustomer_org_unit_edit
  • Löschencustomer_org_unit_delete

Felder

Customer Org Unit Schema

customer_org_units4 Permissions

Organizational unit (department/team/site) inside a customer organization. Lives in the MSP tenant and is anchored to a customer ORGANIZATION party via customerPartyId. Forms a tree via parentUnitId. Used by the customer org chart and as an addressing target for service-catalog approval workflows (CUSTOMER_OU_HEAD DSL).

customerPartyIduuiderforderlich

FK to the customer ORGANIZATION party this OU belongs to.

parentUnitIdstringoptional

FK to the parent customer_org_unit (same customerPartyId). null for the root unit. Exactly one root OU per customer is allowed.

PatternDefault: nullnullable
namestringerforderlich

Display name, e.g. "IT", "Vertrieb Nord", "Werk Hannover".

1–200 Zeichen
shortCodestringoptional

Optional short code used in compact displays (e.g. "IT", "VTN").

max 20 ZeichenDefault: nullnullable
headPersonPartyIdstringoptional

PERSON party that heads this OU. Must be linked to customerPartyId via party_relationship. Used by the CUSTOMER_OU_HEAD approver-DSL node.

PatternDefault: nullnullable
costCenterstringoptional

Free-text cost-center label used by the customer (informational only).

max 100 ZeichenDefault: nullnullable
notesstringoptional
max 2000 ZeichenDefault: nullnullable

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

  • GET /api/v1/customer_org_units — Liste, paginiert + filterbar
  • GET /api/v1/customer_org_units/<id> — Einzelne Entity
  • POST /api/v1/customer_org_units — Anlegen
  • PATCH /api/v1/customer_org_units/<id> — Teil-Update
  • DELETE /api/v1/customer_org_units/<id> — Soft-Delete
  • GET /api/v1/customer_org_units/<id>/timeline — Audit + Aktivitäten

Suche