> 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/v8.8/api-integrations/business-glossary-apis/business-concept-versions.md).

# Business Concept Versions

## Send business concept version for approval

> Submit the specified business concept version for review and approval.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/submit":{"post":{"description":"Submit the specified business concept version for review and approval.","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

> Deprecate the specified business concept version so it is no longer current.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/deprecate":{"post":{"description":"Deprecate the specified business concept version so it is no longer current.","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

> Return hypermedia actions available for business concept versions based on the current user permissions.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/actions":{"get":{"description":"Return hypermedia actions available for business concept versions based on the current user permissions.","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

> Restore a deprecated business concept version back to a publishable state.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/restore":{"post":{"description":"Restore a deprecated business concept version back to a publishable state.","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

> Upload an Excel file to create or update business concept versions in bulk.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/upload":{"post":{"description":"Upload an Excel file to create or update business concept versions in bulk.","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 auto-publish after upload","enum":["true","false"],"type":"string"},"business_concepts":{"description":"Excel file (.xlsx) with business concepts","format":"binary","type":"string"},"lang":{"default":"en","description":"Language code for the content","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

> Download a CSV export of business concept version results matching the current filters.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/csv":{"post":{"description":"Download a CSV export of business concept version results matching the current filters.","operationId":"TdBgWeb.BusinessConceptVersionController.csv","parameters":[{"description":"Full‑text search across business concept fields","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Filter object. Example: `{\"domain_id\": 12, \"status\": \"published\"}`.\nAvailable fields: domain_id, status, confidential, type, name, etc.\nFor more complex queries, you can also use `must` and `must_not` with the same object structure.\n","explode":true,"in":"query","name":"filters","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Sort field(s), e.g. `name.raw`, `-last_change_at`","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"Scroll timeout (e.g. `2m`)","in":"query","name":"scroll","required":false,"schema":{"type":"string"}},{"description":"Scroll ID to continue a previous scroll","in":"query","name":"scroll_id","required":false,"schema":{"type":"string"}},{"description":"If `true`, returns only concepts that can be linked","in":"query","name":"only_linkable","required":false,"schema":{"type":"boolean"}},{"description":"Language code (e.g., 'en', 'es')","in":"query","name":"lang","required":false,"schema":{"type":"string"}},{"description":"URL schema for concept links","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

> Restore a rejected business concept version to draft status.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/redraft":{"post":{"description":"Restore a rejected business concept version to draft status.","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

> Update the confidentiality setting for a business concept version.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/set_confidential":{"post":{"description":"Update the confidentiality setting for a business concept version.","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

> Retrieve the details of a specific business concept version.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concepts/{business_concept_id}/versions/{id}":{"get":{"description":"Retrieve the details of a specific business concept version.","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

> Update multiple business concept versions in bulk based on the provided search criteria and update payload.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/bulk_update":{"post":{"description":"Update multiple business concept versions in bulk based on the provided search criteria and update payload.","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

> Update an existing business concept version with new content or metadata.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{id}":{"put":{"description":"Update an existing business concept version with new content or metadata.","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":"Updated structured content","type":"object"},"name":{"description":"Updated 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

> Delete the specified business concept version.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{id}":{"delete":{"description":"Delete the specified business concept version.","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

> Publish the specified business concept version once it is approved.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/publish":{"post":{"description":"Publish the specified business concept version once it is approved.","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

> Retrieve a paginated list of business concept versions filtered by query parameters or business concept ID.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concepts/{business_concept_id}/versions":{"get":{"description":"Retrieve a paginated list of business concept versions filtered by query parameters or business concept ID.","operationId":"TdBgWeb.BusinessConceptVersionSearchController.index (2)","parameters":[{"description":"Número de página (0-indexed)","in":"query","name":"page","required":false,"schema":{"default":0,"type":"integer"}},{"description":"Cantidad de resultados por página","in":"query","name":"size","required":false,"schema":{"default":50,"type":"integer"}},{"description":"Si es `true`, incluye relaciones de enlaces en la respuesta","in":"query","name":"include_links","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Tiempo de expiración del scroll (ej. `1m`)","in":"query","name":"scroll","required":false,"schema":{"type":"string"}},{"description":"ID de scroll para continuar paginando","in":"query","name":"scroll_id","required":false,"schema":{"type":"string"}},{"description":"Filtros exactos (objeto JSON)","explode":true,"in":"query","name":"filters","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Filtros obligatorios (objeto JSON)","explode":true,"in":"query","name":"must","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Campos de ordenamiento (ej. `name.raw`, `-last_change_at`)","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"Búsqueda de texto completo","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Business concept id","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":{"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

> Execute a search for business concept versions using advanced filters provided in the request body.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/search":{"post":{"description":"Execute a search for business concept versions using advanced filters provided in the request body.","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":false,"properties":{"filters":{"additionalProperties":true,"nullable":true,"type":"object"},"include_links":{"default":false,"type":"boolean"},"must":{"additionalProperties":true,"nullable":true,"type":"object"},"only_linkable":{"default":false,"description":"If true, returns only concepts that can be linked (user must have manage_business_concept_links permission)","type":"boolean"},"page":{"default":0,"type":"integer"},"query":{"nullable":true,"type":"string"},"scroll":{"nullable":true,"type":"string"},"scroll_id":{"nullable":true,"type":"string"},"size":{"default":50,"type":"integer"},"sort":{"additionalProperties":true,"nullable":true,"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":{"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

> Reject the specified business concept version with a given reason.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/reject":{"post":{"description":"Reject the specified business concept version with a given reason.","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 for rejection","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

> Create a successor version from an existing published business concept version.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/version":{"post":{"description":"Create a successor version from an existing published business concept version.","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

> Retrieve a paginated list of business concept versions filtered by query parameters or business concept ID.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions":{"get":{"description":"Retrieve a paginated list of business concept versions filtered by query parameters or business concept ID.","operationId":"TdBgWeb.BusinessConceptVersionSearchController.index","parameters":[{"description":"Número de página (0-indexed)","in":"query","name":"page","required":false,"schema":{"default":0,"type":"integer"}},{"description":"Cantidad de resultados por página","in":"query","name":"size","required":false,"schema":{"default":50,"type":"integer"}},{"description":"Si es `true`, incluye relaciones de enlaces en la respuesta","in":"query","name":"include_links","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Tiempo de expiración del scroll (ej. `1m`)","in":"query","name":"scroll","required":false,"schema":{"type":"string"}},{"description":"ID de scroll para continuar paginando","in":"query","name":"scroll_id","required":false,"schema":{"type":"string"}},{"description":"Filtros exactos (objeto JSON)","explode":true,"in":"query","name":"filters","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Filtros obligatorios (objeto JSON)","explode":true,"in":"query","name":"must","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Campos de ordenamiento (ej. `name.raw`, `-last_change_at`)","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"Búsqueda de texto completo","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Business concept id","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":{"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

> Create a new business concept version for the specified concept template and domain.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions":{"post":{"description":"Create a new business concept version for the specified concept template and domain.","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":"Confidential flag","type":"boolean"},"content":{"additionalProperties":true,"description":"Structured content according to template","type":"object"},"domain_id":{"description":"Domain ID","type":"integer"},"name":{"description":"Concept name","type":"string"},"type":{"description":"Template name","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

> Download a spreadsheet containing business concept version results returned by the current search criteria.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/xlsx":{"post":{"description":"Download a spreadsheet containing business concept version results returned by the current search criteria.","operationId":"TdBgWeb.BusinessConceptVersionController.xlsx","parameters":[{"description":"Full‑text search across business concept fields","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Filter object. Example: `{\"domain_id\": 12, \"status\": \"published\"}`.\nAvailable fields: domain_id, status, confidential, type, name, etc.\nFor more complex queries, you can also use `must` and `must_not` with the same object structure.\n","explode":true,"in":"query","name":"filters","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Sort field(s), e.g. `name.raw`, `-last_change_at`","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"Scroll timeout (e.g. `2m`)","in":"query","name":"scroll","required":false,"schema":{"type":"string"}},{"description":"Scroll ID to continue a previous scroll","in":"query","name":"scroll_id","required":false,"schema":{"type":"string"}},{"description":"If `true`, returns only concepts that can be linked","in":"query","name":"only_linkable","required":false,"schema":{"type":"boolean"}},{"description":"Language code (e.g., 'en', 'es')","in":"query","name":"lang","required":false,"schema":{"type":"string"}},{"description":"URL schema for concept links","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

> Change the domain of a business concept version.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/domain":{"post":{"description":"Change the domain of a business concept version.","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":"New domain ID","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"}}}}
```