---
title: "POST /acp/document/relationship"
method: POST
path: "/acp/document/relationship"
tags: ["document access control"]
---

# POST /acp/document/relationship

`POST /acp/document/relationship`

Add an actor relationship using document acp system

## Request body

- AddAcpDocumentRelationshipRequest
  - `CollectionName` string
  - `DocID` string
  - `Relation` string
  - `TargetActor` string

## Response `200`

Add document acp relationship result

- AddAcpRelationshipResult
  - `ExistedAlready` boolean

## Other responses

- `400` — error

## Changes

> 53 revisions in range; 1 could not be searched.

- **2026-06-29** `9edabd286fba` — 3 info
  - api operation id `add dac relationship` removed and replaced with `dac relationship add`
  - api tag `document access control` added
  - api tag `acp_document_relationship` removed
- **2025-08-01** `da6a787a0bda` — 1 info
  - endpoint added
- **2025-06-02** `60812f5416c5` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/sourcenetwork/apis/defradb-api/changes/acp/document/relationship/post.md)

---

[API](https://skmtc.dev/sourcenetwork/apis/defradb-api.md) · [All operations](https://skmtc.dev/sourcenetwork/apis/defradb-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sourcenetwork/defradb-api/revisions/659e79583f79/schema)