> 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/data-catalog-data-lineage-and-grants-apis/data-structure-links.md).

# Data Structure Links

## Delete data structure link by external ids

> Deletes a data structure link identified by source and target external IDs.

```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.8.2"},"paths":{"/api/data_structure_links/search_delete_one":{"delete":{"description":"Deletes a data structure link identified by source and target external IDs.","operationId":"TdDdWeb.DataStructureLinkController.delete_by_external_ids","parameters":[{"description":"Source data structure external ID","in":"query","name":"source_external_id","required":true,"schema":{"type":"string"}},{"description":"Target data structure external ID","in":"query","name":"target_external_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Data structure link deleted"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdNotFoundErrorResponse"}}},"description":"Not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Delete data structure link by external ids","tags":["Data Structure Links"]}}},"components":{"schemas":{"TdDdUnauthorizedResponse":{"anyOf":[{"$ref":"#/components/schemas/TdDdUnauthorizedMessageResponse"},{"$ref":"#/components/schemas/TdDdUnauthorizedErrorResponse"}],"description":"Unauthorized response from auth plug or error view","title":"TdDdUnauthorizedResponse"},"TdDdUnauthorizedMessageResponse":{"additionalProperties":false,"properties":{"message":{"type":"string"}},"required":["message"],"title":"TdDdUnauthorizedMessageResponse","type":"object"},"TdDdUnauthorizedErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdUnauthorizedErrorResponse","type":"object"},"TdDdForbiddenResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdForbiddenResponse","type":"object"},"TdDdNotFoundErrorResponse":{"additionalProperties":false,"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdNotFoundErrorResponse","type":"object"},"TdDdInternalServerErrorResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdInternalServerErrorResponse","type":"object"}}}}
```

## List links by data structure ID

> Lists links for a data structure, filtered by the current user's visibility.

```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.8.2"},"paths":{"/api/data_structures/{data_structure_id}/structure_links":{"get":{"description":"Lists links for a data structure, filtered by the current user's visibility.","operationId":"TdDdWeb.DataStructureLinkController.index","parameters":[{"description":"Data structure ID","in":"path","name":"data_structure_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataStructureLinkIndexResponse"}}},"description":"Data structure links"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnauthorizedResponse"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List links by data structure ID","tags":["Data Structure Links"]}}},"components":{"schemas":{"DataStructureLinkIndexResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/DataStructureLinkResponseObject"},"type":"array"}},"required":["data"],"title":"DataStructureLinkIndexResponse","type":"object"},"DataStructureLinkResponseObject":{"additionalProperties":false,"properties":{"id":{"nullable":true,"type":"integer"},"inserted_at":{"type":"string"},"labels":{"items":{"type":"string"},"type":"array"},"source":{"$ref":"#/components/schemas/Source"},"source_external_id":{"nullable":true,"type":"string"},"source_id":{"nullable":true,"type":"integer"},"target":{"$ref":"#/components/schemas/Target"},"target_external_id":{"nullable":true,"type":"string"},"target_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["source","target","labels"],"title":"DataStructureLinkResponseObject","type":"object"},"Source":{"additionalProperties":false,"properties":{"confidential":{"type":"boolean"},"current_version":{"nullable":true,"type":"object"},"domain_ids":{"items":{"type":"integer"},"type":"array"},"domains":{"items":{"type":"object"},"nullable":true,"type":"array"},"external_id":{"nullable":true,"type":"string"},"id":{"type":"integer"},"inserted_at":{"type":"string"},"last_change_at":{"nullable":true,"type":"string"},"linked_concepts":{"items":{"type":"object"},"nullable":true,"type":"array"},"metadata":{"type":"object"},"path":{"items":{"type":"string"},"type":"array"},"source":{"type":"object"},"source_id":{"nullable":true,"type":"integer"},"system":{"anyOf":[{"$ref":"#/components/schemas/System"},{"additionalProperties":true,"type":"object"}],"nullable":true},"system_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["id"],"title":"Source","type":"object"},"System":{"additionalProperties":false,"properties":{"external_id":{"nullable":true,"type":"string"},"id":{"type":"integer"},"name":{"type":"string"}},"required":["id","name"],"title":"System","type":"object"},"Target":{"additionalProperties":false,"properties":{"confidential":{"type":"boolean"},"current_version":{"nullable":true,"type":"object"},"domain_ids":{"items":{"type":"integer"},"type":"array"},"domains":{"items":{"type":"object"},"nullable":true,"type":"array"},"external_id":{"nullable":true,"type":"string"},"id":{"type":"integer"},"inserted_at":{"type":"string"},"last_change_at":{"nullable":true,"type":"string"},"linked_concepts":{"items":{"type":"object"},"nullable":true,"type":"array"},"metadata":{"type":"object"},"path":{"items":{"type":"string"},"type":"array"},"source":{"type":"object"},"source_id":{"nullable":true,"type":"integer"},"system":{"anyOf":[{"$ref":"#/components/schemas/System"},{"additionalProperties":true,"type":"object"}],"nullable":true},"system_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["id"],"title":"Target","type":"object"},"TdDdUnauthorizedResponse":{"anyOf":[{"$ref":"#/components/schemas/TdDdUnauthorizedMessageResponse"},{"$ref":"#/components/schemas/TdDdUnauthorizedErrorResponse"}],"description":"Unauthorized response from auth plug or error view","title":"TdDdUnauthorizedResponse"},"TdDdUnauthorizedMessageResponse":{"additionalProperties":false,"properties":{"message":{"type":"string"}},"required":["message"],"title":"TdDdUnauthorizedMessageResponse","type":"object"},"TdDdUnauthorizedErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdUnauthorizedErrorResponse","type":"object"},"TdDdInternalServerErrorResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdInternalServerErrorResponse","type":"object"}}}}
```

