> For the complete documentation index, see [llms.txt](https://docs.truedat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.truedat.io/api-integrations/business-glossary-apis/business-concept-versions.md).

# Business Concept Versions

## Send business concept version for approval

> Submits a business concept version for review and approval.\
> \
> Requires \*\*'Request business concept approval'\*\* on the version's domain.\
> \
> The version must be in \`draft\` status and must be the latest version of its concept. On success, the status becomes \`pending\_approval\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/submit":{"post":{"description":"Submits a business concept version for review and approval.\n\nRequires **'Request business concept approval'** on the version's domain.\n\nThe version must be in `draft` status and must be the latest version of its concept. On success, the status becomes `pending_approval`.\n","operationId":"TdBgWeb.BusinessConceptVersionController.send_for_approval","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionShowResponse"}}},"description":"Business concept version submitted"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgNotFoundResponse"}}},"description":"Not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnprocessableEntityArrayResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Send business concept version for approval","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"title":"BusinessConceptVersionShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgNotFoundResponse","type":"object"},"TdBgUnprocessableEntityArrayResponse":{"properties":{"errors":{"items":{"properties":{"code":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"title":"TdBgUnprocessableEntityArrayResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Deprecate business concept version

> Deprecates the current published version of a business concept.\
> \
> Requires \*\*'Deprecate business concepts'\*\* on the concept's domain.\
> \
> The version must be \`published\` and current. On success, the version becomes \`deprecated\` and is no longer considered current.\
> \
> Deprecated versions can be restored with the \`restore\` or \`publish\` endpoints.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/deprecate":{"post":{"description":"Deprecates the current published version of a business concept.\n\nRequires **'Deprecate business concepts'** on the concept's domain.\n\nThe version must be `published` and current. On success, the version becomes `deprecated` and is no longer considered current.\n\nDeprecated versions can be restored with the `restore` or `publish` endpoints.\n","operationId":"TdBgWeb.BusinessConceptVersionController.deprecate","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionShowResponse"}}},"description":"Business concept version deprecated"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgNotFoundResponse"}}},"description":"Not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BGUnprocessableEntityArrayOrObjectResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Deprecate business concept version","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"title":"BusinessConceptVersionShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgNotFoundResponse","type":"object"},"BGUnprocessableEntityArrayOrObjectResponse":{"description":"Response for 422 errors. Errors value might be an array or an object","oneOf":[{"$ref":"#/components/schemas/TdBgUnprocessableEntityArrayResponse"},{"$ref":"#/components/schemas/TdBgUnprocessableEntityObjectResponse"}],"title":"BGUnprocessableEntityArrayOrObjectResponse"},"TdBgUnprocessableEntityArrayResponse":{"properties":{"errors":{"items":{"properties":{"code":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"title":"TdBgUnprocessableEntityArrayResponse","type":"object"},"TdBgUnprocessableEntityObjectResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgUnprocessableEntityObjectResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## List available actions for business concept versions

