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

# Access

## Bulk load accesses

> Bulk loads access records from the provided payload, returning the number of inserted records, any invalid changesets, and any inexistent external IDs.

```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.8.2"},"paths":{"/api/accesses/bulk_load":{"post":{"description":"Bulk loads access records from the provided payload, returning the number of inserted records, any invalid changesets, and any inexistent external IDs.","operationId":"TdDdWeb.AccessController.create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessBulkLoadRequest"}}},"description":"Access bulk load payload","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessBulkLoadResponse"}}},"description":"Accesses bulk loaded"},"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":"Bulk load accesses","tags":["Access"]}}},"components":{"schemas":{"AccessBulkLoadRequest":{"additionalProperties":false,"properties":{"accesses":{"items":{"additionalProperties":false,"properties":{"principal_id":{"type":"string"},"principal_type":{"enum":["user","group"],"type":"string"},"resource_external_id":{"type":"string"}},"required":["resource_external_id","principal_type","principal_id"],"type":"object"},"type":"array"}},"required":["accesses"],"title":"AccessBulkLoadRequest","type":"object"},"AccessBulkLoadResponse":{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"inexistent_external_ids":{"items":{"type":"string"},"type":"array"},"inserted_count":{"type":"integer"},"invalid_changesets":{"items":{"additionalProperties":false,"properties":{"data":{"additionalProperties":true,"type":"object"},"error":{"type":"string"}},"required":["error","data"],"type":"object"},"type":"array"}},"required":["inserted_count","invalid_changesets","inexistent_external_ids"],"type":"object"}},"required":["data"],"title":"AccessBulkLoadResponse","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"}}}}
```