## Create data structure link

> Creates a new data structure link or bulk loads links depending on the payload.

```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.8.2"},"paths":{"/api/data_structure_links":{"post":{"description":"Creates a new data structure link or bulk loads links depending on the payload.","operationId":"TdDdWeb.DataStructureLinkController.create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataStructureLinkCreateRequest"}}},"description":"Data structure link payload","required":false},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataStructureLinkCreateResponse"}}},"description":"Data structure link created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdForbiddenResponse"}}},"description":"Forbidden"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnprocessableEntityObjectResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Create data structure link","tags":["Data Structure Links"]}}},"components":{"schemas":{"DataStructureLinkCreateRequest":{"anyOf":[{"$ref":"#/components/schemas/DataStructureLinkCreateRequestSingle"},{"$ref":"#/components/schemas/DataStructureLinkCreateRequestBulk"}],"description":"Request to create one or multiple data structure links","title":"DataStructureLinkCreateRequest"},"DataStructureLinkCreateRequestSingle":{"additionalProperties":false,"properties":{"data_structure_link":{"$ref":"#/components/schemas/DataStructureLinkCreateRequestSingleObject"}},"required":["data_structure_link"],"title":"DataStructureLinkCreateRequestSingle","type":"object"},"DataStructureLinkCreateRequestSingleObject":{"additionalProperties":false,"properties":{"label_ids":{"items":{"type":"integer"},"type":"array"},"source_id":{"type":"integer"},"target_id":{"type":"integer"}},"required":["source_id","target_id"],"title":"DataStructureLinkCreateRequestSingleObject","type":"object"},"DataStructureLinkCreateRequestBulk":{"additionalProperties":false,"properties":{"data_structure_links":{"items":{"$ref":"#/components/schemas/DataStructureLinkCreateRequestBulkObject"},"type":"array"}},"required":["data_structure_links"],"title":"DataStructureLinkCreateRequestBulk","type":"object"},"DataStructureLinkCreateRequestBulkObject":{"additionalProperties":false,"description":"Response for bulk creation of data structure links.\nThe response includes `inserted` (successful links) and `not_inserted` (failed links with details).\nEven if some links fail, the overall response is 201 Created.\n","properties":{"label_names":{"items":{"type":"string"},"type":"array"},"source_external_id":{"description":"External ID of the source data structure. If invalid, the error will be reported in the response.","type":"string"},"target_external_id":{"description":"External ID of the source data structure. If invalid, the error will be reported in the response.","type":"string"}},"required":["source_external_id","target_external_id"],"title":"DataStructureLinkCreateRequestBulkObject","type":"object"},"DataStructureLinkCreateResponse":{"anyOf":[{"$ref":"#/components/schemas/DataStructureLinkCreateSingleResponse"},{"$ref":"#/components/schemas/DataStructureLinkBulkCreateResponse"}],"description":"Response for data structure link creation (single or bulk)","title":"DataStructureLinkCreateResponse"},"DataStructureLinkCreateSingleResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/DataStructureLinkResource"}},"required":["data"],"title":"DataStructureLinkCreateSingleResponse","type":"object"},"DataStructureLinkResource":{"additionalProperties":false,"properties":{"id":{"type":"integer"},"inserted_at":{"type":"string"},"labels":{"items":{"type":"string"},"type":"array"},"source_id":{"type":"integer"},"target_id":{"type":"integer"},"updated_at":{"nullable":true,"type":"string"}},"required":["source_id","target_id"],"title":"DataStructureLinkResource","type":"object"},"DataStructureLinkBulkCreateResponse":{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"inserted":{"items":{"additionalProperties":false,"properties":{"source_external_id":{"type":"string"},"target_external_id":{"type":"string"}},"required":["source_external_id","target_external_id"],"type":"object"},"type":"array"},"not_inserted":{"additionalProperties":false,"properties":{"changeset_invalid_links":{"items":{"items":{"type":"object"},"type":"array"},"type":"array"},"inexistent_structure":{"items":{"additionalProperties":false,"properties":{"source_external_id":{"type":"string"},"target_external_id":{"type":"string"}},"required":["source_external_id","target_external_id"],"type":"object"},"type":"array"}},"type":"object"}},"required":["inserted","not_inserted"],"type":"object"}},"required":["data"],"title":"DataStructureLinkBulkCreateResponse","type":"object"},"TdDdUnauthorizedResponse":{"anyOf":[{"$ref":"#/components/schemas/TdDdUnauthorizedMessageResponse"},{"$ref":"#/components/schemas/TdDdUnauthorizedErrorResponse"}],"description":"Unauthorized response from auth plug or error view","title":"TdDdUnauthorizedResponse"},"TdDdUnauthorizedMessageResponse":{"additionalProperties":false,"properties":{"message":{"type":"string"}},"required":["message"],"title":"TdDdUnauthorizedMessageResponse","type":"object"},"TdDdUnauthorizedErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdUnauthorizedErrorResponse","type":"object"},"TdDdForbiddenResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdForbiddenResponse","type":"object"},"TdDdUnprocessableEntityObjectResponse":{"additionalProperties":false,"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdUnprocessableEntityObjectResponse","type":"object"},"TdDdInternalServerErrorResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdInternalServerErrorResponse","type":"object"}}}}
```

