> 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/links.md).

# Links

## Download business concept links XLSX

> Download an XLSX file containing business concept links matching the provided filters.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/links/download":{"post":{"description":"Download an XLSX file containing business concept links matching the provided filters.","operationId":"TdBgWeb.BusinessConceptLinkController.download","parameters":[{"description":"Full‑text search query","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Filter by domain ID","in":"query","name":"domain_id","required":false,"schema":{"type":"string"}},{"description":"Additional filters (JSON object)","explode":true,"in":"query","name":"filters","required":false,"schema":{"additionalProperties":true,"type":"object"},"style":"deepObject"},{"description":"Sort field(s)","in":"query","name":"sort","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 concept links XLSX","tags":["Links"]}}},"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"}}}}
```

## Create structure link action endpoint

> Endpoint used to represent the create structure link action in hypermedia responses.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/links/structures":{"post":{"description":"Endpoint used to represent the create structure link action in hypermedia responses.","operationId":"TdBgWeb.BusinessConceptLinkController.create_structure_link","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}}],"responses":{"202":{"description":"Accepted structure link action"},"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":"Create structure link action endpoint","tags":["Links"]}}},"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"}}}}
```

## Suggest structure link action endpoint

> Endpoint used to represent the suggest structure link action in hypermedia responses.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/links/structures/suggest":{"post":{"description":"Endpoint used to represent the suggest structure link action in hypermedia responses.","operationId":"TdBgWeb.BusinessConceptLinkController.suggest_structure_link","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}}],"responses":{"202":{"description":"Accepted structure link suggestion"},"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":"Suggest structure link action endpoint","tags":["Links"]}}},"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"}}}}
```

## Create concept link action endpoint

> Endpoint used to represent the create concept link action in hypermedia responses.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/{business_concept_version_id}/links/concepts":{"post":{"description":"Endpoint used to represent the create concept link action in hypermedia responses.","operationId":"TdBgWeb.BusinessConceptLinkController.create_concept_link","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}}],"responses":{"202":{"description":"Accepted concept link action"},"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":"Create concept link action endpoint","tags":["Links"]}}},"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"}}}}
```

## Delete business concept link

> Delete a link associated with 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}/links/{id}":{"delete":{"description":"Delete a link associated with a business concept version.","operationId":"TdBgWeb.BusinessConceptLinkController.delete","parameters":[{"description":"Business concept version ID","in":"path","name":"business_concept_version_id","required":true,"schema":{"type":"integer"}},{"description":"Business concept link ID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Business concept link deleted"},"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":"Delete business concept link","tags":["Links"]}}},"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"},"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"}}}}
```