curl --request POST \
  --url https://api.comstruct.com/v1/projects/{id}/work-types \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
[
  {
    "code": "1000",
    "title": "Rohbau",
    "parent": "",
    "description": "Rohbauarbeiten Gebäude A"
  }
]
'

[
  {
    "code": "1000",
    "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "Rohbau",
    "parent": "100",
    "description": "Rohbauarbeiten Gebäude A",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
]

Projects

Import project work types

Erforderliche Berechtigungen: projects:write

Erstellt oder aktualisiert eine oder mehrere Kostenstellen / Arbeitstypen (Struktur) für ein Projekt. Der Abgleich erfolgt über das eindeutige Paar (project_id, code). Doppelte code-Werte in derselben Anfrage behalten die letzte Zeile. Ausgelassene parent- und description-Felder werden als leere Zeichenkette gespeichert, damit ein Re-Import bestehende Werte überschreibt. Leere oder nur aus Leerzeichen bestehende code- oder title-Werte führen zu HTTP 400; der Batch wird nicht teilweise importiert.

POST

projects

{id}

work-types

curl --request POST \
  --url https://api.comstruct.com/v1/projects/{id}/work-types \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
[
  {
    "code": "1000",
    "title": "Rohbau",
    "parent": "",
    "description": "Rohbauarbeiten Gebäude A"
  }
]
'

[
  {
    "code": "1000",
    "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "Rohbau",
    "parent": "100",
    "description": "Rohbauarbeiten Gebäude A",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
]

Overview

Imports cost centers / work types (project structure) into a project. Existing rows with the same code are updated (title, parent, description). Resolve the project id first, for example with GET /projects/byProjectNumber/{project_number}.

Permissions

Scope	Description
`projects:write`	Create and update projects

Behavior

Matching uses (project_id, code).
Duplicate code values in the same request keep the last row.
Omitted parent or description fields are stored as an empty string so a re-import overwrites existing values.
Blank or whitespace-only code or title values return HTTP 400; the batch is not partially imported.
parent is only a number — there is no foreign-key check against the parent cost center.
If the project is not visible to the API key’s tenant, the API responds with 403.

Response codes

Code	Description
`201`	Work types created or updated
`400`	Invalid request
`401`	Unauthorized
`403`	Project access denied or project not found

Authorizations

X-API-Key

string

header

required

API-Schlüssel zur Authentifizierung. Kontaktieren Sie Ihren Customer Success Manager, um einen API-Schlüssel zu erhalten.

Jeder Endpunkt erfordert spezifische Berechtigungen (Scopes); die erforderlichen Scopes werden pro Endpunkt angezeigt.

Path Parameters

string<uuid>

required

Projekt-ID (UUID)

Body

application/json

code

string

required

Eindeutige Kostenstellennummer innerhalb des Projekts

Example:

"1000"

title

string

required

Bezeichnung der Kostenstelle

Example:

"Rohbau"

parent

string

Optionale Nummer der übergeordneten Kostenstelle

Example:

"100"

description

string

Optionale Beschreibung der Kostenstelle

Example:

"Rohbauarbeiten Gebäude A"

Response

Kostenstellen erfolgreich erstellt oder aktualisiert

code

string

required

Eindeutige Kostenstellennummer innerhalb des Projekts

Example:

"1000"

project_id

string<uuid>

required

Projekt-ID

title

string | null

Bezeichnung der Kostenstelle

Example:

"Rohbau"

parent

string | null

Nummer der übergeordneten Kostenstelle

Example:

"100"

description

string | null

Optionale Beschreibung der Kostenstelle

Example:

"Rohbauarbeiten Gebäude A"

created_at

string<date-time>

Erstellungszeitpunkt

updated_at

string<date-time>

Zeitpunkt der letzten Aktualisierung

Overview

Projects

Deliveries

Invoices

Invoice dimensions

Suppliers

Purchase orders

Orders (Supplier)

Master data

Q-Point Integration

Workflows

Calendar

IDS Orders

Import project work types

Overview

Permissions

Behavior

Response codes

Authorizations

Path Parameters

Body

Response

​Overview

​Permissions

​Behavior

​Response codes

Authorizations

Path Parameters

Body

Response

Overview

Permissions

Behavior

Response codes