> 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.12/api-integrations/data-catalog-data-lineage-and-grants-apis/units.md).
# Units
## Get unit
> Retrieves a single active unit by its name.\
> \
> Requires administrative privileges (\*\*administrator or service account\*\*).\
> \
> Only units with an active status are returned. Inactive or non‑existent units produce \`404 Not Found\`.
```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.12.2"},"paths":{"/api/units/{name}":{"get":{"description":"Retrieves a single active unit by its name.\n\nRequires administrative privileges (**administrator or service account**).\n\nOnly units with an active status are returned. Inactive or non‑existent units produce `404 Not Found`.\n","operationId":"TdDdWeb.UnitController.show","parameters":[{"description":"Unit name","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnitShowResponse"}}},"description":"Unit retrieved"},"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":"Get unit","tags":["Units"]}}},"components":{"schemas":{"UnitShowResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/UnitResponse"}},"required":["data"],"title":"UnitShowResponse","type":"object"},"UnitResponse":{"additionalProperties":false,"properties":{"events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"id":{"description":"Unit ID (may be absent in some responses)","nullable":true,"type":"integer"},"inserted_at":{"format":"date-time","nullable":true,"type":"string"},"name":{"type":"string"},"status":{"$ref":"#/components/schemas/UnitStatus"},"updated_at":{"format":"date-time","nullable":true,"type":"string"}},"required":["name"],"title":"UnitResponse","type":"object"},"UnitStatus":{"additionalProperties":false,"properties":{"event":{"description":"Last event type","type":"string"},"info":{"additionalProperties":true,"description":"Status metadata","nullable":true,"type":"object"},"timestamp":{"description":"Timestamp of the status event","format":"date-time","nullable":true,"type":"string"}},"required":["event"],"title":"UnitStatus","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"}}}}
```
## Update unit
> Replaces a unit's graph data by uploading new node and relationship files.\
> \
> Requires administrative privileges (\*\*administrator or service account\*\*).\
> \
> \*\*Request body (multipart/form-data):\*\*\
> \- \`nodes\` (required, file) – File containing node data.\
> \- \`rels\` (required, file) – File containing relationship data.\
> \
> The files are queued for asynchronous import. The endpoint returns \`202 Accepted\` immediately.\
> \
> The import is processed in the background; the unit's graph is replaced once the import completes.
```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.12.2"},"paths":{"/api/units/{name}":{"put":{"description":"Replaces a unit's graph data by uploading new node and relationship files.\n\nRequires administrative privileges (**administrator or service account**).\n\n**Request body (multipart/form-data):**\n- `nodes` (required, file) – File containing node data.\n- `rels` (required, file) – File containing relationship data.\n\nThe files are queued for asynchronous import. The endpoint returns `202 Accepted` immediately.\n\nThe import is processed in the background; the unit's graph is replaced once the import completes.\n","operationId":"TdDdWeb.UnitController.update","parameters":[{"description":"Unit name","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/UnitUpdateRequest"}}},"description":"Unit update payload","required":false},"responses":{"202":{"description":"Unit update accepted"},"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":"Update unit","tags":["Units"]}}},"components":{"schemas":{"UnitUpdateRequest":{"properties":{"nodes":{"description":"File upload for nodes data","format":"binary","type":"string"},"rels":{"description":"File upload for relationships data","format":"binary","type":"string"}},"required":["nodes","rels"],"title":"UnitUpdateRequest","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"}}}}
```
## Delete unit
> Deletes a unit and its associated graph data. By default, the deletion is \*\*logical\*\* (soft delete): the unit is marked with a \`deleted\_at\` timestamp and a \`Deleted\` event is recorded, but the record remains in the database.\
> \
> \*\*Only administrators\*\* can delete units.\
> \
> The deletion is processed asynchronously. The endpoint returns \`202 Accepted\` immediately.\
> \
> To perform a \*\*hard delete\*\* (physical removal from the database), pass \`logical=false\`. \*\*Hard deletes are irreversible\*\* and remove the unit along with its node associations and orphaned nodes
```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.12.2"},"paths":{"/api/units/{name}":{"delete":{"description":"Deletes a unit and its associated graph data. By default, the deletion is **logical** (soft delete): the unit is marked with a `deleted_at` timestamp and a `Deleted` event is recorded, but the record remains in the database.\n\n**Only administrators** can delete units.\n\nThe deletion is processed asynchronously. The endpoint returns `202 Accepted` immediately.\n\nTo perform a **hard delete** (physical removal from the database), pass `logical=false`. **Hard deletes are irreversible** and remove the unit along with its node associations and orphaned nodes\n","operationId":"TdDdWeb.UnitController.delete","parameters":[{"description":"Unit name","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Set to 'false' to perform a hard delete instead of the default soft delete. Hard deletes are irreversible and remove the unit along with its node associations and orphaned nodes","in":"query","name":"logical","required":false,"schema":{"default":"true","enum":["true","false"],"type":"string"}}],"responses":{"202":{"description":"Unit deletion accepted"},"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 unit","tags":["Units"]}}},"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"}}}}
```
## Update unit
> Replaces a unit's graph data by uploading new node and relationship files.\
> \
> Requires administrative privileges (\*\*administrator or service account\*\*).\
> \
> \*\*Request body (multipart/form-data):\*\*\
> \- \`nodes\` (required, file) – File containing node data.\
> \- \`rels\` (required, file) – File containing relationship data.\
> \
> The files are queued for asynchronous import. The endpoint returns \`202 Accepted\` immediately.\
> \
> The import is processed in the background; the unit's graph is replaced once the import completes.
```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.12.2"},"paths":{"/api/units/{name}":{"patch":{"description":"Replaces a unit's graph data by uploading new node and relationship files.\n\nRequires administrative privileges (**administrator or service account**).\n\n**Request body (multipart/form-data):**\n- `nodes` (required, file) – File containing node data.\n- `rels` (required, file) – File containing relationship data.\n\nThe files are queued for asynchronous import. The endpoint returns `202 Accepted` immediately.\n\nThe import is processed in the background; the unit's graph is replaced once the import completes.\n","operationId":"TdDdWeb.UnitController.update (2)","parameters":[{"description":"Unit name","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/UnitUpdateRequest"}}},"description":"Unit update payload","required":false},"responses":{"202":{"description":"Unit update accepted"},"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":"Update unit","tags":["Units"]}}},"components":{"schemas":{"UnitUpdateRequest":{"properties":{"nodes":{"description":"File upload for nodes data","format":"binary","type":"string"},"rels":{"description":"File upload for relationships data","format":"binary","type":"string"}},"required":["nodes","rels"],"title":"UnitUpdateRequest","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 units
> Returns a list of all active lineage units. Units are not filtered by domain or user context; the list is global. Only units with an active status are returned\
> \
> Only administratos can list units.\
> \
> No pagination is applied.
```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.12.2"},"paths":{"/api/units":{"get":{"description":"Returns a list of all active lineage units. Units are not filtered by domain or user context; the list is global. Only units with an active status are returned\n\nOnly administratos can list units.\n\nNo pagination is applied.\n","operationId":"TdDdWeb.UnitController.index","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnitsIndexResponse"}}},"description":"Units retrieved"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List units","tags":["Units"]}}},"components":{"schemas":{"UnitsIndexResponse":{"additionalProperties":false,"properties":{"data":{"description":"List of units","items":{"$ref":"#/components/schemas/UnitResponse"},"type":"array"}},"required":["data"],"title":"UnitsIndexResponse","type":"object"},"UnitResponse":{"additionalProperties":false,"properties":{"events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"id":{"description":"Unit ID (may be absent in some responses)","nullable":true,"type":"integer"},"inserted_at":{"format":"date-time","nullable":true,"type":"string"},"name":{"type":"string"},"status":{"$ref":"#/components/schemas/UnitStatus"},"updated_at":{"format":"date-time","nullable":true,"type":"string"}},"required":["name"],"title":"UnitResponse","type":"object"},"UnitStatus":{"additionalProperties":false,"properties":{"event":{"description":"Last event type","type":"string"},"info":{"additionalProperties":true,"description":"Status metadata","nullable":true,"type":"object"},"timestamp":{"description":"Timestamp of the status event","format":"date-time","nullable":true,"type":"string"}},"required":["event"],"title":"UnitStatus","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"},"TdDdInternalServerErrorResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdInternalServerErrorResponse","type":"object"}}}}
```
## Create unit
> Creates a new lineage unit.\
> \
> Requires administrative privileges (\*\*administrator or service account\*\*).\
> \
> \*\*Request body:\*\*\
> \- \`name\` (required, string) – Unit name. Must be unique.\
> \- \`status\` (optional, boolean) – Initial status. Default: \`true\`.
```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.12.2"},"paths":{"/api/units":{"post":{"description":"Creates a new lineage unit.\n\nRequires administrative privileges (**administrator or service account**).\n\n**Request body:**\n- `name` (required, string) – Unit name. Must be unique.\n- `status` (optional, boolean) – Initial status. Default: `true`.\n","operationId":"TdDdWeb.UnitController.create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnitCreateRequest"}}},"description":"Unit create payload","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnitShowResponse"}}},"description":"Unit 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 unit","tags":["Units"]}}},"components":{"schemas":{"UnitCreateRequest":{"additionalProperties":false,"properties":{"name":{"description":"Unit name","type":"string"},"status":{"description":"Unit status","nullable":true,"type":"boolean"}},"required":["name"],"title":"UnitCreateRequest","type":"object"},"UnitShowResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/UnitResponse"}},"required":["data"],"title":"UnitShowResponse","type":"object"},"UnitResponse":{"additionalProperties":false,"properties":{"events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"id":{"description":"Unit ID (may be absent in some responses)","nullable":true,"type":"integer"},"inserted_at":{"format":"date-time","nullable":true,"type":"string"},"name":{"type":"string"},"status":{"$ref":"#/components/schemas/UnitStatus"},"updated_at":{"format":"date-time","nullable":true,"type":"string"}},"required":["name"],"title":"UnitResponse","type":"object"},"UnitStatus":{"additionalProperties":false,"properties":{"event":{"description":"Last event type","type":"string"},"info":{"additionalProperties":true,"description":"Status metadata","nullable":true,"type":"object"},"timestamp":{"description":"Timestamp of the status event","format":"date-time","nullable":true,"type":"string"}},"required":["event"],"title":"UnitStatus","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 unit events
> Returns a list of events associated with a specific unit. Events include operations like \`LoadStarted\`, \`LoadFailed\`, \`LoadSucceeded\`, and \`Deleted\`.\
> \
> Only administratos can list unit events.\
> \
> Events are returned in full. No pagination is applied.
```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.12.2"},"paths":{"/api/units/{unit_name}/events":{"get":{"description":"Returns a list of events associated with a specific unit. Events include operations like `LoadStarted`, `LoadFailed`, `LoadSucceeded`, and `Deleted`.\n\nOnly administratos can list unit events.\n\nEvents are returned in full. No pagination is applied.\n","operationId":"TdDdWeb.UnitEventController.index","parameters":[{"description":"Unit name","in":"path","name":"unit_name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnitEventsIndexResponse"}}},"description":"Unit events retrieved"},"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":"List unit events","tags":["Units"]}}},"components":{"schemas":{"UnitEventsIndexResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/UnitEventResponse"},"type":"array"}},"title":"UnitEventsIndexResponse","type":"object"},"UnitEventResponse":{"properties":{"data":{"additionalProperties":true,"nullable":true,"type":"object"},"id":{"type":"integer"},"inserted_at":{"format":"date-time","type":"string"},"status":{"type":"string"},"type":{"type":"string"},"unit_id":{"type":"integer"},"updated_at":{"format":"date-time","type":"string"}},"title":"UnitEventResponse","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"}}}}
```