## List links by external ID

> Lists links for a data structure identified by its external ID, filtered by user visibility.

```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.8.2"},"paths":{"/api/data_structure_links/search_all":{"get":{"description":"Lists links for a data structure identified by its external ID, filtered by user visibility.","operationId":"TdDdWeb.DataStructureLinkController.index_by_external_id","parameters":[{"description":"Data structure external ID","in":"query","name":"external_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataStructureLinkIndexResponse"}}},"description":"Data structure links"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnauthorizedResponse"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List links by external ID","tags":["Data Structure Links"]}}},"components":{"schemas":{"DataStructureLinkIndexResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/DataStructureLinkResponseObject"},"type":"array"}},"required":["data"],"title":"DataStructureLinkIndexResponse","type":"object"},"DataStructureLinkResponseObject":{"additionalProperties":false,"properties":{"id":{"nullable":true,"type":"integer"},"inserted_at":{"type":"string"},"labels":{"items":{"type":"string"},"type":"array"},"source":{"$ref":"#/components/schemas/Source"},"source_external_id":{"nullable":true,"type":"string"},"source_id":{"nullable":true,"type":"integer"},"target":{"$ref":"#/components/schemas/Target"},"target_external_id":{"nullable":true,"type":"string"},"target_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["source","target","labels"],"title":"DataStructureLinkResponseObject","type":"object"},"Source":{"additionalProperties":false,"properties":{"confidential":{"type":"boolean"},"current_version":{"nullable":true,"type":"object"},"domain_ids":{"items":{"type":"integer"},"type":"array"},"domains":{"items":{"type":"object"},"nullable":true,"type":"array"},"external_id":{"nullable":true,"type":"string"},"id":{"type":"integer"},"inserted_at":{"type":"string"},"last_change_at":{"nullable":true,"type":"string"},"linked_concepts":{"items":{"type":"object"},"nullable":true,"type":"array"},"metadata":{"type":"object"},"path":{"items":{"type":"string"},"type":"array"},"source":{"type":"object"},"source_id":{"nullable":true,"type":"integer"},"system":{"anyOf":[{"$ref":"#/components/schemas/System"},{"additionalProperties":true,"type":"object"}],"nullable":true},"system_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["id"],"title":"Source","type":"object"},"System":{"additionalProperties":false,"properties":{"external_id":{"nullable":true,"type":"string"},"id":{"type":"integer"},"name":{"type":"string"}},"required":["id","name"],"title":"System","type":"object"},"Target":{"additionalProperties":false,"properties":{"confidential":{"type":"boolean"},"current_version":{"nullable":true,"type":"object"},"domain_ids":{"items":{"type":"integer"},"type":"array"},"domains":{"items":{"type":"object"},"nullable":true,"type":"array"},"external_id":{"nullable":true,"type":"string"},"id":{"type":"integer"},"inserted_at":{"type":"string"},"last_change_at":{"nullable":true,"type":"string"},"linked_concepts":{"items":{"type":"object"},"nullable":true,"type":"array"},"metadata":{"type":"object"},"path":{"items":{"type":"string"},"type":"array"},"source":{"type":"object"},"source_id":{"nullable":true,"type":"integer"},"system":{"anyOf":[{"$ref":"#/components/schemas/System"},{"additionalProperties":true,"type":"object"}],"nullable":true},"system_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["id"],"title":"Target","type":"object"},"TdDdUnauthorizedResponse":{"anyOf":[{"$ref":"#/components/schemas/TdDdUnauthorizedMessageResponse"},{"$ref":"#/components/schemas/TdDdUnauthorizedErrorResponse"}],"description":"Unauthorized response from auth plug or error view","title":"TdDdUnauthorizedResponse"},"TdDdUnauthorizedMessageResponse":{"additionalProperties":false,"properties":{"message":{"type":"string"}},"required":["message"],"title":"TdDdUnauthorizedMessageResponse","type":"object"},"TdDdUnauthorizedErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdUnauthorizedErrorResponse","type":"object"},"TdDdInternalServerErrorResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdInternalServerErrorResponse","type":"object"}}}}
```