> Returns the business concept version actions available to the authenticated user.\
> \
> \*\*Permissions:\*\* Actions are included only when the caller holds the corresponding permission:\
> \- \*\*'Create business concepts'\*\* enables upload.\
> \- \*\*'Publish business concepts'\*\* enables automatic publishing.\
> \- \*\*'Manage business concept links'\*\* enables link downloads.\
> \- Status-specific view permissions enable the corresponding download action:\
> &#x20; \- \`downloadPublishedConcepts\` requires \*\*'View published business concepts'\*\*.\
> &#x20; \- \`downloadDeprecatedConcepts\` requires \*\*'View deprecated business concepts'\*\*.\
> &#x20; \- \`downloadDraftConcepts\` requires any of \*\*'View draft business concepts'\*\*, \*\*'View rejected business concepts'\*\*, or \*\*'View business concepts pending approval'\*\*.\
> \
> The response contains only the actions the caller is authorized to perform. Unauthorized actions are omitted from the hypermedia collection.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/actions":{"get":{"description":"Returns the business concept version actions available to the authenticated user.\n\n**Permissions:** Actions are included only when the caller holds the corresponding permission:\n- **'Create business concepts'** enables upload.\n- **'Publish business concepts'** enables automatic publishing.\n- **'Manage business concept links'** enables link downloads.\n- Status-specific view permissions enable the corresponding download action:\n  - `downloadPublishedConcepts` requires **'View published business concepts'**.\n  - `downloadDeprecatedConcepts` requires **'View deprecated business concepts'**.\n  - `downloadDraftConcepts` requires any of **'View draft business concepts'**, **'View rejected business concepts'**, or **'View business concepts pending approval'**.\n\nThe response contains only the actions the caller is authorized to perform. Unauthorized actions are omitted from the hypermedia collection.\n","operationId":"TdBgWeb.BusinessConceptVersionSearchController.actions","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionActionsResponse"}}},"description":"Actions"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List available actions for business concept versions","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionActionsResponse":{"additionalProperties":false,"properties":{"_actions":{"additionalProperties":{"$ref":"#/components/schemas/ActionLink"},"type":"object"},"data":{"items":{"type":"object"},"nullable":true,"type":"array"}},"required":["_actions"],"title":"BusinessConceptVersionActionsResponse","type":"object"},"ActionLink":{"additionalProperties":false,"properties":{"href":{"type":"string"},"input":{"additionalProperties":true,"type":"object"},"method":{"enum":["GET","POST","PUT","PATCH","DELETE"],"type":"string"}},"required":["method","href"],"title":"ActionLink","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Restore deprecated business concept version

> Restores the latest deprecated version of a business concept by publishing it again.\
> \
> Requires \*\*'Publish business concepts'\*\* on the version's domain.\
> \
> The version must be in \`deprecated\` status and must be the latest version. On success, the version is published again and becomes the current version.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/restore":{"post":{"description":"Restores the latest deprecated version of a business concept by publishing it again.\n\nRequires **'Publish business concepts'** on the version's domain.\n\nThe version must be in `deprecated` status and must be the latest version. On success, the version is published again and becomes the current version.\n","operationId":"TdBgWeb.BusinessConceptVersionController.restore","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionShowResponse"}}},"description":"Business concept version restored"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BGUnprocessableEntityArrayOrObjectResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Restore deprecated business concept version","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"title":"BusinessConceptVersionShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"BGUnprocessableEntityArrayOrObjectResponse":{"description":"Response for 422 errors. Errors value might be an array or an object","oneOf":[{"$ref":"#/components/schemas/TdBgUnprocessableEntityArrayResponse"},{"$ref":"#/components/schemas/TdBgUnprocessableEntityObjectResponse"}],"title":"BGUnprocessableEntityArrayOrObjectResponse"},"TdBgUnprocessableEntityArrayResponse":{"properties":{"errors":{"items":{"properties":{"code":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"title":"TdBgUnprocessableEntityArrayResponse","type":"object"},"TdBgUnprocessableEntityObjectResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgUnprocessableEntityObjectResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Upload business concepts file

> Starts asynchronous bulk processing of an Excel (XLSX) file containing business concepts. The request may contain both creates and updates; new concepts and new versions can be saved as drafts or, with the appropriate permission, published directly.\
> The file is hashed, enqueued as a background job, and the endpoint returns \`202 Accepted\` with a \`task\_reference\` for tracking. If the same file hash is uploaded while a previous job is still running, the existing event is returned. Errors during processing are reported per row through the bulk‑upload events endpoint.\
> \
> \*\*Permissions:\*\*\
> \- To create a new concept: \*\*'Create business concepts'\*\* on the target domain.\
> \- To update an existing concept: \*\*'Update business concepts'\*\* on the concept's domain.\
> \- To publish (either directly or via \`auto\_publish\`): \*\*'Publish business concepts'\*\* on the concept's domain.\
> \
> \*\*Request body (multipart/form-data):\*\*\
> \- \`business\_concepts\` (required, file) – XLSX file with the concept definitions.\
> \- \`auto\_publish\` (optional, string) – \`'true'\` or \`'false'\`. When \`'true'\`, eligible rows are published only if the caller holds \*\*'Publish business concepts'\*\* on the concept's domain. Default: \`'false'\`.\
> \- \`lang\` (optional, string) – Language for translated content. Defaults to the server‑configured language; the API does not read the browser language.\
> \
> \*\*File format:\*\*\
> \- \*\*Type:\*\* Excel (XLSX).\
> \- \*\*Sheets:\*\* one sheet per concept type (template). The sheet name is the \*\*template name\*\* (not the label).\
> \- \*\*Common columns:\*\* \`id\`, \`current\_version\_id\`, \`name\`, \`domain\_external\_id\`, \`domain\_name\`, \`status\`, \`completeness\`, \`last\_change\_at\`, \`inserted\_at\`, \`link\_to\_concept\`.\
> \- \*\*Template fields:\*\* one column per template field, headed by the \*\*field name\*\* (not the label).\
> \- \*\*Required for creation:\*\* \`name\`, \`domain\_external\_id\`.\
> \- \*\*Required for update:\*\* \`id\`, \`name\`, \`domain\_external\_id\`.\
> \- \*\*Ignored on upload (can be omitted):\*\* \`current\_version\_id\`, \`status\`, \`completeness\`, \`last\_change\_at\`, \`inserted\_at\`, \`link\_to\_concept\`.\
> \- \*\*Column semantics:\*\* a column not present leaves the field unchanged; a column present but empty clears the field (existing content is deleted).\
> \- \*\*Domain cannot be updated via file upload.\*\* Bulk domain reassignment can only be performed by an administrator through the web interface.\
> \
> \*\*Field formats (Excel uploads):\*\*\
> \- \*\*Number\*\* – Excel cell format Number or General.\
> \- \*\*Date\*\* – Excel cell format Date, or Text matching: \`yyyy-mm-dd\`, \`yyyy/mm/dd\`, \`dd-mm-yyyy\`, \`dd/mm/yyyy\`.\
> \- \*\*DateTime\*\* – Excel cell format Date, or Text matching: \`yyyy-mm-dd hh:mm:ss\`, \`yyyy/mm/dd hh:mm:ss\`, \`dd-mm-yyyy hh:mm:ss\`, \`dd/mm/yyyy hh:mm:ss\`.\
> \- \*\*Link\*\* – \`\[Link text] (<https://example.com/)\\`.\\>
> \- \*\*User or Group\*\* – \`user:Full Name\` or \`group:Group Name\` / \`group:Group Alias\`. Example: \`user:Antonio García\`, \`group:Data Team\`.\
> \- \*\*User\*\* – The user's full name without the \`user:\` prefix.\
> \- \*\*Group\*\* – Group name or alias without the \`group:\` prefix.\
> \- \*\*Table / Dynamic Table\*\* – Column headers separated by semicolons (\`;\`), with a line break inside the cell separating headers from data rows.\
> \- \*\*Multiple Values\*\* – Values separated by pipe (\`|\`). Example: \`user1|user2|user3\`.\
> \- \*\*Rich Text\*\* – Downloaded and uploaded without formatting; remove the column unless uploading plain text content.\
> \- \*\*Dropdown / Radio / Checkbox\*\* – Values must match the template definition exactly (case‑sensitive).<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/upload":{"post":{"description":"Starts asynchronous bulk processing of an Excel (XLSX) file containing business concepts. The request may contain both creates and updates; new concepts and new versions can be saved as drafts or, with the appropriate permission, published directly.\nThe file is hashed, enqueued as a background job, and the endpoint returns `202 Accepted` with a `task_reference` for tracking. If the same file hash is uploaded while a previous job is still running, the existing event is returned. Errors during processing are reported per row through the bulk‑upload events endpoint.\n\n**Permissions:**\n- To create a new concept: **'Create business concepts'** on the target domain.\n- To update an existing concept: **'Update business concepts'** on the concept's domain.\n- To publish (either directly or via `auto_publish`): **'Publish business concepts'** on the concept's domain.\n\n**Request body (multipart/form-data):**\n- `business_concepts` (required, file) – XLSX file with the concept definitions.\n- `auto_publish` (optional, string) – `'true'` or `'false'`. When `'true'`, eligible rows are published only if the caller holds **'Publish business concepts'** on the concept's domain. Default: `'false'`.\n- `lang` (optional, string) – Language for translated content. Defaults to the server‑configured language; the API does not read the browser language.\n\n**File format:**\n- **Type:** Excel (XLSX).\n- **Sheets:** one sheet per concept type (template). The sheet name is the **template name** (not the label).\n- **Common columns:** `id`, `current_version_id`, `name`, `domain_external_id`, `domain_name`, `status`, `completeness`, `last_change_at`, `inserted_at`, `link_to_concept`.\n- **Template fields:** one column per template field, headed by the **field name** (not the label).\n- **Required for creation:** `name`, `domain_external_id`.\n- **Required for update:** `id`, `name`, `domain_external_id`.\n- **Ignored on upload (can be omitted):** `current_version_id`, `status`, `completeness`, `last_change_at`, `inserted_at`, `link_to_concept`.\n- **Column semantics:** a column not present leaves the field unchanged; a column present but empty clears the field (existing content is deleted).\n- **Domain cannot be updated via file upload.** Bulk domain reassignment can only be performed by an administrator through the web interface.\n\n**Field formats (Excel uploads):**\n- **Number** – Excel cell format Number or General.\n- **Date** – Excel cell format Date, or Text matching: `yyyy-mm-dd`, `yyyy/mm/dd`, `dd-mm-yyyy`, `dd/mm/yyyy`.\n- **DateTime** – Excel cell format Date, or Text matching: `yyyy-mm-dd hh:mm:ss`, `yyyy/mm/dd hh:mm:ss`, `dd-mm-yyyy hh:mm:ss`, `dd/mm/yyyy hh:mm:ss`.\n- **Link** – `[Link text] (https://example.com/)`.\n- **User or Group** – `user:Full Name` or `group:Group Name` / `group:Group Alias`. Example: `user:Antonio García`, `group:Data Team`.\n- **User** – The user's full name without the `user:` prefix.\n- **Group** – Group name or alias without the `group:` prefix.\n- **Table / Dynamic Table** – Column headers separated by semicolons (`;`), with a line break inside the cell separating headers from data rows.\n- **Multiple Values** – Values separated by pipe (`|`). Example: `user1|user2|user3`.\n- **Rich Text** – Downloaded and uploaded without formatting; remove the column unless uploading plain text content.\n- **Dropdown / Radio / Checkbox** – Values must match the template definition exactly (case‑sensitive).\n","operationId":"TdBgWeb.BusinessConceptVersionController.upload","parameters":[],"requestBody":{"content":{"multipart/form-data":{"schema":{"additionalProperties":false,"description":"Multipart request for uploading business concepts file","properties":{"auto_publish":{"default":"false","description":"Whether to publish eligible uploaded concepts automatically. Defaults to `false`.","enum":["true","false"],"type":"string"},"business_concepts":{"description":"Excel file in XLSX format containing business concept rows. The file must follow the business concept upload template.","format":"binary","type":"string"},"lang":{"description":"Language code used to interpret uploaded content. When omitted, the service uses its configured default language.","type":"string"}},"required":["business_concepts"],"title":"BusinessConceptVersionUploadRequest","type":"object"}}},"description":"Excel file to upload","required":false},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionUploadResponse"}}},"description":"Business concepts upload started"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Upload business concepts file","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionUploadResponse":{"additionalProperties":true,"title":"BusinessConceptVersionUploadResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Download business concepts as CSV

> Exports up to 10,000 business concept versions matching the supplied search criteria as a CSV file.\
> \
> \*\*Permissions:\*\* The export applies the download permissions corresponding to each concept's status:\
> \- \*\*'View published business concepts'\*\* for published versions.\
> \- \*\*'View deprecated business concepts'\*\* for deprecated versions.\
> \- Any of \*\*'View draft business concepts'\*\*, \*\*'View rejected business concepts'\*\*, or \*\*'View business concepts pending approval'\*\* for versions in those states.\
> \
> Only versions the caller can view are included in the workbook.\
> \
> Unlike the XLSX variant, the CSV export produces a single flat file rather than one sheet per template. Pagination is not applied.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/csv":{"post":{"description":"Exports up to 10,000 business concept versions matching the supplied search criteria as a CSV file.\n\n**Permissions:** The export applies the download permissions corresponding to each concept's status:\n- **'View published business concepts'** for published versions.\n- **'View deprecated business concepts'** for deprecated versions.\n- Any of **'View draft business concepts'**, **'View rejected business concepts'**, or **'View business concepts pending approval'** for versions in those states.\n\nOnly versions the caller can view are included in the workbook.\n\nUnlike the XLSX variant, the CSV export produces a single flat file rather than one sheet per template. Pagination is not applied.\n","operationId":"TdBgWeb.BusinessConceptVersionController.csv","parameters":[{"description":"Full-text search across the business concept name, description, and searchable template content.","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Exact-match filter object. For example: `{\"domain_id\": 12, \"status\": \"published\"}`.\nCommon fields include `domain_id`, `status`, `confidential`, `type`, and `name`; template-specific fields may also be supported.\nValues in `must` and `must_not` use the same filter structure when supported by the search endpoint.\n","explode":true,"in":"query","name":"filters","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Sort fields, for example `name.raw` or `-last_change_at`; prefix a field with `-` for descending order.","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"Creates a scroll context with the supplied lifetime, for example `2m`, for retrieving a large result set.","in":"query","name":"scroll","required":false,"schema":{"type":"string"}},{"description":"Identifier returned by a previous scroll search. Use it to continue that result set.","in":"query","name":"scroll_id","required":false,"schema":{"type":"string"}},{"description":"When `true`, restricts the results to concepts that can be linked by the caller. The filter is applied at query time and the effective set depends on the caller's permissions on each concept's domain.","in":"query","name":"only_linkable","required":false,"schema":{"type":"boolean"}},{"description":"Language code used for translated export content (e.g., 'en', 'es'). When omitted, the service uses its configured default language.","in":"query","name":"lang","required":false,"schema":{"type":"string"}},{"description":"Optional URL pattern used to build concept links in the exported file.","in":"query","name":"concept_url_schema","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"CSV file downloaded"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Download business concepts as CSV","tags":["Business Concept Versions"]}}},"components":{"schemas":{"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Undo business concept version rejection

> Returns the latest rejected version to \`draft\` status.\
> \
> Requires \*\*'Update business concepts'\*\* on the version's domain.\
> \
> The version must be in \`rejected\` status and must be the latest version.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/redraft":{"post":{"description":"Returns the latest rejected version to `draft` status.\n\nRequires **'Update business concepts'** on the version's domain.\n\nThe version must be in `rejected` status and must be the latest version.\n","operationId":"TdBgWeb.BusinessConceptVersionController.undo_rejection","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionShowResponse"}}},"description":"Business concept version restored to draft"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgNotFoundResponse"}}},"description":"Not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnprocessableEntityArrayResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Undo business concept version rejection","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"title":"BusinessConceptVersionShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgNotFoundResponse","type":"object"},"TdBgUnprocessableEntityArrayResponse":{"properties":{"errors":{"items":{"properties":{"code":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"title":"TdBgUnprocessableEntityArrayResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Set business concept confidentiality

> Updates whether the business concept is confidential.\
> \
> Requires both \*\*'Update business concepts'\*\* and \*\*'Manage confidential business concepts'\*\* on the version's domain.\
> \
> \*\*Request body:\*\*\
> \- \`confidential\` (required, boolean) – New confidentiality flag.\
> \
> When a concept is confidential, only callers with \*\*'Manage confidential business concepts'\*\* can see it in listings and searches.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/set_confidential":{"post":{"description":"Updates whether the business concept is confidential.\n\nRequires both **'Update business concepts'** and **'Manage confidential business concepts'** on the version's domain.\n\n**Request body:**\n- `confidential` (required, boolean) – New confidentiality flag.\n\nWhen a concept is confidential, only callers with **'Manage confidential business concepts'** can see it in listings and searches.\n","operationId":"TdBgWeb.BusinessConceptVersionController.set_confidential","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionSetConfidentialRequest"}}},"description":"Confidentiality payload","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionShowResponse"}}},"description":"Business concept confidentiality updated"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgNotFoundResponse"}}},"description":"Not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgConfidentialUnprocessableEntityResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Set business concept confidentiality","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionSetConfidentialRequest":{"additionalProperties":false,"properties":{"confidential":{"description":"Confidential flag","type":"boolean"}},"required":["confidential"],"title":"BusinessConceptVersionSetConfidentialRequest","type":"object"},"BusinessConceptVersionShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"title":"BusinessConceptVersionShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgNotFoundResponse","type":"object"},"TdBgConfidentialUnprocessableEntityResponse":{"properties":{"errors":{"properties":{"business_concept":{"properties":{"confidential":{"items":{"type":"string"},"type":"array"}},"type":"object"}},"type":"object"}},"title":"TdBgConfidentialUnprocessableEntityResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Show business concept version

> Retrieves a specific business concept version, including content, domain information, counts, shared domains, and the hypermedia actions available to the caller.\
> \
> \*\*Permissions:\*\* Requires the view permission matching the version's current status, on the version's domain:\
> \- \*\*'View draft business concepts'\*\* when the version is in \`draft\`.\
> \- \*\*'View business concepts pending approval'\*\* when it is \`pending\_approval\`.\
> \- \*\*'View published business concepts'\*\* when it is \`published\`.\
> \- \*\*'View deprecated business concepts'\*\* when it is \`deprecated\`.\
> \- \*\*'View rejected business concepts'\*\* when it is \`rejected\`.\
> \- \*\*'View versioned business concepts'\*\* when it is \`versioned\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concepts/{business_concept_id}/versions/{id}":{"get":{"description":"Retrieves a specific business concept version, including content, domain information, counts, shared domains, and the hypermedia actions available to the caller.\n\n**Permissions:** Requires the view permission matching the version's current status, on the version's domain:\n- **'View draft business concepts'** when the version is in `draft`.\n- **'View business concepts pending approval'** when it is `pending_approval`.\n- **'View published business concepts'** when it is `published`.\n- **'View deprecated business concepts'** when it is `deprecated`.\n- **'View rejected business concepts'** when it is `rejected`.\n- **'View versioned business concepts'** when it is `versioned`.\n","operationId":"TdBgWeb.BusinessConceptVersionController.show","parameters":[{"description":"Business concept ID","in":"path","name":"business_concept_id","required":true,"schema":{"type":"integer"}},{"description":"Business concept version ID","in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionShowResponse"}}},"description":"Business concept version"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgNotFoundResponse"}}},"description":"Not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Show business concept version","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"title":"BusinessConceptVersionShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgNotFoundResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Bulk update business concepts

> Updates multiple business concept versions selected by a search query using a set of update attributes.\
> \
> Requires the bulk business‑concept update permission. Every concept selected by the query is checked against the caller's permissions before the update is applied.\
> \
> \*\*Request body:\*\*\
> \- \`search\_params\` (required, object) – Same search parameters as the list endpoint (\`query\`, \`filters\`, etc.).\
> \- \`update\_attributes\` (required, object) – Attributes to apply to every matched concept. Only fields supported by the bulk‑update workflow are accepted.\
> \
> The operation is not transactional across all matched concepts; successful rows are persisted and failures are reported in the response.\
> The response reports the number of updated versions and identifies the failures individually.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/bulk_update":{"post":{"description":"Updates multiple business concept versions selected by a search query using a set of update attributes.\n\nRequires the bulk business‑concept update permission. Every concept selected by the query is checked against the caller's permissions before the update is applied.\n\n**Request body:**\n- `search_params` (required, object) – Same search parameters as the list endpoint (`query`, `filters`, etc.).\n- `update_attributes` (required, object) – Attributes to apply to every matched concept. Only fields supported by the bulk‑update workflow are accepted.\n\nThe operation is not transactional across all matched concepts; successful rows are persisted and failures are reported in the response.\nThe response reports the number of updated versions and identifies the failures individually.\n","operationId":"TdBgWeb.BusinessConceptVersionController.bulk_update","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionBulkUpdateRequest"}}},"description":"Bulk update payload","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionBulkUpdateResponse"}}},"description":"Business concepts updated"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgNotFoundResponse"}}},"description":"Not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnprocessableEntityArrayResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Bulk update business concepts","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionBulkUpdateRequest":{"additionalProperties":false,"properties":{"search_params":{"additionalProperties":true,"type":"object"},"update_attributes":{"additionalProperties":true,"type":"object"}},"required":["update_attributes","search_params"],"title":"BusinessConceptVersionBulkUpdateRequest","type":"object"},"BusinessConceptVersionBulkUpdateResponse":{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"message":{"items":{"type":"integer"},"type":"array"}},"type":"object"}},"title":"BusinessConceptVersionBulkUpdateResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgNotFoundResponse","type":"object"},"TdBgUnprocessableEntityArrayResponse":{"properties":{"errors":{"items":{"properties":{"code":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"title":"TdBgUnprocessableEntityArrayResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Update business concept version

> Updates the content or name of an existing business concept version.\
> \
> Requires \*\*'Update business concepts'\*\* on the version's domain.\
> \
> \*\*Request body:\*\*\
> \- \`business\_concept\_version\` (required) – Object containing:\
> &#x20; \- \`name\` (optional, string) – Updated concept name. Must be unique.\
> &#x20; \- \`content\` (optional, object) – Updated values for the template fields.\
> \
> The supplied content is validated against the version's template. Omitted fields are left unchanged.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/{id}":{"put":{"description":"Updates the content or name of an existing business concept version.\n\nRequires **'Update business concepts'** on the version's domain.\n\n**Request body:**\n- `business_concept_version` (required) – Object containing:\n  - `name` (optional, string) – Updated concept name. Must be unique.\n  - `content` (optional, object) – Updated values for the template fields.\n\nThe supplied content is validated against the version's template. Omitted fields are left unchanged.\n","operationId":"TdBgWeb.BusinessConceptVersionController.update","parameters":[{"description":"Business concept version ID","in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionUpdateRequest"}}},"description":"Business concept version payload","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionShowResponse"}}},"description":"Business concept version updated"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BGUnprocessableEntityArrayOrObjectResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Update business concept version","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionUpdateRequest":{"additionalProperties":false,"properties":{"business_concept_version":{"additionalProperties":false,"properties":{"content":{"additionalProperties":true,"description":"Structured content to update. The available fields are defined by the business concept template.","type":"object"},"name":{"description":"New business concept name.","type":"string"}},"type":"object"}},"required":["business_concept_version"],"title":"BusinessConceptVersionUpdateRequest","type":"object"},"BusinessConceptVersionShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"title":"BusinessConceptVersionShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"BGUnprocessableEntityArrayOrObjectResponse":{"description":"Response for 422 errors. Errors value might be an array or an object","oneOf":[{"$ref":"#/components/schemas/TdBgUnprocessableEntityArrayResponse"},{"$ref":"#/components/schemas/TdBgUnprocessableEntityObjectResponse"}],"title":"BGUnprocessableEntityArrayOrObjectResponse"},"TdBgUnprocessableEntityArrayResponse":{"properties":{"errors":{"items":{"properties":{"code":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"title":"TdBgUnprocessableEntityArrayResponse","type":"object"},"TdBgUnprocessableEntityObjectResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgUnprocessableEntityObjectResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Delete business concept version

> Permanently deletes a business concept version.\
> \
> Requires \*\*'Delete business concepts'\*\* on the version's domain. The version must be in a status that the business concept workflow allows to be deleted.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/{id}":{"delete":{"description":"Permanently deletes a business concept version.\n\nRequires **'Delete business concepts'** on the version's domain. The version must be in a status that the business concept workflow allows to be deleted.\n","operationId":"TdBgWeb.BusinessConceptVersionController.delete","parameters":[{"description":"Business concept version ID","in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Business concept version deleted"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgNotFoundResponse"}}},"description":"Not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnprocessableEntityArrayResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Delete business concept version","tags":["Business Concept Versions"]}}},"components":{"schemas":{"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgNotFoundResponse","type":"object"},"TdBgUnprocessableEntityArrayResponse":{"properties":{"errors":{"items":{"properties":{"code":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"title":"TdBgUnprocessableEntityArrayResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Publish business concept version

> Publishes the latest version of a business concept. Two source statuses are accepted:\
> \- \`pending\_approval\` – the version is approved and becomes published.\
> \- \`deprecated\` – the version is restored by publishing it again.\
> \
> Requires \*\*'Publish business concepts'\*\* on the version's domain.\
> \
> The version must be the latest version of its concept, and the name must be available within the domain group.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/publish":{"post":{"description":"Publishes the latest version of a business concept. Two source statuses are accepted:\n- `pending_approval` – the version is approved and becomes published.\n- `deprecated` – the version is restored by publishing it again.\n\nRequires **'Publish business concepts'** on the version's domain.\n\nThe version must be the latest version of its concept, and the name must be available within the domain group.\n","operationId":"TdBgWeb.BusinessConceptVersionController.publish","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionShowResponse"}}},"description":"Business concept version published"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgNotFoundResponse"}}},"description":"Not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BGUnprocessableEntityArrayOrObjectResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Publish business concept version","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"title":"BusinessConceptVersionShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgNotFoundResponse","type":"object"},"BGUnprocessableEntityArrayOrObjectResponse":{"description":"Response for 422 errors. Errors value might be an array or an object","oneOf":[{"$ref":"#/components/schemas/TdBgUnprocessableEntityArrayResponse"},{"$ref":"#/components/schemas/TdBgUnprocessableEntityObjectResponse"}],"title":"BGUnprocessableEntityArrayOrObjectResponse"},"TdBgUnprocessableEntityArrayResponse":{"properties":{"errors":{"items":{"properties":{"code":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"title":"TdBgUnprocessableEntityArrayResponse","type":"object"},"TdBgUnprocessableEntityObjectResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgUnprocessableEntityObjectResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## List business concept versions by filters or concept ID

> Returns business concept versions visible to the authenticated user.\
> \
> \*\*Permissions:\*\* Visibility is restricted by the caller's status-specific and domain-scoped permissions. Only versions the caller is allowed to view are returned. The exact permission depends on the version's current status:\
> \- \*\*'View draft business concepts'\*\* for \`draft\`.\
> \- \*\*'View business concepts pending approval'\*\* for \`pending\_approval\`.\
> \- \*\*'View published business concepts'\*\* for \`published\`.\
> \- \*\*'View deprecated business concepts'\*\* for \`deprecated\`.\
> \- \*\*'View rejected business concepts'\*\* for \`rejected\`.\
> \- \*\*'View versioned business concepts'\*\* for \`versioned\`.\
> \
> Results are paginated by default. The response includes an \`x-total-count\` header, a \`scroll\_id\` when scrolling is active, and only the hypermedia actions the caller is authorized to perform.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concepts/{business_concept_id}/versions":{"get":{"description":"Returns business concept versions visible to the authenticated user.\n\n**Permissions:** Visibility is restricted by the caller's status-specific and domain-scoped permissions. Only versions the caller is allowed to view are returned. The exact permission depends on the version's current status:\n- **'View draft business concepts'** for `draft`.\n- **'View business concepts pending approval'** for `pending_approval`.\n- **'View published business concepts'** for `published`.\n- **'View deprecated business concepts'** for `deprecated`.\n- **'View rejected business concepts'** for `rejected`.\n- **'View versioned business concepts'** for `versioned`.\n\nResults are paginated by default. The response includes an `x-total-count` header, a `scroll_id` when scrolling is active, and only the hypermedia actions the caller is authorized to perform.\n","operationId":"TdBgWeb.BusinessConceptVersionSearchController.index (2)","parameters":[{"description":"Zero-based page number. Defaults to `0`.","in":"query","name":"page","required":false,"schema":{"default":0,"type":"integer"}},{"description":"Maximum number of results returned. Defaults to `50`.","in":"query","name":"size","required":false,"schema":{"default":50,"type":"integer"}},{"description":"When `true`, includes links associated with each returned version when the authenticated user is authorized to view them. Defaults to `false`.","in":"query","name":"include_links","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Creates a scroll search context with the supplied lifetime, for example `1m`. Use the returned `scroll_id` to request subsequent result pages.","in":"query","name":"scroll","required":false,"schema":{"type":"string"}},{"description":"Identifier returned by a previous scroll search. Supplying it continues that search context.","in":"query","name":"scroll_id","required":false,"schema":{"type":"string"}},{"description":"Exact match filters. Valid keys:\n- `status`: Array of strings (`draft`, `pending_approval`, `published`, `deprecated`, `rejected`)\n- `domain_id`: Integer or array of integers\n- `business_concept_id`: Integer\n- `type`: String (template name)\n- Any custom fields defined in business concept templates (configured as list-of-values)\n","explode":true,"in":"query","name":"filters","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Filters combined with AND logic. A status in `must` also selects the permission required to search that status: `published` requires View published business concepts; `deprecated` requires View deprecated business concepts; `draft`, `pending_approval`, or `rejected` requires the corresponding view permission for that status.\n","explode":true,"in":"query","name":"must","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Sort fields. Prefix a field with `-` for descending order. For an active non-default request language, localized sortable fields are used when they exist.","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"Full-text search across the concept name, description, and searchable content fields.","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"ID of the business concept whose versions must be returned. This parameter is used only by the nested route; omit it for the collection route.","in":"path","name":"business_concept_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionSearchResponse"}}},"description":"Search results"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List business concept versions by filters or concept ID","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionSearchResponse":{"additionalProperties":false,"properties":{"_actions":{"nullable":true,"type":"object"},"data":{"items":{"$ref":"#/components/schemas/BusinessConceptVersion"},"type":"array"},"scroll_id":{"description":"Identifier for the next page when a scroll search is active.","nullable":true,"type":"string"}},"required":["data"],"title":"BusinessConceptVersionSearchResponse","type":"object"},"BusinessConceptVersion":{"additionalProperties":true,"properties":{"_actions":{"nullable":true,"type":"object"},"business_concept_id":{"type":"integer"},"content":{"additionalProperties":true,"type":"object"},"domain_id":{"nullable":true,"type":"integer"},"domain_parents":{"items":{"type":"object"},"nullable":true,"type":"array"},"id":{"type":"integer"},"last_change_at":{"format":"date-time","nullable":true,"type":"string"},"links":{"items":{"type":"object"},"nullable":true,"type":"array"},"name":{"type":"string"},"status":{"enum":["draft","pending_approval","rejected","published","deprecated","versioned"],"type":"string"}},"required":["id","business_concept_id","name","status"],"title":"BusinessConceptVersion","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Search business concept versions

> Searches business concept versions using a JSON request body instead of query parameters.\
> \
> \*\*Permissions:\*\*\
> Visibility is restricted by the caller's status‑specific and domain‑scoped permissions. Only versions the caller is allowed to view are returned, using the same view permissions as the \`index\` operation.\
> \
> \*\*Request body:\*\*\
> \- \`page\` (optional, integer) – Page number. Default: \`0\`.\
> \- \`size\` (optional, integer) – Page size. Default: \`50\`.\
> \- \`include\_links\` (optional, boolean) – When \`true\`, each returned version includes its associated links, filtered by the caller's view permissions. Default: \`false\`.\
> \- \`only\_linkable\` (optional, boolean) – When \`true\`, restricts the result set to concepts that can be linked by the caller. The filter is applied at query time and the effective subset depends on the caller's permissions on each concept's domain. It does not require an additional permission to enable the parameter itself. Default: \`false\`.\
> \- \`filters\` (optional, object) – Exact‑match criteria.\
> \- \`must\` (optional, object) – Criteria combined with AND logic. A \`status\` value in \`must\` also selects the permission required to search that status: \`published\` requires \*\*'View published business concepts'\*\*; \`deprecated\` requires \*\*'View deprecated business concepts'\*\*; \`draft\`, \`pending\_approval\`, or \`rejected\` require the corresponding view permission.\
> \- \`sort\` (optional) – In JSON mode, an object mapping field names to \`asc\` or \`desc\`. In query‑parameter mode, the same sorting is expressed as a string. When the active request language differs from the default, localized sortable fields are used if they exist for the field being sorted.\
> \
> The response includes an \`x-total-count\` header with the total number of matches, a \`scroll\_id\` when scrolling is active, and only the hypermedia actions the caller is authorized to perform.\
> \
> Using the \`must\` container with a specific \`status\` value is the recommended way to search a specific status and trigger the corresponding permission check.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/search":{"post":{"description":"Searches business concept versions using a JSON request body instead of query parameters.\n\n**Permissions:**\nVisibility is restricted by the caller's status‑specific and domain‑scoped permissions. Only versions the caller is allowed to view are returned, using the same view permissions as the `index` operation.\n\n**Request body:**\n- `page` (optional, integer) – Page number. Default: `0`.\n- `size` (optional, integer) – Page size. Default: `50`.\n- `include_links` (optional, boolean) – When `true`, each returned version includes its associated links, filtered by the caller's view permissions. Default: `false`.\n- `only_linkable` (optional, boolean) – When `true`, restricts the result set to concepts that can be linked by the caller. The filter is applied at query time and the effective subset depends on the caller's permissions on each concept's domain. It does not require an additional permission to enable the parameter itself. Default: `false`.\n- `filters` (optional, object) – Exact‑match criteria.\n- `must` (optional, object) – Criteria combined with AND logic. A `status` value in `must` also selects the permission required to search that status: `published` requires **'View published business concepts'**; `deprecated` requires **'View deprecated business concepts'**; `draft`, `pending_approval`, or `rejected` require the corresponding view permission.\n- `sort` (optional) – In JSON mode, an object mapping field names to `asc` or `desc`. In query‑parameter mode, the same sorting is expressed as a string. When the active request language differs from the default, localized sortable fields are used if they exist for the field being sorted.\n\nThe response includes an `x-total-count` header with the total number of matches, a `scroll_id` when scrolling is active, and only the hypermedia actions the caller is authorized to perform.\n\nUsing the `must` container with a specific `status` value is the recommended way to search a specific status and trigger the corresponding permission check.\n","operationId":"TdBgWeb.BusinessConceptVersionSearchController.search","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionSearchRequest"}}},"description":"Search filters","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionSearchResponse"}}},"description":"Search results"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Search business concept versions","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionSearchRequest":{"additionalProperties":true,"properties":{"filters":{"additionalProperties":true,"description":"Exact-match search criteria.","nullable":true,"type":"object"},"include_links":{"default":false,"description":"Include authorized links for each result. Defaults to `false`.","type":"boolean"},"must":{"additionalProperties":true,"description":"Mandatory search criteria. A status here determines the required status-view permission.","nullable":true,"type":"object"},"only_linkable":{"default":false,"description":"If true, returns only concepts that can be linked. The user must have the `Manage business concept links` permission. Defaults to `false`.","type":"boolean"},"page":{"default":0,"description":"Zero-based page number. Defaults to `0`.","type":"integer"},"query":{"description":"Full-text search term.","nullable":true,"type":"string"},"scroll":{"description":"Scroll context lifetime for large result sets.","nullable":true,"type":"string"},"scroll_id":{"description":"Identifier returned by a previous scroll request.","nullable":true,"type":"string"},"size":{"default":50,"description":"Maximum results per page. Defaults to `50`.","type":"integer"},"sort":{"additionalProperties":{"enum":["asc","desc"],"type":"string"},"description":"Map of sort field to direction, for example `%{'name.raw' => 'asc'}`.","type":"object"}},"title":"BusinessConceptVersionSearchRequest","type":"object"},"BusinessConceptVersionSearchResponse":{"additionalProperties":false,"properties":{"_actions":{"nullable":true,"type":"object"},"data":{"items":{"$ref":"#/components/schemas/BusinessConceptVersion"},"type":"array"},"scroll_id":{"description":"Identifier for the next page when a scroll search is active.","nullable":true,"type":"string"}},"required":["data"],"title":"BusinessConceptVersionSearchResponse","type":"object"},"BusinessConceptVersion":{"additionalProperties":true,"properties":{"_actions":{"nullable":true,"type":"object"},"business_concept_id":{"type":"integer"},"content":{"additionalProperties":true,"type":"object"},"domain_id":{"nullable":true,"type":"integer"},"domain_parents":{"items":{"type":"object"},"nullable":true,"type":"array"},"id":{"type":"integer"},"last_change_at":{"format":"date-time","nullable":true,"type":"string"},"links":{"items":{"type":"object"},"nullable":true,"type":"array"},"name":{"type":"string"},"status":{"enum":["draft","pending_approval","rejected","published","deprecated","versioned"],"type":"string"}},"required":["id","business_concept_id","name","status"],"title":"BusinessConceptVersion","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Reject business concept version

> Rejects a business concept version that is currently pending approval.\
> \
> Requires \*\*'Reject business concepts'\*\* on the version's domain.\
> \
> \*\*Request body:\*\*\
> \- \`reject\_reason\` (optional, string) – Free‑text reason stored with the rejection.\
> \
> The version must be in \`pending\_approval\` status and must be the latest version. On success, the version becomes \`rejected\`.\
> \
> Rejected versions can be returned to \`draft\` through the \`undo\_rejection\` endpoint.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/reject":{"post":{"description":"Rejects a business concept version that is currently pending approval.\n\nRequires **'Reject business concepts'** on the version's domain.\n\n**Request body:**\n- `reject_reason` (optional, string) – Free‑text reason stored with the rejection.\n\nThe version must be in `pending_approval` status and must be the latest version. On success, the version becomes `rejected`.\n\nRejected versions can be returned to `draft` through the `undo_rejection` endpoint.\n","operationId":"TdBgWeb.BusinessConceptVersionController.reject","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionRejectRequest"}}},"description":"Reject reason payload","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionShowResponse"}}},"description":"Business concept version rejected"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgNotFoundResponse"}}},"description":"Not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnprocessableEntityArrayResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Reject business concept version","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionRejectRequest":{"additionalProperties":false,"properties":{"reject_reason":{"description":"Reason explaining why the version is rejected.","type":"string"}},"title":"BusinessConceptVersionRejectRequest","type":"object"},"BusinessConceptVersionShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"title":"BusinessConceptVersionShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgNotFoundResponse","type":"object"},"TdBgUnprocessableEntityArrayResponse":{"properties":{"errors":{"items":{"properties":{"code":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"title":"TdBgUnprocessableEntityArrayResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Create new version from published business concept version

> Creates a new draft successor from the latest published version.\
> \
> Requires \*\*'Update business concepts'\*\* on the concept's domain.\
> \
> The source version must be \`published\` and the current version. The new version is created in \`draft\` status with a version number one greater than the source, and becomes the current version.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/version":{"post":{"description":"Creates a new draft successor from the latest published version.\n\nRequires **'Update business concepts'** on the concept's domain.\n\nThe source version must be `published` and the current version. The new version is created in `draft` status with a version number one greater than the source, and becomes the current version.\n","operationId":"TdBgWeb.BusinessConceptVersionController.version","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionShowResponse"}}},"description":"Business concept version created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgNotFoundResponse"}}},"description":"Not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnprocessableEntityArrayResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Create new version from published business concept version","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"title":"BusinessConceptVersionShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgNotFoundResponse","type":"object"},"TdBgUnprocessableEntityArrayResponse":{"properties":{"errors":{"items":{"properties":{"code":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"title":"TdBgUnprocessableEntityArrayResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## List business concept versions by filters or concept ID

> Returns business concept versions visible to the authenticated user.\
> \
> \*\*Permissions:\*\* Visibility is restricted by the caller's status-specific and domain-scoped permissions. Only versions the caller is allowed to view are returned. The exact permission depends on the version's current status:\
> \- \*\*'View draft business concepts'\*\* for \`draft\`.\
> \- \*\*'View business concepts pending approval'\*\* for \`pending\_approval\`.\
> \- \*\*'View published business concepts'\*\* for \`published\`.\
> \- \*\*'View deprecated business concepts'\*\* for \`deprecated\`.\
> \- \*\*'View rejected business concepts'\*\* for \`rejected\`.\
> \- \*\*'View versioned business concepts'\*\* for \`versioned\`.\
> \
> Results are paginated by default. The response includes an \`x-total-count\` header, a \`scroll\_id\` when scrolling is active, and only the hypermedia actions the caller is authorized to perform.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions":{"get":{"description":"Returns business concept versions visible to the authenticated user.\n\n**Permissions:** Visibility is restricted by the caller's status-specific and domain-scoped permissions. Only versions the caller is allowed to view are returned. The exact permission depends on the version's current status:\n- **'View draft business concepts'** for `draft`.\n- **'View business concepts pending approval'** for `pending_approval`.\n- **'View published business concepts'** for `published`.\n- **'View deprecated business concepts'** for `deprecated`.\n- **'View rejected business concepts'** for `rejected`.\n- **'View versioned business concepts'** for `versioned`.\n\nResults are paginated by default. The response includes an `x-total-count` header, a `scroll_id` when scrolling is active, and only the hypermedia actions the caller is authorized to perform.\n","operationId":"TdBgWeb.BusinessConceptVersionSearchController.index","parameters":[{"description":"Zero-based page number. Defaults to `0`.","in":"query","name":"page","required":false,"schema":{"default":0,"type":"integer"}},{"description":"Maximum number of results returned. Defaults to `50`.","in":"query","name":"size","required":false,"schema":{"default":50,"type":"integer"}},{"description":"When `true`, includes links associated with each returned version when the authenticated user is authorized to view them. Defaults to `false`.","in":"query","name":"include_links","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Creates a scroll search context with the supplied lifetime, for example `1m`. Use the returned `scroll_id` to request subsequent result pages.","in":"query","name":"scroll","required":false,"schema":{"type":"string"}},{"description":"Identifier returned by a previous scroll search. Supplying it continues that search context.","in":"query","name":"scroll_id","required":false,"schema":{"type":"string"}},{"description":"Exact match filters. Valid keys:\n- `status`: Array of strings (`draft`, `pending_approval`, `published`, `deprecated`, `rejected`)\n- `domain_id`: Integer or array of integers\n- `business_concept_id`: Integer\n- `type`: String (template name)\n- Any custom fields defined in business concept templates (configured as list-of-values)\n","explode":true,"in":"query","name":"filters","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Filters combined with AND logic. A status in `must` also selects the permission required to search that status: `published` requires View published business concepts; `deprecated` requires View deprecated business concepts; `draft`, `pending_approval`, or `rejected` requires the corresponding view permission for that status.\n","explode":true,"in":"query","name":"must","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Sort fields. Prefix a field with `-` for descending order. For an active non-default request language, localized sortable fields are used when they exist.","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"Full-text search across the concept name, description, and searchable content fields.","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"ID of the business concept whose versions must be returned. This parameter is used only by the nested route; omit it for the collection route.","in":"path","name":"business_concept_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionSearchResponse"}}},"description":"Search results"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List business concept versions by filters or concept ID","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionSearchResponse":{"additionalProperties":false,"properties":{"_actions":{"nullable":true,"type":"object"},"data":{"items":{"$ref":"#/components/schemas/BusinessConceptVersion"},"type":"array"},"scroll_id":{"description":"Identifier for the next page when a scroll search is active.","nullable":true,"type":"string"}},"required":["data"],"title":"BusinessConceptVersionSearchResponse","type":"object"},"BusinessConceptVersion":{"additionalProperties":true,"properties":{"_actions":{"nullable":true,"type":"object"},"business_concept_id":{"type":"integer"},"content":{"additionalProperties":true,"type":"object"},"domain_id":{"nullable":true,"type":"integer"},"domain_parents":{"items":{"type":"object"},"nullable":true,"type":"array"},"id":{"type":"integer"},"last_change_at":{"format":"date-time","nullable":true,"type":"string"},"links":{"items":{"type":"object"},"nullable":true,"type":"array"},"name":{"type":"string"},"status":{"enum":["draft","pending_approval","rejected","published","deprecated","versioned"],"type":"string"}},"required":["id","business_concept_id","name","status"],"title":"BusinessConceptVersion","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Create business concept version

> Creates a new draft business concept version.\
> \
> Requires \*\*'Create business concepts'\*\* on the target domain.\
> \
> \*\*Request body:\*\*\
> \- \`type\` (required, string) – Template name; determines the content schema and the type of the concept.\
> \- \`name\` (required, string) – Concept name. Must be unique.\
> \- \`domain\_id\` (required, integer) – Target domain.\
> \- \`content\` (required, object) – Values for the template fields.\
> \- \`confidential\` (optional, boolean) – Default: \`false\`. Setting it to \`true\` requires \*\*'Manage confidential business concepts'\*\*.\
> \
> The version is created in \`draft\` status with version number \`1\`.\
> \
> The response includes the template used to interpret the content and the user‑authorized hypermedia actions for the newly created version.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions":{"post":{"description":"Creates a new draft business concept version.\n\nRequires **'Create business concepts'** on the target domain.\n\n**Request body:**\n- `type` (required, string) – Template name; determines the content schema and the type of the concept.\n- `name` (required, string) – Concept name. Must be unique.\n- `domain_id` (required, integer) – Target domain.\n- `content` (required, object) – Values for the template fields.\n- `confidential` (optional, boolean) – Default: `false`. Setting it to `true` requires **'Manage confidential business concepts'**.\n\nThe version is created in `draft` status with version number `1`.\n\nThe response includes the template used to interpret the content and the user‑authorized hypermedia actions for the newly created version.\n","operationId":"TdBgWeb.BusinessConceptVersionController.create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionCreateRequest"}}},"description":"Business concept version payload","required":false},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionShowResponse"}}},"description":"Business concept version created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BGUnprocessableEntityArrayOrObjectResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Create business concept version","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionCreateRequest":{"additionalProperties":false,"properties":{"business_concept_version":{"additionalProperties":false,"properties":{"confidential":{"default":false,"description":"Whether the business concept is confidential. Defaults to `false` when omitted.","type":"boolean"},"content":{"additionalProperties":true,"description":"Structured content whose fields and validation rules are defined by the selected template.","type":"object"},"domain_id":{"description":"ID of the domain that owns the business concept.","type":"integer"},"name":{"description":"Business concept name. It must be available in the selected domain group.","type":"string"},"type":{"description":"Name of the business concept template.","type":"string"}},"required":["type","name","domain_id","content"],"type":"object"}},"required":["business_concept_version"],"title":"BusinessConceptVersionCreateRequest","type":"object"},"BusinessConceptVersionShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"title":"BusinessConceptVersionShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"BGUnprocessableEntityArrayOrObjectResponse":{"description":"Response for 422 errors. Errors value might be an array or an object","oneOf":[{"$ref":"#/components/schemas/TdBgUnprocessableEntityArrayResponse"},{"$ref":"#/components/schemas/TdBgUnprocessableEntityObjectResponse"}],"title":"BGUnprocessableEntityArrayOrObjectResponse"},"TdBgUnprocessableEntityArrayResponse":{"properties":{"errors":{"items":{"properties":{"code":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"title":"TdBgUnprocessableEntityArrayResponse","type":"object"},"TdBgUnprocessableEntityObjectResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgUnprocessableEntityObjectResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Download business concepts as XLSX

> Exports up to 10,000 business concept versions matching the supplied search criteria as an Excel (XLSX) workbook. This is the same format used by the upload endpoint, so the file can be modified and re‑uploaded.\
> \
> \*\*Permissions:\*\* The export applies the download permissions corresponding to each concept's status:\
> \- \*\*'View published business concepts'\*\* for published versions.\
> \- \*\*'View deprecated business concepts'\*\* for deprecated versions.\
> \- Any of \*\*'View draft business concepts'\*\*, \*\*'View rejected business concepts'\*\*, or \*\*'View business concepts pending approval'\*\* for versions in those states.\
> \
> Only versions the caller can view are included in the workbook.\
> \
> \*\*Workbook structure:\*\*\
> \- \*\*Sheets:\*\* one sheet per concept type (template). The sheet name is the \*\*template name\*\* (not the label).\
> \- \*\*Common columns:\*\* \`id\`, \`current\_version\_id\`, \`name\`, \`domain\_external\_id\`, \`domain\_name\`, \`status\`, \`completeness\`, \`last\_change\_at\`, \`inserted\_at\`, \`link\_to\_concept\`.\
> \- \*\*Template fields:\*\* one column per template field, headed by the \*\*field name\*\* (not the label).\
> \
> Pagination parameters (\`page\`, \`size\`) are accepted but ignored; the export always streams all matching records up to the 10,000 limit. If no concepts match, the endpoint returns an empty workbook rather than \`204\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/xlsx":{"post":{"description":"Exports up to 10,000 business concept versions matching the supplied search criteria as an Excel (XLSX) workbook. This is the same format used by the upload endpoint, so the file can be modified and re‑uploaded.\n\n**Permissions:** The export applies the download permissions corresponding to each concept's status:\n- **'View published business concepts'** for published versions.\n- **'View deprecated business concepts'** for deprecated versions.\n- Any of **'View draft business concepts'**, **'View rejected business concepts'**, or **'View business concepts pending approval'** for versions in those states.\n\nOnly versions the caller can view are included in the workbook.\n\n**Workbook structure:**\n- **Sheets:** one sheet per concept type (template). The sheet name is the **template name** (not the label).\n- **Common columns:** `id`, `current_version_id`, `name`, `domain_external_id`, `domain_name`, `status`, `completeness`, `last_change_at`, `inserted_at`, `link_to_concept`.\n- **Template fields:** one column per template field, headed by the **field name** (not the label).\n\nPagination parameters (`page`, `size`) are accepted but ignored; the export always streams all matching records up to the 10,000 limit. If no concepts match, the endpoint returns an empty workbook rather than `204`.\n","operationId":"TdBgWeb.BusinessConceptVersionController.xlsx","parameters":[{"description":"Full-text search across the business concept name, description, and searchable template content.","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Exact-match filter object. For example: `{\"domain_id\": 12, \"status\": \"published\"}`.\nCommon fields include `domain_id`, `status`, `confidential`, `type`, and `name`; template-specific fields may also be supported.\nValues in `must` and `must_not` use the same filter structure when supported by the search endpoint.\n","explode":true,"in":"query","name":"filters","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Sort fields, for example `name.raw` or `-last_change_at`; prefix a field with `-` for descending order.","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"Creates a scroll context with the supplied lifetime, for example `2m`, for retrieving a large result set.","in":"query","name":"scroll","required":false,"schema":{"type":"string"}},{"description":"Identifier returned by a previous scroll search. Use it to continue that result set.","in":"query","name":"scroll_id","required":false,"schema":{"type":"string"}},{"description":"When `true`, restricts the results to concepts that can be linked by the caller. The filter is applied at query time and the effective set depends on the caller's permissions on each concept's domain.","in":"query","name":"only_linkable","required":false,"schema":{"type":"boolean"}},{"description":"Language code used for translated export content (e.g., 'en', 'es'). When omitted, the service uses its configured default language.","in":"query","name":"lang","required":false,"schema":{"type":"string"}},{"description":"Optional URL pattern used to build concept links in the exported file.","in":"query","name":"concept_url_schema","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"format":"binary","type":"string"}}},"description":"XLSX file downloaded"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Download business concepts as XLSX","tags":["Business Concept Versions"]}}},"components":{"schemas":{"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```

## Update business concept domain

> Changes the domain associated with a business concept version.\
> \
> Requires \*\*'Manage business concept domain'\*\* on both the current domain and the target domain.\
> \
> \*\*Request body:\*\*\
> \- \`domain\_id\` (required, integer) – Target domain ID.\
> \
> This operation is not available through the file upload flow; it can only be performed through the API or the web interface.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/domain":{"post":{"description":"Changes the domain associated with a business concept version.\n\nRequires **'Manage business concept domain'** on both the current domain and the target domain.\n\n**Request body:**\n- `domain_id` (required, integer) – Target domain ID.\n\nThis operation is not available through the file upload flow; it can only be performed through the API or the web interface.\n","operationId":"TdBgWeb.BusinessConceptVersionController.update_domain","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionUpdateDomainRequest"}}},"description":"Domain update payload","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessConceptVersionShowResponse"}}},"description":"Business concept domain updated"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Update business concept domain","tags":["Business Concept Versions"]}}},"components":{"schemas":{"BusinessConceptVersionUpdateDomainRequest":{"additionalProperties":false,"properties":{"domain_id":{"description":"ID of the new domain. The caller must be authorized for both the current and new domain.","type":"integer"}},"required":["domain_id"],"title":"BusinessConceptVersionUpdateDomainRequest","type":"object"},"BusinessConceptVersionShowResponse":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"title":"BusinessConceptVersionShowResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```
