Policies

Update a policy

Updates the specified policy. All fields are optional — only provided fields are updated. The same plan-limit, spam sensitivity, and retention-period validation applies as on create.

put/v3/policies/{policy_id}

Request body

namestring
rulesstring[]

Example request

{
  "name": "Updated policy name",
  "rules": [
    "c1d2e3f4-5678-4abc-9def-0123456789ab"
  ]
}

Response

OK

request_idstring

ID of the request.

Example response

{
  "request_id": "5fa64c92-e840-4357-86b9-2aa364d35b88",
  "data": {
    "id": "b1c2d3e4-5678-4abc-9def-0123456789ab",
    "name": "Standard Agent Account Policy",
    "application_id": "ad410018-d306-43f9-8361-fa5d7b2172e0",
    "organization_id": "org-abc123",
    "limits": {
      "limit_attachment_size_limit": 26214400,
      "limit_attachment_count_limit": 20,
      "limit_attachment_allowed_types": [
        "image/png",
        "image/jpeg",
        "application/pdf"
      ],
      "limit_size_total_mime": 31457280,
      "limit_storage_total": 10737418240,
      "limit_count_daily_message_received": 1000,
      "limit_count_daily_email_sent": 1000,
      "limit_inbox_retention_period": 365,
      "limit_spam_retention_period": 30
    },
    "rules": [
      "c1d2e3f4-5678-4abc-9def-0123456789ab"
    ],
    "spam_detection": {
      "use_list_dnsbl": true,
      "use_header_anomaly_detection": true,
      "spam_sensitivity": 1.5
    },
    "created_at": 1742932766,
    "updated_at": 1742932766
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.