## Show data structure link by external ids

> Retrieves a data structure link by source and target external IDs.

```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.8.2"},"paths":{"/api/data_structure_links/search_one":{"get":{"description":"Retrieves a data structure link by source and target external IDs.","operationId":"TdDdWeb.DataStructureLinkController.show_by_external_ids","parameters":[{"description":"Source data structure external ID","in":"query","name":"source_external_id","required":true,"schema":{"type":"string"}},{"description":"Target data structure external ID","in":"query","name":"target_external_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataStructureLinkShowResponse"}}},"description":"Data structure link"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdNotFoundErrorResponse"}}},"description":"Not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Show data structure link by external ids","tags":["Data Structure Links"]}}},"components":{"schemas":{"DataStructureLinkShowResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/DataStructureLinkResponseObject"}},"required":["data"],"title":"DataStructureLinkShowResponse","type":"object"},"DataStructureLinkResponseObject":{"additionalProperties":false,"properties":{"id":{"nullable":true,"type":"integer"},"inserted_at":{"type":"string"},"labels":{"items":{"type":"string"},"type":"array"},"source":{"$ref":"#/components/schemas/Source"},"source_external_id":{"nullable":true,"type":"string"},"source_id":{"nullable":true,"type":"integer"},"target":{"$ref":"#/components/schemas/Target"},"target_external_id":{"nullable":true,"type":"string"},"target_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["source","target","labels"],"title":"DataStructureLinkResponseObject","type":"object"},"Source":{"additionalProperties":false,"properties":{"confidential":{"type":"boolean"},"current_version":{"nullable":true,"type":"object"},"domain_ids":{"items":{"type":"integer"},"type":"array"},"domains":{"items":{"type":"object"},"nullable":true,"type":"array"},"external_id":{"nullable":true,"type":"string"},"id":{"type":"integer"},"inserted_at":{"type":"string"},"last_change_at":{"nullable":true,"type":"string"},"linked_concepts":{"items":{"type":"object"},"nullable":true,"type":"array"},"metadata":{"type":"object"},"path":{"items":{"type":"string"},"type":"array"},"source":{"type":"object"},"source_id":{"nullable":true,"type":"integer"},"system":{"anyOf":[{"$ref":"#/components/schemas/System"},{"additionalProperties":true,"type":"object"}],"nullable":true},"system_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["id"],"title":"Source","type":"object"},"System":{"additionalProperties":false,"properties":{"external_id":{"nullable":true,"type":"string"},"id":{"type":"integer"},"name":{"type":"string"}},"required":["id","name"],"title":"System","type":"object"},"Target":{"additionalProperties":false,"properties":{"confidential":{"type":"boolean"},"current_version":{"nullable":true,"type":"object"},"domain_ids":{"items":{"type":"integer"},"type":"array"},"domains":{"items":{"type":"object"},"nullable":true,"type":"array"},"external_id":{"nullable":true,"type":"string"},"id":{"type":"integer"},"inserted_at":{"type":"string"},"last_change_at":{"nullable":true,"type":"string"},"linked_concepts":{"items":{"type":"object"},"nullable":true,"type":"array"},"metadata":{"type":"object"},"path":{"items":{"type":"string"},"type":"array"},"source":{"type":"object"},"source_id":{"nullable":true,"type":"integer"},"system":{"anyOf":[{"$ref":"#/components/schemas/System"},{"additionalProperties":true,"type":"object"}],"nullable":true},"system_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["id"],"title":"Target","type":"object"},"TdDdUnauthorizedResponse":{"anyOf":[{"$ref":"#/components/schemas/TdDdUnauthorizedMessageResponse"},{"$ref":"#/components/schemas/TdDdUnauthorizedErrorResponse"}],"description":"Unauthorized response from auth plug or error view","title":"TdDdUnauthorizedResponse"},"TdDdUnauthorizedMessageResponse":{"additionalProperties":false,"properties":{"message":{"type":"string"}},"required":["message"],"title":"TdDdUnauthorizedMessageResponse","type":"object"},"TdDdUnauthorizedErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdUnauthorizedErrorResponse","type":"object"},"TdDdForbiddenResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdForbiddenResponse","type":"object"},"TdDdNotFoundErrorResponse":{"additionalProperties":false,"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdNotFoundErrorResponse","type":"object"},"TdDdInternalServerErrorResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdInternalServerErrorResponse","type":"object"}}}}
```

