Home / SecureDocs
DRM & document encryption API for developers

Embed Document & Video DRM with an API

689Cloud SecureDocs is a developer-first DRM and document encryption API for embedding enterprise content protection directly into your own applications, portals, and workflows โ€” no need to build Information Rights Management from scratch.

Call a REST endpoint to encrypt a PDF, Office document, or video, stream video securely with DRM over secure HLS, set access policies, track every open, and revoke access remotely โ€” all from inside your product.

Powering secure document workflows for SaaS platforms, fintech, healthcare, and enterprise IT teams that handle confidential files at scale.

What you get with the SecureDocs API

{ }
Simple REST APIClean JSON endpoints, any language
Ready
๐Ÿ›ก
IRM as a serviceFile-level protection via one call
Protected
๐Ÿ”‘
API Key + App ID authSimple, secure request headers
Secured
๐Ÿ“„
Office, PDF & MP4Word, Excel, PowerPoint, PDF, video
Supported
DRM APIdocument encryption APIvideo DRM ยท secure HLSPDF ยท Office ยท MP4
Content security features

Encryption, Controlled Distribution, and License Management

Before the code, here is what SecureDocs protects and controls. Every capability is exposed through the same REST API โ€” so you can encrypt any supported format, decide exactly how it is distributed and viewed, and keep full tracking and license control after delivery.

๐Ÿ“„

Supported data formats

Encrypt and DRM-protect the file types your business runs on, with format-aware protection.

  • โœ“Microsoft Word, Excel, and PowerPoint
  • โœ“PDF documents (PDF encryption)
  • โœ“MP4 video (video encryption)
  • โœ“Document and video encryption with key management handled for you
๐Ÿ–ฅ๏ธ

Distribution & viewing options

Control exactly how recipients receive and view protected content across documents and video.

  • โœ“Embedded secure online viewer (view-only in the browser)
  • โœ“Allow or block downloads per document
  • โœ“Video DRM streaming over secure HLS
  • โœ“Dynamic watermarks, plus copy, print, and screen-capture controls
๐Ÿ“Š

Tracking & license management

Know who accessed what, and keep control of every license after content is distributed.

  • โœ“Track views, downloads, and local file openings
  • โœ“Per-recipient access licenses and permission levels
  • โœ“Time-limited access with expiry dates
  • โœ“Remote revocation at any time, even after download
SecureDocs

Document Protection, Delivered as an API

SecureMail and SecureDrive put 689Cloud's Information Rights Management in the hands of end users. SecureDocs puts the same engine in the hands of developers โ€” so you can build secure document handling into any application, portal, or automated workflow.

Instead of stitching together encryption, key management, viewers, tracking, and revocation yourself, you call a well-documented REST API. Protection travels with each file, and you stay in control of every policy from your own backend.

689Cloud SecureDocs document security API illustration

Why teams build on the SecureDocs API

  • โœ“Add enterprise document security without building IRM in-house
  • โœ“File-level protection that travels with every document
  • โœ“Automate protect, share, track, and revoke from your backend
  • โœ“Protect Office documents, PDFs, and MP4 video
  • โœ“Embed a secure browser viewer directly in your product
  • โœ“Faster time to market with clear, ready-to-use REST docs
Developer experience

Protect a Document in One API Call

Upload a file, apply an IRM policy, and get back a protected document and a secure viewer link. The SecureDocs API handles encryption, key management, and the viewer so you can focus on your product.

  • โœ“Simple JSON responses, with errors returned in an error key
  • โœ“Predictable, standard HTTP status codes
  • โœ“Per-file policies: view-only, download, print, expiry, watermark
  • โœ“Recipient authentication and identity binding
  • โœ“Protect Word, Excel, PowerPoint, PDF, and MP4 video
protect-document.sh
# Authenticate with your API Key and App ID headerscurl -X POST https://api.689cloud.com/documents \
 -H "X-Api-Key: $SECUREDOC_API_KEY" \
 -H "X-App-Id: $SECUREDOC_APP_ID" \
 -F "file=@contract.pdf" \
 -F 'policy={
    "view_only": true,
    "watermark": "{{recipient_email}}",
    "expires_in": "72h",
    "allow_download": false
  }'

# JSON response{
 "document_id": "doc_9f2a7c41",
 "status": "protected",
 "viewer_url": "https://view.689cloud.com/doc_9f2a7c41",
 "expires_at": "2026-08-10T09:00:00Z"
}
grant-access.js
// Call the REST API directly from any language (JS Fetch shown)await fetch('https://api.689cloud.com/documents/doc_9f2a7c41/access', {
 method: 'POST',
 headers: {
 'X-Api-Key': process.env.SECUREDOC_API_KEY,
 'X-App-Id': process.env.SECUREDOC_APP_ID,
 'Content-Type': 'application/json'
 },
 body: JSON.stringify({
 email: 'partner@example.com',
 permissions: ['view']
 })
});

