> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talaria.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Set recipient delivery policy

> Set recipient delivery policy for a public Talaria DID.

Set recipient delivery policy for a public Talaria DID.

## Path parameters

<ParamField path="did" type="string" required>
  The recipient DID.
</ParamField>

## Request body

<ParamField body="did" type="string" required>
  The target DID. It must match the path.
</ParamField>

<ParamField body="policy" type="object" required>
  The public delivery policy.
</ParamField>

<ParamField body="policy.release_pricing" type="object">
  Public release pricing with `asset` and `amount` strings.
</ParamField>

<ParamField body="policy.expiration_behavior" type="object">
  Public expiration behavior with `mode` and optional `retain_until`.
</ParamField>

<ParamField body="policy.allowed_relays" type="string[]">
  Public identifiers for allowed relays.
</ParamField>

<RequestExample>
  ```bash Request theme={null}
  curl --request PUT \
    --url "https://directory.example.com/delivery-policies/recipients/did%3Atalaria%3A1111111111111111111111" \
    --header "Content-Type: application/json" \
    --data '{
    "did": "did:talaria:1111111111111111111111",
    "policy": {
      "release_pricing": {
        "asset": "TAL",
        "amount": "100"
      },
      "expiration_behavior": {
        "mode": "retain",
        "retain_until": "1784236800000"
      },
      "allowed_relays": [
        "did:talaria:relay-example"
      ]
    }
  }'
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 202 Response theme={null}
  {
    "status": "accepted",
    "did": "did:talaria:1111111111111111111111",
    "extrinsic": "set_delivery_policy",
    "tx_hash": "<transaction-hash>",
    "message": "Chain extrinsic submitted"
  }
  ```
</ResponseExample>

<Note>
  `202 Accepted` means the Directory accepted the request for processing. It does not confirm final settlement.
</Note>