{"openapi":"3.0.3","servers":[{"url":"/public"}],"info":{"title":"Akarion GRC Public API","version":"1.0.0","description":"Stable public REST API for syncing objects with Akarion GRC. Authenticate with an API token created by a partition admin in the application, sent as `Authorization: Bearer <token>`. The token is bound to a single partition; all endpoints operate on that partition. Prefer this API over the internal application API — its contract is versioned and stable.\n\nTranslatable fields (`label`, `description`) are single-language: set the `Accept-Language` header to choose which language is read and written. It defaults to English (`en`) when omitted."},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AcceptLanguage":{"name":"Accept-Language","in":"header","required":false,"schema":{"type":"string","example":"de"},"description":"Language for translatable fields (`label`, `description`), as a two-letter code such as `en` or `de`. Reads return this language (falling back to English); writes store text in this language, leaving other languages untouched. Defaults to `en` when omitted."}},"schemas":{"ContactRole":{"type":"object","properties":{"id":{"type":"string","description":"Stable identifier, unchanged across updates.","example":"3fa2b710-4c6e-4b7e-9f21-8a4c31de0000"},"externalReference":{"type":"string","description":"Free-text reference to the object in an external system. Filterable on the list endpoint — use it as the correlation key for syncs.","example":"ROLE-DPO"},"label":{"type":"string","example":"Data Protection Officer"},"description":{"type":"string","example":"Accountable for data protection compliance"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"example":"ACTIVE"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","label"]},"Department":{"type":"object","properties":{"id":{"type":"string","description":"Stable identifier, unchanged across updates.","example":"3fa2b710-4c6e-4b7e-9f21-8a4c31de0000"},"externalReference":{"type":"string","description":"Free-text reference to the object in an external system. Filterable on the list endpoint — use it as the correlation key for syncs.","example":"DEPT-ITOPS"},"label":{"type":"string","example":"IT Operations"},"description":{"type":"string","example":"Runs internal infrastructure and support"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"example":"ACTIVE"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","label"]},"HardwareAsset":{"type":"object","properties":{"id":{"type":"string","description":"Stable identifier, unchanged across updates.","example":"3fa2b710-4c6e-4b7e-9f21-8a4c31de0000"},"externalReference":{"type":"string","description":"Free-text reference to the object in an external system. Filterable on the list endpoint — use it as the correlation key for syncs.","example":"HW-LAPTOPS"},"label":{"type":"string","example":"Employee laptops"},"description":{"type":"string","example":"Fleet of company-issued laptops"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"example":"ACTIVE"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","label"]},"NetworkAsset":{"type":"object","properties":{"id":{"type":"string","description":"Stable identifier, unchanged across updates.","example":"3fa2b710-4c6e-4b7e-9f21-8a4c31de0000"},"externalReference":{"type":"string","description":"Free-text reference to the object in an external system. Filterable on the list endpoint — use it as the correlation key for syncs.","example":"NET-FIREWALLS"},"label":{"type":"string","example":"Firewalls"},"description":{"type":"string","example":"Perimeter firewall appliances"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"example":"ACTIVE"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","label"]},"Org":{"type":"object","properties":{"id":{"type":"string","description":"Stable identifier, unchanged across updates.","example":"3fa2b710-4c6e-4b7e-9f21-8a4c31de0000"},"externalReference":{"type":"string","description":"Free-text reference to the object in an external system. Filterable on the list endpoint — use it as the correlation key for syncs.","example":"ORG-001"},"label":{"type":"string","example":"Akarion GmbH"},"description":{"type":"string","example":"Austrian legal entity"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"example":"ACTIVE"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","label"]},"Site":{"type":"object","properties":{"id":{"type":"string","description":"Stable identifier, unchanged across updates.","example":"3fa2b710-4c6e-4b7e-9f21-8a4c31de0000"},"externalReference":{"type":"string","description":"Free-text reference to the object in an external system. Filterable on the list endpoint — use it as the correlation key for syncs.","example":"SITE-VIE"},"label":{"type":"string","example":"Vienna HQ"},"description":{"type":"string","example":"Headquarters and primary office location"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"example":"ACTIVE"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","label"]},"System":{"type":"object","properties":{"id":{"type":"string","description":"Stable identifier, unchanged across updates.","example":"3fa2b710-4c6e-4b7e-9f21-8a4c31de0000"},"externalReference":{"type":"string","description":"Free-text reference to the object in an external system. Filterable on the list endpoint — use it as the correlation key for syncs.","example":"CMDB-4711"},"label":{"type":"string","example":"Mail server"},"description":{"type":"string","example":"Primary mail server in the Vienna data center"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"example":"ACTIVE"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","label"]},"GenericAsset":{"type":"object","properties":{"id":{"type":"string","description":"Stable identifier, unchanged across updates.","example":"3fa2b710-4c6e-4b7e-9f21-8a4c31de0000"},"externalReference":{"type":"string","description":"Free-text reference to the object in an external system. Filterable on the list endpoint — use it as the correlation key for syncs.","example":"ASSET-PRINTERS"},"label":{"type":"string","example":"Office printers"},"description":{"type":"string","example":"Shared office printer fleet"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"example":"ACTIVE"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","label"]},"InformationValue":{"type":"object","properties":{"id":{"type":"string","description":"Stable identifier, unchanged across updates.","example":"3fa2b710-4c6e-4b7e-9f21-8a4c31de0000"},"externalReference":{"type":"string","description":"Free-text reference to the object in an external system. Filterable on the list endpoint — use it as the correlation key for syncs.","example":"INFO-CRM"},"label":{"type":"string","example":"Customer database"},"description":{"type":"string","example":"Master record of customer master data"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","label"]},"BusinessProcess":{"type":"object","properties":{"id":{"type":"string","description":"Stable identifier, unchanged across updates.","example":"3fa2b710-4c6e-4b7e-9f21-8a4c31de0000"},"externalReference":{"type":"string","description":"Free-text reference to the object in an external system. Filterable on the list endpoint — use it as the correlation key for syncs.","example":"BP-ORDER"},"label":{"type":"string","example":"Order fulfillment"},"description":{"type":"string","example":"From order receipt through to shipment"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"example":"ACTIVE"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","label"]},"BusinessService":{"type":"object","properties":{"id":{"type":"string","description":"Stable identifier, unchanged across updates.","example":"3fa2b710-4c6e-4b7e-9f21-8a4c31de0000"},"externalReference":{"type":"string","description":"Free-text reference to the object in an external system. Filterable on the list endpoint — use it as the correlation key for syncs.","example":"SVC-PORTAL"},"label":{"type":"string","example":"Customer portal"},"description":{"type":"string","example":"Self-service portal for customers"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","label"]}}},"paths":{"/v1/contact-roles":{"get":{"tags":["Contact Role"],"summary":"List contact roles","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"externalReference","in":"query","schema":{"type":"string"},"description":"Return only objects with exactly this external reference."}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ContactRole"}},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalElements":{"type":"integer"}}}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"}}},"post":{"tags":["Contact Role"],"summary":"Create a contact role","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"description":"Defaults to NEW when omitted."}},"required":["label"],"example":{"label":"Data Protection Officer","description":"Accountable for data protection compliance","externalReference":"ROLE-DPO","status":"ACTIVE"}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactRole"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"422":{"description":"Validation error"}}}},"/v1/contact-roles/{id}":{"get":{"tags":["Contact Role"],"summary":"Get a contact role","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactRole"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}},"put":{"tags":["Contact Role"],"summary":"Update a contact role","description":"Partial update: only the provided fields are changed; omitted fields (including fields not exposed by this API) keep their current value.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"]}},"example":{"label":"Data Protection Officer","description":"Accountable for data protection compliance","externalReference":"ROLE-DPO","status":"ACTIVE"},"description":"Only the provided fields are updated; omitted fields keep their current value."}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactRole"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"},"422":{"description":"Validation error"}}},"delete":{"tags":["Contact Role"],"summary":"Delete a contact role","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}}},"/v1/departments":{"get":{"tags":["Department"],"summary":"List departments","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"externalReference","in":"query","schema":{"type":"string"},"description":"Return only objects with exactly this external reference."}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Department"}},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalElements":{"type":"integer"}}}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"}}},"post":{"tags":["Department"],"summary":"Create a department","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"description":"Defaults to NEW when omitted."}},"required":["label"],"example":{"label":"IT Operations","description":"Runs internal infrastructure and support","externalReference":"DEPT-ITOPS","status":"ACTIVE"}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Department"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"422":{"description":"Validation error"}}}},"/v1/departments/{id}":{"get":{"tags":["Department"],"summary":"Get a department","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Department"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}},"put":{"tags":["Department"],"summary":"Update a department","description":"Partial update: only the provided fields are changed; omitted fields (including fields not exposed by this API) keep their current value.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"]}},"example":{"label":"IT Operations","description":"Runs internal infrastructure and support","externalReference":"DEPT-ITOPS","status":"ACTIVE"},"description":"Only the provided fields are updated; omitted fields keep their current value."}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Department"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"},"422":{"description":"Validation error"}}},"delete":{"tags":["Department"],"summary":"Delete a department","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}}},"/v1/hardware-assets":{"get":{"tags":["Hardware Asset"],"summary":"List hardware assets","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"externalReference","in":"query","schema":{"type":"string"},"description":"Return only objects with exactly this external reference."}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/HardwareAsset"}},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalElements":{"type":"integer"}}}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"}}},"post":{"tags":["Hardware Asset"],"summary":"Create a hardware asset","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"description":"Defaults to NEW when omitted."}},"required":["label"],"example":{"label":"Employee laptops","description":"Fleet of company-issued laptops","externalReference":"HW-LAPTOPS","status":"ACTIVE"}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HardwareAsset"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"422":{"description":"Validation error"}}}},"/v1/hardware-assets/{id}":{"get":{"tags":["Hardware Asset"],"summary":"Get a hardware asset","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HardwareAsset"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}},"put":{"tags":["Hardware Asset"],"summary":"Update a hardware asset","description":"Partial update: only the provided fields are changed; omitted fields (including fields not exposed by this API) keep their current value.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"]}},"example":{"label":"Employee laptops","description":"Fleet of company-issued laptops","externalReference":"HW-LAPTOPS","status":"ACTIVE"},"description":"Only the provided fields are updated; omitted fields keep their current value."}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HardwareAsset"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"},"422":{"description":"Validation error"}}},"delete":{"tags":["Hardware Asset"],"summary":"Delete a hardware asset","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}}},"/v1/network-assets":{"get":{"tags":["Network Asset"],"summary":"List network assets","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"externalReference","in":"query","schema":{"type":"string"},"description":"Return only objects with exactly this external reference."}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/NetworkAsset"}},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalElements":{"type":"integer"}}}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"}}},"post":{"tags":["Network Asset"],"summary":"Create a network asset","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"description":"Defaults to NEW when omitted."}},"required":["label"],"example":{"label":"Firewalls","description":"Perimeter firewall appliances","externalReference":"NET-FIREWALLS","status":"ACTIVE"}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkAsset"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"422":{"description":"Validation error"}}}},"/v1/network-assets/{id}":{"get":{"tags":["Network Asset"],"summary":"Get a network asset","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkAsset"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}},"put":{"tags":["Network Asset"],"summary":"Update a network asset","description":"Partial update: only the provided fields are changed; omitted fields (including fields not exposed by this API) keep their current value.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"]}},"example":{"label":"Firewalls","description":"Perimeter firewall appliances","externalReference":"NET-FIREWALLS","status":"ACTIVE"},"description":"Only the provided fields are updated; omitted fields keep their current value."}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkAsset"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"},"422":{"description":"Validation error"}}},"delete":{"tags":["Network Asset"],"summary":"Delete a network asset","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}}},"/v1/orgs":{"get":{"tags":["Org"],"summary":"List orgs","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"externalReference","in":"query","schema":{"type":"string"},"description":"Return only objects with exactly this external reference."}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Org"}},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalElements":{"type":"integer"}}}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"}}},"post":{"tags":["Org"],"summary":"Create a org","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"description":"Defaults to NEW when omitted."}},"required":["label"],"example":{"label":"Akarion GmbH","description":"Austrian legal entity","externalReference":"ORG-001","status":"ACTIVE"}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Org"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"422":{"description":"Validation error"}}}},"/v1/orgs/{id}":{"get":{"tags":["Org"],"summary":"Get a org","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Org"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}},"put":{"tags":["Org"],"summary":"Update a org","description":"Partial update: only the provided fields are changed; omitted fields (including fields not exposed by this API) keep their current value.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"]}},"example":{"label":"Akarion GmbH","description":"Austrian legal entity","externalReference":"ORG-001","status":"ACTIVE"},"description":"Only the provided fields are updated; omitted fields keep their current value."}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Org"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"},"422":{"description":"Validation error"}}},"delete":{"tags":["Org"],"summary":"Delete a org","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}}},"/v1/sites":{"get":{"tags":["Site"],"summary":"List sites","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"externalReference","in":"query","schema":{"type":"string"},"description":"Return only objects with exactly this external reference."}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Site"}},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalElements":{"type":"integer"}}}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"}}},"post":{"tags":["Site"],"summary":"Create a site","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"description":"Defaults to NEW when omitted."}},"required":["label"],"example":{"label":"Vienna HQ","description":"Headquarters and primary office location","externalReference":"SITE-VIE","status":"ACTIVE"}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"422":{"description":"Validation error"}}}},"/v1/sites/{id}":{"get":{"tags":["Site"],"summary":"Get a site","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}},"put":{"tags":["Site"],"summary":"Update a site","description":"Partial update: only the provided fields are changed; omitted fields (including fields not exposed by this API) keep their current value.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"]}},"example":{"label":"Vienna HQ","description":"Headquarters and primary office location","externalReference":"SITE-VIE","status":"ACTIVE"},"description":"Only the provided fields are updated; omitted fields keep their current value."}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"},"422":{"description":"Validation error"}}},"delete":{"tags":["Site"],"summary":"Delete a site","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}}},"/v1/systems":{"get":{"tags":["System"],"summary":"List systems","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"externalReference","in":"query","schema":{"type":"string"},"description":"Return only objects with exactly this external reference."}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/System"}},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalElements":{"type":"integer"}}}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"}}},"post":{"tags":["System"],"summary":"Create a system","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"description":"Defaults to NEW when omitted."}},"required":["label"],"example":{"label":"Mail server","description":"Primary mail server in the Vienna data center","externalReference":"CMDB-4711","status":"ACTIVE"}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/System"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"422":{"description":"Validation error"}}}},"/v1/systems/{id}":{"get":{"tags":["System"],"summary":"Get a system","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/System"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}},"put":{"tags":["System"],"summary":"Update a system","description":"Partial update: only the provided fields are changed; omitted fields (including fields not exposed by this API) keep their current value.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"]}},"example":{"label":"Mail server","description":"Primary mail server in the Vienna data center","externalReference":"CMDB-4711","status":"ACTIVE"},"description":"Only the provided fields are updated; omitted fields keep their current value."}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/System"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"},"422":{"description":"Validation error"}}},"delete":{"tags":["System"],"summary":"Delete a system","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}}},"/v1/generic-assets":{"get":{"tags":["Generic Asset"],"summary":"List generic assets","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"externalReference","in":"query","schema":{"type":"string"},"description":"Return only objects with exactly this external reference."}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GenericAsset"}},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalElements":{"type":"integer"}}}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"}}},"post":{"tags":["Generic Asset"],"summary":"Create a generic asset","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"description":"Defaults to NEW when omitted."}},"required":["label"],"example":{"label":"Office printers","description":"Shared office printer fleet","externalReference":"ASSET-PRINTERS","status":"ACTIVE"}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericAsset"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"422":{"description":"Validation error"}}}},"/v1/generic-assets/{id}":{"get":{"tags":["Generic Asset"],"summary":"Get a generic asset","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericAsset"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}},"put":{"tags":["Generic Asset"],"summary":"Update a generic asset","description":"Partial update: only the provided fields are changed; omitted fields (including fields not exposed by this API) keep their current value.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"]}},"example":{"label":"Office printers","description":"Shared office printer fleet","externalReference":"ASSET-PRINTERS","status":"ACTIVE"},"description":"Only the provided fields are updated; omitted fields keep their current value."}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericAsset"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"},"422":{"description":"Validation error"}}},"delete":{"tags":["Generic Asset"],"summary":"Delete a generic asset","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}}},"/v1/information-values":{"get":{"tags":["Information Value"],"summary":"List information values","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"externalReference","in":"query","schema":{"type":"string"},"description":"Return only objects with exactly this external reference."}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/InformationValue"}},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalElements":{"type":"integer"}}}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"}}},"post":{"tags":["Information Value"],"summary":"Create a information value","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"}},"required":["label"],"example":{"label":"Customer database","description":"Master record of customer master data","externalReference":"INFO-CRM"}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InformationValue"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"422":{"description":"Validation error"}}}},"/v1/information-values/{id}":{"get":{"tags":["Information Value"],"summary":"Get a information value","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InformationValue"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}},"put":{"tags":["Information Value"],"summary":"Update a information value","description":"Partial update: only the provided fields are changed; omitted fields (including fields not exposed by this API) keep their current value.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"}},"example":{"label":"Customer database","description":"Master record of customer master data","externalReference":"INFO-CRM"},"description":"Only the provided fields are updated; omitted fields keep their current value."}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InformationValue"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"},"422":{"description":"Validation error"}}},"delete":{"tags":["Information Value"],"summary":"Delete a information value","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}}},"/v1/business-processes":{"get":{"tags":["Business Process"],"summary":"List business processs","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"externalReference","in":"query","schema":{"type":"string"},"description":"Return only objects with exactly this external reference."}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BusinessProcess"}},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalElements":{"type":"integer"}}}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"}}},"post":{"tags":["Business Process"],"summary":"Create a business process","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"],"description":"Defaults to NEW when omitted."}},"required":["label"],"example":{"label":"Order fulfillment","description":"From order receipt through to shipment","externalReference":"BP-ORDER","status":"ACTIVE"}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessProcess"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"422":{"description":"Validation error"}}}},"/v1/business-processes/{id}":{"get":{"tags":["Business Process"],"summary":"Get a business process","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessProcess"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}},"put":{"tags":["Business Process"],"summary":"Update a business process","description":"Partial update: only the provided fields are changed; omitted fields (including fields not exposed by this API) keep their current value.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"},"status":{"type":"string","enum":["NEW","DRAFT","IN_REVIEW","IN_EXAMINATION","DECLINED","APPROVED","IN_IMPLEMENTATION","ACTIVE","OUTDATED","INACTIVE"]}},"example":{"label":"Order fulfillment","description":"From order receipt through to shipment","externalReference":"BP-ORDER","status":"ACTIVE"},"description":"Only the provided fields are updated; omitted fields keep their current value."}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessProcess"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"},"422":{"description":"Validation error"}}},"delete":{"tags":["Business Process"],"summary":"Delete a business process","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}}},"/v1/business-services":{"get":{"tags":["Business Service"],"summary":"List business services","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"externalReference","in":"query","schema":{"type":"string"},"description":"Return only objects with exactly this external reference."}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BusinessService"}},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalElements":{"type":"integer"}}}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"}}},"post":{"tags":["Business Service"],"summary":"Create a business service","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"}},"required":["label"],"example":{"label":"Customer portal","description":"Self-service portal for customers","externalReference":"SVC-PORTAL"}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessService"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"422":{"description":"Validation error"}}}},"/v1/business-services/{id}":{"get":{"tags":["Business Service"],"summary":"Get a business service","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessService"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}},"put":{"tags":["Business Service"],"summary":"Update a business service","description":"Partial update: only the provided fields are changed; omitted fields (including fields not exposed by this API) keep their current value.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AcceptLanguage"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"description":{"type":"string"},"externalReference":{"type":"string"}},"example":{"label":"Customer portal","description":"Self-service portal for customers","externalReference":"SVC-PORTAL"},"description":"Only the provided fields are updated; omitted fields keep their current value."}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessService"}}}},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"},"422":{"description":"Validation error"}}},"delete":{"tags":["Business Service"],"summary":"Delete a business service","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"Missing, invalid, or expired api token"},"403":{"description":"The token lacks permission for this type"},"404":{"description":"Not found"}}}}}}