// A 401 is returned if the API Key or App ID is invalid
Authentication & integration

Call the API from Any Language

SecureDocs is a language-agnostic REST API. Authenticate every request with your API Key and App ID, then automate the full document lifecycle from your own backend. Ready-to-copy code samples are provided across many languages in the API documentation.

  • โœ“Authenticate with X-Api-Key and X-App-Id request headers
  • โœ“Get your API Key and App ID from the SecureDoc Console
  • โœ“Code samples for cURL, Node.js, Python, PHP, Java, Go, C#, and more
  • โœ“JSON responses with standard HTTP status codes
  • โœ“Embed the secure viewer directly in your product

API Capabilities

Every SecureDocs endpoint applies file-level protection โ€” not just access links. Compose them to build exactly the secure document workflow your application needs.

๐Ÿ›ก

Encrypt Documents

Encrypt and apply IRM policies to Office and PDF files with a single POST request.

๐Ÿ”‘

Manage Access

Grant, update, or revoke recipient access programmatically, bound to verified identities.

๐Ÿ“ˆ

Track Activity

Query views, downloads, and local file openings for full audit visibility.

โ›”

Remote Revocation

Call the revoke endpoint to cut access instantly โ€” even for downloaded files.

๐Ÿ‘

Embed Viewer

Drop a secure, view-only viewer into your app with a generated viewer URL.

โฑ

Expiry Policies

Set time-based expiry per document so access ends automatically after a window.

๐Ÿ’ง

Dynamic Watermarks

Apply viewer-identity watermarks server-side to discourage leaks and captures.

๐ŸŽฌ

Video DRM

Encrypt MP4 video and stream it securely with DRM over secure HLS.

API reference

API Groups

The SecureDoc API is organized into logical groups. Explore the full request and response reference, with live code samples, in the API documentation.

๐Ÿ›ก

Documents

Upload files and apply IRM protection, then retrieve document status and metadata.

๐Ÿ”‘

Access

Grant, update, and revoke recipient access to protected documents by identity.

๐Ÿ“ˆ

Tracking

Retrieve access activity โ€” views, downloads, and local openings โ€” for audit visibility.

โš™๏ธ

Settings

Manage policies and account settings, and get your API Key and App ID from the Console.

Why IRM matters

File-level Rights Management โ€” Built into Your Application

Access links and folder permissions stop protecting a file the moment it is downloaded. SecureDocs applies Information Rights Management to the document itself through the API โ€” so access, copy and print controls, watermarks, and expiry stay enforced wherever the file travels.

Travel-with-file

Protection is embedded in the document, not just the delivery mechanism.

Programmatic policy

Set view-only, download, print, expiry, and watermark rules per API call.

Identity-bound

Recipient authentication ensures only intended viewers open the file.

Revoke via API

Cut access at any time from your backend, even after download.

How it works

From API Call to Controlled Document in Minutes

Integrate the SecureDocs API once, and every document your application handles is protected by default.

1

Get API access

Get your API Key and App ID from the SecureDoc Console to start making requests.

2

Call the REST API

Send authenticated requests with the X-Api-Key and X-App-Id headers from any language.

3

Protect documents

POST a file with a policy. SecureDocs encrypts it and applies IRM automatically.

4

Grant access

Authorize recipients by identity and set view, download, print, and expiry permissions.

5

Embed the viewer

Use the generated viewer URL to render protected files securely inside your app.

6

Track and revoke

Query access activity for audit trails, and revoke access programmatically anytime.

Build vs Integrate the SecureDocs API

See what it takes to build document security in-house versus embedding the SecureDocs API.

CapabilityBuild In-House689Cloud SecureDocs API
File encryption & key managementDesign and maintain yourselfBuilt in
File-level IRM protectionComplex, specialized effortOne API call
Secure document viewerBuild and hostEmbeddable viewer URL
Access tracking & audit trailCustom logging pipelineBuilt-in API
Remote revocation after downloadVery difficultYes, via API
Dynamic watermarksCustom renderingServer-side, per policy
Expiry policiesCustom schedulingPer-document setting
Protect Office, PDF & MP4 videoFormat-by-format effortBuilt in
REST API & multi-language code samplesN/AYes
Time to productionMonthsDays
On-premise / private cloud optionFull ownership burdenAvailable
Use cases

Where Teams Put the SecureDocs API to Work

The same API powers very different products. Here are three of the most common ways teams integrate SecureDocs โ€” each combining encryption, controlled viewing, and license management in a different way.

๐Ÿค