## Show link by source and target IDs

> Retrieves a specific data structure link by source and target IDs.

```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.8.2"},"paths":{"/api/data_structures/structure_links/source/{source_id}/target/{target_id}":{"get":{"description":"Retrieves a specific data structure link by source and target IDs.","operationId":"TdDdWeb.DataStructureLinkController.show","parameters":[{"description":"Source data structure ID","in":"path","name":"source_id","required":true,"schema":{"type":"integer"}},{"description":"Target data structure ID","in":"path","name":"target_id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataStructureLinkShowResponse"}}},"description":"Data structure link"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdNotFoundErrorResponse"}}},"description":"Not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Show link by source and target IDs","tags":["Data Structure Links"]}}},"components":{"schemas":{"DataStructureLinkShowResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/DataStructureLinkResponseObject"}},"required":["data"],"title":"DataStructureLinkShowResponse","type":"object"},"DataStructureLinkResponseObject":{"additionalProperties":false,"properties":{"id":{"nullable":true,"type":"integer"},"inserted_at":{"type":"string"},"labels":{"items":{"type":"string"},"type":"array"},"source":{"$ref":"#/components/schemas/Source"},"source_external_id":{"nullable":true,"type":"string"},"source_id":{"nullable":true,"type":"integer"},"target":{"$ref":"#/components/schemas/Target"},"target_external_id":{"nullable":true,"type":"string"},"target_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["source","target","labels"],"title":"DataStructureLinkResponseObject","type":"object"},"Source":{"additionalProperties":false,"properties":{"confidential":{"type":"boolean"},"current_version":{"nullable":true,"type":"object"},"domain_ids":{"items":{"type":"integer"},"type":"array"},"domains":{"items":{"type":"object"},"nullable":true,"type":"array"},"external_id":{"nullable":true,"type":"string"},"id":{"type":"integer"},"inserted_at":{"type":"string"},"last_change_at":{"nullable":true,"type":"string"},"linked_concepts":{"items":{"type":"object"},"nullable":true,"type":"array"},"metadata":{"type":"object"},"path":{"items":{"type":"string"},"type":"array"},"source":{"type":"object"},"source_id":{"nullable":true,"type":"integer"},"system":{"anyOf":[{"$ref":"#/components/schemas/System"},{"additionalProperties":true,"type":"object"}],"nullable":true},"system_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["id"],"title":"Source","type":"object"},"System":{"additionalProperties":false,"properties":{"external_id":{"nullable":true,"type":"string"},"id":{"type":"integer"},"name":{"type":"string"}},"required":["id","name"],"title":"System","type":"object"},"Target":{"additionalProperties":false,"properties":{"confidential":{"type":"boolean"},"current_version":{"nullable":true,"type":"object"},"domain_ids":{"items":{"type":"integer"},"type":"array"},"domains":{"items":{"type":"object"},"nullable":true,"type":"array"},"external_id":{"nullable":true,"type":"string"},"id":{"type":"integer"},"inserted_at":{"type":"string"},"last_change_at":{"nullable":true,"type":"string"},"linked_concepts":{"items":{"type":"object"},"nullable":true,"type":"array"},"metadata":{"type":"object"},"path":{"items":{"type":"string"},"type":"array"},"source":{"type":"object"},"source_id":{"nullable":true,"type":"integer"},"system":{"anyOf":[{"$ref":"#/components/schemas/System"},{"additionalProperties":true,"type":"object"}],"nullable":true},"system_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["id"],"title":"Target","type":"object"},"TdDdUnauthorizedResponse":{"anyOf":[{"$ref":"#/components/schemas/TdDdUnauthorizedMessageResponse"},{"$ref":"#/components/schemas/TdDdUnauthorizedErrorResponse"}],"description":"Unauthorized response from auth plug or error view","title":"TdDdUnauthorizedResponse"},"TdDdUnauthorizedMessageResponse":{"additionalProperties":false,"properties":{"message":{"type":"string"}},"required":["message"],"title":"TdDdUnauthorizedMessageResponse","type":"object"},"TdDdUnauthorizedErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdUnauthorizedErrorResponse","type":"object"},"TdDdForbiddenResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdForbiddenResponse","type":"object"},"TdDdNotFoundErrorResponse":{"additionalProperties":false,"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdNotFoundErrorResponse","type":"object"},"TdDdInternalServerErrorResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdInternalServerErrorResponse","type":"object"}}}}
```

