Modify Secure Container

Example Overview

This example showcases the ability to:

  • Modify DRM settings for containers using dynamic DRM.

Endpoint:
PATCH /containers/{container_id}/drm

Headers:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Body Example:

{
  "downloadable": false,
  "opens": 5,
  "time": {
    "start": "2025-05-07T00:00:00Z",
    "end": "2025-06-30T23:59:59Z"
  },
  "geo": {
    "allow": [
      { "country": "DE" },
      { "country": "FR" }
    ],
    "block": [
      { "country": "CN" }
    ]
  },
  "ip": {
    "allow": ["203.0.113.42"],
    "block": ["192.0.2.12"]
  },
  "recipients": [
    "newuser@example.com",
    "external.collaborator@partner.org"
  ]
}

Behavior & Tips:

  • Only containers with "dynamic": true in their original manifest can be modified this way.

  • Fields omitted from the PATCH body remain unchanged.

  • You can use this to:

    • Extend time windows,

    • Change allowed regions or IPs,

    • Add/remove recipients,

    • Restrict or permit downloads,

    • Increase allowed openings.