Supergood | DocuWare API
Programmatically access documents, file cabinets, index fields, workflows, and audit logs from DocuWare with a stable REST API. Supergood builds and operates production-grade, unofficial DocuWare integrations so your team can automate legal document workflows and iManage handoffs without heavy custom engineering.
Plain English: DocuWare is document management and workflow software used by law firms and corporate legal teams to capture, store, search, and route documents. It keeps filings, contracts, emails, and scans organized in secure “file cabinets,” applies metadata (index fields), automates approvals, and enforces retention and audit rules.
For a tech company integrating with DocuWare—especially if your customers already use iManage—you can pull documents and their index fields by client/matter, push new or versioned files, update legal holds and retention categories, and sync workflow status back to your app. That enables features like matter-centric document sync with iManage, automated intake and triage from email or e-forms, approval tracking tied to tasks and stamps, and unified audit trails across both systems.
What is DocuWare?
DocuWare (https://www.docuware.com) is a cloud and on‑premise document management and enterprise content management (ECM) platform. It centralizes documents in searchable file cabinets, applies metadata via intelligent indexing, and orchestrates business processes with configurable workflows.
Core product areas include:
- Document Capture & Intelligent Indexing (email capture, scan import, OCR, auto-tagging)
- File Cabinets & Search (secure repositories, index fields, full-text, result lists)
- Workflow & Task Automation (routing, approvals, stamps/annotations, escalations)
- Forms & E‑Signature (web forms, data capture, e-sign integrations)
- Records Management & Retention (policies, legal holds, audits)
- Security & Compliance (user/role permissions, encryption, audit trails)
- Integrations (Microsoft 365, ERP/finance, email, line-of-business apps)
Common data entities:
- File Cabinets (repositories with defined index fields and permissions)
- Documents & Versions (binary files, revisions, content type)
- Index Fields (client number, matter number, document type, author, dates, custom fields)
- Document Trays/Baskets (inboxes for capture prior to filing)
- Workflows & Tasks (assignments, steps, stamps, outcomes)
- Stamps & Annotations (approvals, notes, redactions)
- Users/Groups & Roles (access control)
- Forms & Submissions (structured input, attachments)
- Retention Policies & Legal Holds (categories, schedules, exceptions)
- Audit Events (create/update/delete, access, workflow actions)
The DocuWare Integration Challenge
Legal teams rely on DocuWare to keep matter files compliant and discoverable, but turning portal-centric actions into API-driven automation—especially alongside iManage—introduces complexity:
- Dual DMS models: Mapping iManage’s matter-centric workspaces and document numbering to DocuWare’s file cabinets and index schemas
- Metadata parity: Keeping client/matter, document type, author, and security classes synchronized without drift
- Version & file handling: Large files, multiple formats, and version merges across systems
- OCR & indexing latency: Intelligent indexing and full-text readiness may lag uploads, requiring async status handling
- Permission alignment: Respecting DocuWare roles, file cabinet ACLs, stamps, and restricted views in headless jobs
- SSO/MFA & hybrid deployments: Navigating cloud, on-prem, and SSO/MFA scenarios for unattended service accounts
- Records controls: Applying retention and legal hold programmatically with audit-grade idempotency
How Supergood Creates DocuWare APIs
Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your DocuWare tenant.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes documents, file cabinets, index fields, workflows, and audit logs into stable schemas
- Aligns with customer entitlements, file cabinet permissions, and role-based access
- Supports high-volume intake (email/scan), versioned uploads, and long-running jobs (OCR, imports) with polling or webhooks
- Provides mappers for iManage client/matter fields and document types for clean bi-directional sync
Use Cases
Matter-Centric Document Sync with iManage
- Map DocuWare file cabinets to iManage clients/matters and keep index fields in lockstep
- Push executed agreements from your app to both systems and maintain version history
- Detect changes (new versions, refiled docs) and update your platform via webhooks
Contract & AP Intake Into Legal
- Capture vendor contracts and invoices from email or forms and auto-index by supplier, matter, and type
- Route to legal reviewers with DocuWare workflows; surface status inside your app
- Extract key fields to populate your own contract or billing objects
Workflow-Driven Approvals & Signatures
- Start DocuWare approvals when documents are uploaded from your platform
- Apply stamps and record decisions; attach evidence and signed copies
- Notify iManage and your app as tasks complete to keep matter timelines current
Records & Legal Hold Management
- Apply retention categories programmatically and freeze documents under litigation hold
- Maintain immutable audit logs for who changed what, when, and why
- Export defensible reports spanning DocuWare and your system of record
Available Endpoints
Authentication
POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/sessions \
--header 'Authorization: Basic <Base64 encoded token>' \
--header 'Content-Type: application/json' \
--data '{
"username": "[email protected]",
"password": "<password>",
"mfa": { "type": "totp", "code": "123456" }
}'
Example response
{
"authToken": "eyJhbGciOi...",
"expiresIn": 3600,
"user": {
"id": "u_dw_7a3c2f",
"name": "Paralegal",
"entitlements": ["file_cabinets", "documents", "workflows", "records"]
}
}
POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.
Documents
POST /documents: Create or version a document in a file cabinet with index fields and optional legal hold.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/documents \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"fileCabinetId": "fc_legal_01",
"externalId": "imanage:doc_12345",
"uploadToken": "upl_a1b2c3",
"fileName": "NDA_Acorn_v3.docx",
"indexFields": {
"ClientNumber": "100245",
"MatterNumber": "2024-0087",
"DocumentType": "NDA",
"Author": "jdoe",
"FilingDate": "2026-02-15",
"SecurityClass": "Confidential"
},
"versioning": {"mode": "new_version", "note": "Imported from iManage"},
"legalHold": {"enabled": false},
"tags": ["iManage", "import"]
}'
Example response
{
"documentId": "doc_7f13ad",
"fileCabinetId": "fc_legal_01",
"version": 4,
"indexFields": {
"ClientNumber": "100245",
"MatterNumber": "2024-0087",
"DocumentType": "NDA",
"Author": "jdoe",
"FilingDate": "2026-02-15",
"SecurityClass": "Confidential"
},
"createdAt": "2026-02-20T10:03:11Z"
}
Search
GET /documents/search: Search a file cabinet by full-text and/or index fields, with delta sync filters.
Query parameters
- fileCabinetId: string (required)
- q: string (full-text query)
- filters[ClientNumber], filters[MatterNumber], filters[DocumentType], filters[Author]: strings
- updatedFrom, updatedTo: ISO 8601 timestamps
- page, pageSize: integers for pagination
Example response
{
"items": [
{
"documentId": "doc_7f13ad",
"fileName": "NDA_Acorn_v3.docx",
"version": 4,
"matchScore": 0.92,
"indexFields": {
"ClientNumber": "100245",
"MatterNumber": "2024-0087",
"DocumentType": "NDA",
"Author": "jdoe"
},
"downloadUrl": "https://api.supergood.ai/integrations/<integration_id>/documents/doc_7f13ad/download?token=dl_98fbc2",
"updatedAt": "2026-02-20T10:03:11Z"
},
{
"documentId": "doc_6c11ee",
"fileName": "Engagement_Letter_Acorn.pdf",
"version": 2,
"matchScore": 0.81,
"indexFields": {
"ClientNumber": "100245",
"MatterNumber": "2024-0087",
"DocumentType": "Engagement Letter",
"Author": "msmith"
},
"downloadUrl": "https://api.supergood.ai/integrations/<integration_id>/documents/doc_6c11ee/download?token=dl_71a85a",
"updatedAt": "2026-02-19T17:44:03Z"
}
],
"page": 1,
"pageSize": 50,
"total": 2
}
Document Updates
PATCH /documents/{documentId}: Update index fields, retention category, or apply legal hold.
curl --request PATCH \
--url https://api.supergood.ai/integrations/<integration_id>/documents/doc_7f13ad \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"indexFields": {"DocumentType": "Executed NDA", "Status": "Executed"},
"retention": {"category": "Contract - 7 Years"},
"legalHold": {"enabled": true, "reason": "Litigation hold for Matter 2024-0087"}
}'
Example response
{
"documentId": "doc_7f13ad",
"version": 4,
"indexFields": {"DocumentType": "Executed NDA", "Status": "Executed"},
"retention": {"category": "Contract - 7 Years"},
"legalHold": {"enabled": true, "appliedAt": "2026-02-20T13:28:59Z"},
"updatedBy": {"userId": "u_dw_7a3c2f", "name": "Paralegal"}
}
Technical Specifications
- Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
- Response format: JSON with consistent resource schemas and pagination across modules
- Rate limits: Tuned for enterprise throughput while honoring customer entitlements and usage controls
- Session management: Automatic reauth and cookie/session rotation with health checks
- Data freshness: Near real-time retrieval of documents, index fields, workflows, and audit events
- Security: Encrypted transport, scoped tokens, and audit logging; respects DocuWare file cabinet permissions and roles
- Webhooks: Optional delivery for long-running operations (OCR/indexing completion, workflow task updates, legal hold changes)
- Deployment models: Cloud and on‑prem tenants supported via secure connectors
Performance Characteristics
- Latency: Sub-second responses for list/detail queries under normal load; OCR and indexing completion reflect underlying platform behavior
- Throughput: Designed for high-volume intake (email/scan imports) and matter syncs across cabinets
- Reliability: Retry logic, backoff, and idempotency keys minimize duplicates and support at-least-once processing
- Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened DocuWare adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as DocuWare evolves.
Frequently Asked Questions
Q: Which DocuWare modules can this integration cover?
Supergood supports workflows commonly used by legal teams, including File Cabinets & Search (documents, index fields), Workflow Manager (tasks, stamps), Forms (submissions), and Records (retention, legal holds), subject to your licensing and entitlements. We scope coverage during integration assessment.
Q: How are MFA and SSO handled for automation?
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling and monitoring for session expiry.
Q: Do you support cloud and on‑prem DocuWare?
Yes. We operate secure connectors for on‑prem environments and native flows for cloud tenants, with the same normalized API surface.
Q: Can you map iManage workspaces and fields to DocuWare?
Yes. We provide mapping for client/matter numbers, document types, authors, and security groups, and we can maintain cross-references (e.g., iManage document IDs in externalId) to enable bi-directional sync and version reconciliation.
Q: How do you handle retention policies and legal holds?
We expose normalized operations to set retention categories and apply or release legal holds with auditable reason codes, timestamps, and idempotent updates.
Related Integrations
Intralinks API - Programmatically access the Intralinks VDR with Supergood
Ready to automate your DocuWare workflows?
Supergood can have your DocuWare integration live in days with no ongoing engineering maintenance.