## Delete data structure link

> Deletes the data structure link identified by source and target IDs.

```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.8.2"},"paths":{"/api/data_structures/structure_links/source/{source_id}/target/{target_id}":{"delete":{"description":"Deletes the data structure link identified by source and target IDs.","operationId":"TdDdWeb.DataStructureLinkController.delete","parameters":[{"description":"Source data structure ID","in":"path","name":"source_id","required":true,"schema":{"type":"integer"}},{"description":"Target data structure ID","in":"path","name":"target_id","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Data structure link deleted"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdNotFoundErrorResponse"}}},"description":"Not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnprocessableEntityObjectResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Delete data structure link","tags":["Data Structure Links"]}}},"components":{"schemas":{"TdDdUnauthorizedResponse":{"anyOf":[{"$ref":"#/components/schemas/TdDdUnauthorizedMessageResponse"},{"$ref":"#/components/schemas/TdDdUnauthorizedErrorResponse"}],"description":"Unauthorized response from auth plug or error view","title":"TdDdUnauthorizedResponse"},"TdDdUnauthorizedMessageResponse":{"additionalProperties":false,"properties":{"message":{"type":"string"}},"required":["message"],"title":"TdDdUnauthorizedMessageResponse","type":"object"},"TdDdUnauthorizedErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdUnauthorizedErrorResponse","type":"object"},"TdDdForbiddenResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdForbiddenResponse","type":"object"},"TdDdNotFoundErrorResponse":{"additionalProperties":false,"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdNotFoundErrorResponse","type":"object"},"TdDdUnprocessableEntityObjectResponse":{"additionalProperties":false,"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdUnprocessableEntityObjectResponse","type":"object"},"TdDdInternalServerErrorResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdInternalServerErrorResponse","type":"object"}}}}
```

