# Create Relation Assignments

Create relation assignments (instance-level relationships). E.g., "User A is a reader of Document 1".

Endpoint: POST /resources/relations/v1/assign
Version: 1.0
Security: bearer

## Request fields (application/json):

  - `assignments` (array, required)

  - `assignments.subjectEntityTypeKey` (string, required)
    Example: "user"

  - `assignments.subjectKey` (string, required)
    Example: "anthony@email-of.his"

  - `assignments.relationKey` (string, required)
    Example: "reader"

  - `assignments.targetEntityTypeKey` (string, required)
    Example: "document"

  - `assignments.targetKey` (string, required)
    Example: "document-1.doc"

  - `assignments.activeFrom` (string)
    Example: "2024-01-01T00:00:00Z"

  - `assignments.activeUntil` (string)
    Example: "2024-12-31T23:59:59Z"

## Response 201 fields (application/json):

  - `subjectEntityTypeKey` (string, required)
    Example: "user"

  - `subjectKey` (string, required)
    Example: "anthony@email-of.his"

  - `relationKey` (string, required)
    Example: "reader"

  - `targetEntityTypeKey` (string, required)
    Example: "document"

  - `targetKey` (string, required)
    Example: "document-1.doc"

  - `activeFrom` (string)
    Example: "2024-01-01T00:00:00Z"

  - `activeUntil` (string)
    Example: "2024-12-31T23:59:59Z"