Virtual Data Room

Power M&A, due diligence, and investor deal rooms inside your own platform. Every document is encrypted, watermarked, and fully audited, so you can grant, track, and revoke access as a deal moves forward.

  • โœ“Encrypt Office and PDF deal documents on upload
  • โœ“Dynamic watermarks and view-only access per party
  • โœ“Full activity tracking and remote revocation at close
๐ŸŽ“

LMS & E-Learning Integration

Protect premium course content in your learning platform. Stream training videos with DRM over secure HLS and lock down PDFs and slide decks, so paid material cannot be downloaded or redistributed.

  • โœ“Video DRM streaming over secure HLS for lessons
  • โœ“View-only PDFs, slides, and workbooks in the browser
  • โœ“Per-learner licenses with expiry and access tracking
๐Ÿฅ

Healthcare Document Sharing

Share patient records, reports, and referrals from your healthcare system with strict, identity-bound access. Recipients authenticate before viewing, and every open is logged for compliance.

  • โœ“Encrypt medical documents and PDFs end to end
  • โœ“Recipient-authenticated, view-only access
  • โœ“Audit trail and revocation for compliance needs

More Teams Building on SecureDocs

Beyond these flagship scenarios, SecureDocs powers secure content handling across regulated and enterprise environments.

SaaS & Platforms

Add IRM-protected document sharing, viewing, and tracking as a native feature of your product.

Fintech & Banking

Deliver statements, reports, and applications with programmatic access control and audit trails.

Legal & Professional Services

Automate protected delivery of contracts, case files, and confidential work product.

Media & Publishing

Protect e-books, research, and premium video with encryption and video DRM against redistribution.

Manufacturing & Engineering

Guard specifications, drawings, and IP shared with suppliers and partners through your systems.

Enterprise IT & Workflows

Embed document protection into internal portals, RPA, and back-office automation.

Deployment

Flexible Delivery Options

Consume the SecureDocs API in the environment your organization requires โ€” from managed cloud to fully on-premise.

Cloud API

Call the 689Cloud-hosted API and start protecting documents in minutes with minimal setup.

Private Cloud

Run the SecureDocs API in a dedicated environment for greater control and data isolation.

On-Premise

Deploy the API on your own infrastructure to meet regulatory or data residency requirements.

Custom Integration

Work with our team on tailored connectors and integration support for your stack.

SecureDocs API Frequently Asked Questions

What is SecureDocs?

689Cloud SecureDocs is a document security API that lets developers embed enterprise Information Rights Management into their own applications. With a simple REST API, you can protect files, control access, track usage, and revoke access programmatically โ€” without building IRM yourself.

How is SecureDocs different from SecureMail and SecureDrive?

SecureMail and SecureDrive are end-user products for sending and sharing protected files. SecureDocs exposes the same underlying protection engine as an API, so you can integrate document security directly into your own product, portal, or automated workflow.

What can I do with the API?

You can upload and protect documents, apply per-file policies (view-only, download, print, expiry, watermark), grant and revoke recipient access, embed a secure viewer, and retrieve access and tracking activity for audit trails.

Which languages can I use?

SecureDoc is a language-agnostic REST API you can call from any stack. The API documentation includes ready-to-copy code samples for cURL, Node.js, Python, PHP, Java, Go, C#, Ruby, Swift, and more.

How does authentication work?

The SecureDoc API authenticates with an API Key and App ID. Include them in every request using the X-Api-Key and X-App-Id headers. You can get your API Key and App ID from the SecureDoc Console. A missing or invalid credential returns an HTTP 401 Unauthorized response.

Can I revoke access to a document after it has been downloaded?

Yes. For IRM-protected files, you can call the revoke endpoint at any time to cut access โ€” including for documents already downloaded by recipients.

Which file types does the API support?

The SecureDoc API secures Microsoft Word, Microsoft Excel, Microsoft PowerPoint, PDF, and MP4 video files.

Does the API support video DRM?

Yes. The SecureDoc API provides video DRM for MP4 files โ€” encrypting the video and delivering it through a secure HLS stream so it can be viewed in a protected player without exposing a downloadable source file.

Is this a document and PDF encryption API?

Yes. SecureDocs encrypts PDF and Microsoft Office documents (Word, Excel, PowerPoint) and manages the encryption keys for you, so you can add strong document and PDF encryption without building a crypto stack yourself.

Can SecureDocs be deployed on-premise?

Yes. The SecureDocs API is available as a managed cloud service, in a private cloud, or fully on-premise to meet security, regulatory, and data residency requirements.

Start Building with the SecureDocs API

Embed IRM protection, access control, tracking, and remote revocation into your application โ€” without building document security from scratch. Get API keys and sandbox access to start today.