## Search data structure links

> Searches data structure links using the provided filters.

```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.8.2"},"paths":{"/api/data_structure_links/search":{"post":{"description":"Searches data structure links using the provided filters.","operationId":"TdDdWeb.DataStructureLinkController.search","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataStructureLinkSearchRequest"}}},"description":"Data structure link search filters","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataStructureLinkSearchResponse"}}},"description":"Data structure links search"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnauthorizedResponse"}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnprocessableEntityStringResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Search data structure links","tags":["Data Structure Links"]}}},"components":{"schemas":{"DataStructureLinkSearchRequest":{"additionalProperties":false,"properties":{"page":{"default":0,"type":"integer"},"scroll_id":{"nullable":true,"type":"string"},"since":{"nullable":true,"type":"string"},"size":{"default":50,"type":"integer"}},"title":"DataStructureLinkSearchRequest","type":"object"},"DataStructureLinkSearchResponse":{"additionalProperties":false,"properties":{"data_structure_links":{"items":{"$ref":"#/components/schemas/DataStructureLinkSearchResponseObject"},"type":"array"},"scroll_id":{"nullable":true,"type":"string"}},"required":["data_structure_links"],"title":"DataStructureLinkSearchResponse","type":"object"},"DataStructureLinkSearchResponseObject":{"additionalProperties":false,"properties":{"id":{"type":"integer"},"inserted_at":{"type":"string"},"labels":{"items":{"$ref":"#/components/schemas/Label"},"type":"array"},"source_id":{"type":"integer"},"target_id":{"type":"integer"},"updated_at":{"type":"string"}},"required":["id","source_id","target_id","labels","inserted_at","updated_at"],"title":"DataStructureLinkSearchResponseObject","type":"object"},"Label":{"additionalProperties":false,"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"required":["id","name"],"title":"Label","type":"object"},"TdDdUnauthorizedResponse":{"anyOf":[{"$ref":"#/components/schemas/TdDdUnauthorizedMessageResponse"},{"$ref":"#/components/schemas/TdDdUnauthorizedErrorResponse"}],"description":"Unauthorized response from auth plug or error view","title":"TdDdUnauthorizedResponse"},"TdDdUnauthorizedMessageResponse":{"additionalProperties":false,"properties":{"message":{"type":"string"}},"required":["message"],"title":"TdDdUnauthorizedMessageResponse","type":"object"},"TdDdUnauthorizedErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdUnauthorizedErrorResponse","type":"object"},"TdDdUnprocessableEntityStringResponse":{"additionalProperties":false,"properties":{"error":{"type":"string"},"message":{"type":"string"}},"title":"TdDdUnprocessableEntityStringResponse","type":"object"},"TdDdInternalServerErrorResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdInternalServerErrorResponse","type":"object"}}}}
```