Download OpenAPI specification:Download
name | string Filters documents by name, excluding any prefix. |
limit | integer <int32> [ 1 .. 100 ] Default: 30 Maximum number of items to return. |
cursor | string Opaque continuation token used to get additional items when a previous query returned more than |
docset.id | string Filters documents by docset. |
status | string (document-status) Enum: "New" "Ingesting" "Ingested" "Processing" "Ready" "Error" "OverQuota" Example: status=Ready Filters documents by status. |
prefix | string Filters documents by |
minPages | integer <int32> >= 0 Filters documents by minimum number of pages in the document. |
maxPages | integer <int32> >= 0 Filters documents by maximum number of pages in the document. |
minSize | integer <int32> >= 0 Filters documents by minimum file size in bytes. |
maxSize | integer <int32> >= 0 Filters documents by maximum file size in bytes. |
samples | boolean Default: false Whether or not to return sample documents. |
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/documents
{- "documents": [
- {
- "id": "bn0px5iaym7z",
- "name": "Master Services Agreement.pdf",
- "status": "Ready",
- "createdAt": "2023-03-06T17:23:26.8324745+00:00",
- "size": 119907,
- "processedAt": "2023-03-06T17:30:30.9086048+00:00",
- "pageCount": 9,
- "error": {
- "title": "Encrypted File",
- "detail": "string"
}, - "docset": {
- "id": "gmk07l49tk2c",
}, - "isSample": false
}
],
}
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/documents/ID
{- "id": "bn0px5iaym7z",
- "name": "Master Services Agreement.pdf",
- "status": "Ready",
- "createdAt": "2023-03-06T17:23:26.8324745+00:00",
- "size": 119907,
- "processedAt": "2023-03-06T17:30:30.9086048+00:00",
- "pageCount": 9,
- "error": {
- "title": "Encrypted File",
- "detail": "string"
}, - "docset": {
- "id": "gmk07l49tk2c",
}, - "isSample": false
}
The maximum request size is 150 MB. The allowed file extensions are: .pdf, .docx, and .doc.
docset.id | string |
file required | string <binary> |
curl --header "Authorization: Bearer <API-KEY>" \ --form docset.id=ID \ --form file=@document.pdf \ https://api.docugami.com/v1preview1/documents/content
{- "id": "bn0px5iaym7z",
- "name": "Master Services Agreement.pdf",
- "status": "Ready",
- "createdAt": "2023-03-06T17:23:26.8324745+00:00",
- "size": 119907,
- "processedAt": "2023-03-06T17:30:30.9086048+00:00",
- "pageCount": 9,
- "error": {
- "title": "Encrypted File",
- "detail": "string"
}, - "docset": {
- "id": "gmk07l49tk2c",
}, - "isSample": false
}
curl --header "Authorization: Bearer <API-KEY>" \ --header "Accept: application/octet-stream" \ --remote-name \ --remote-header-name \ https://api.docugami.com/v1preview1/documents/ID/content
id required | string |
pageNumber required | integer |
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/documents/ID/pages/PAGE-NUMBER
{- "number": 1,
- "width": 1200,
- "height": 2550,
- "document": {
- "id": "h6qpx6eofeez",
}
}
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/documents/ID/pages/PAGE-NUMBER
{- "pages": [
- {
- "number": 1,
- "width": 1200,
- "height": 2550,
- "document": {
- "id": "h6qpx6eofeez",
}
}
], - "document": {
- "id": "h6qpx6eofeez",
}
}
id required | string |
pageNumber required | integer |
curl --header "Authorization: Bearer <API-KEY>" \ --head \ --request HEAD \ https://api.docugami.com/v1preview1/documents/ID/pages/PAGE-NUMBER/content
id required | string |
pageNumber required | integer |
curl --header "Authorization: Bearer <API-KEY>" \ --header "Accept: application/octet-stream" \ --remote-name \ --remote-header-name \ https://api.docugami.com/v1preview1/documents/ID/pages/PAGE-NUMBER/content
name | string Filters docsets by name. |
limit | integer <int32> [ 1 .. 100 ] Default: 30 Maximum number of items to return. |
cursor | string Opaque continuation token used to get additional items when a previous query returned more than |
minDocuments | integer <int32> Filters docsets by minimum number of documents in the set. |
maxDocuments | integer <int32> Filters docsets by maximum number of documents in the set. |
samples | boolean Default: false Whether or not to return sample docsets. |
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/docsets
{- "docsets": [
- {
- "id": "gmk07l49tk2c",
- "name": "Service Agreements",
- "updatedAt": "2023-03-06T17:41:50+00:00",
- "documentCount": 6,
- "createdAt": "2023-03-06T17:23:25.9993034+00:00",
- "isSample": false
}
],
}
name required | string The name of the docset. |
documents | Array of strings Optional collection of document ids to include in the new docset. Documents will be moved if they already belong to a docset. |
{- "name": "Loss Runs",
- "documents": [
- "bn0px5iaym7z"
]
}
{- "id": "gmk07l49tk2c",
- "name": "Service Agreements",
- "updatedAt": "2023-03-06T17:41:50+00:00",
- "documentCount": 6,
- "createdAt": "2023-03-06T17:23:25.9993034+00:00",
- "isSample": false
}
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/docsets/ID
{- "id": "gmk07l49tk2c",
- "name": "Service Agreements",
- "updatedAt": "2023-03-06T17:41:50+00:00",
- "documentCount": 6,
- "createdAt": "2023-03-06T17:23:25.9993034+00:00",
- "isSample": false
}
id required | string |
prefix | string Filters documents by |
limit | integer <int32> [ 1 .. 100 ] Default: 30 Maximum number of items to return. |
cursor | string Opaque continuation token used to get additional items when a previous query returned more than |
status | string (document-status) Enum: "New" "Ingesting" "Ingested" "Processing" "Ready" "Error" "OverQuota" Example: status=Ready Filters documents by status. |
minPages | integer <int32> >= 0 Filters documents by minimum number of pages in the document. |
maxPages | integer <int32> >= 0 Filters documents by maximum number of pages in the document. |
minSize | integer <int32> >= 0 Filters documents by minimum file size in bytes. |
maxSize | integer <int32> >= 0 Filters documents by maximum file size in bytes. |
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/docsets/ID/documents
{- "documents": [
- {
- "id": "bn0px5iaym7z",
- "name": "Master Services Agreement.pdf",
- "status": "Ready",
- "createdAt": "2023-03-06T17:23:26.8324745+00:00",
- "size": 119907,
- "processedAt": "2023-03-06T17:30:30.9086048+00:00",
- "pageCount": 9,
- "error": {
- "title": "Encrypted File",
- "detail": "string"
}, - "docset": {
- "id": "gmk07l49tk2c",
}, - "isSample": false
}
],
}
The document is moved if it is already part of a docset.
docsetId required | string |
documentId required | string |
curl --header "Authorization: Bearer <API-KEY>" \ --method PUT \ https://api.docugami.com/v1preview1/docsets/DOCSET-ID/documents/DOCUMENT-ID
{- "id": "gmk07l49tk2c",
- "name": "Service Agreements",
- "updatedAt": "2023-03-06T17:41:50+00:00",
- "documentCount": 6,
- "createdAt": "2023-03-06T17:23:25.9993034+00:00",
- "isSample": false
}
docsetId required | string |
documentId required | string |
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/docsets/DOCSET-ID/documents/DOCUMENT-ID
{- "id": "bn0px5iaym7z",
- "name": "Master Services Agreement.pdf",
- "status": "Ready",
- "createdAt": "2023-03-06T17:23:26.8324745+00:00",
- "size": 119907,
- "processedAt": "2023-03-06T17:30:30.9086048+00:00",
- "pageCount": 9,
- "error": {
- "title": "Encrypted File",
- "detail": "string"
}, - "docset": {
- "id": "gmk07l49tk2c",
}, - "isSample": false
}
Removing a document from a docset does not delete the document.
docsetId required | string |
documentId required | string |
curl --header "Authorization: Bearer <API-KEY>" \ --method DELETE \ https://api.docugami.com/v1preview1/docsets/DOCSET-ID/documents/DOCUMENT-ID
docsetId required | string |
documentId required | string |
curl --header "Authorization: Bearer <API-KEY>" \ --header "Accept: application/xml" \ --remote-name \ --remote-header-name \ https://api.docugami.com/v1preview1/docsets/DOCSET-ID/documents/DOCUMENT-ID/dgml
name | string Filters projects by name. |
limit | integer <int32> [ 1 .. 100 ] Default: 30 Maximum number of items to return. |
cursor | string Opaque continuation token used to get additional items when a previous query returned more than |
docset.id | string Filters projects by docset. |
type | string (project-type) Enum: "TabularReport" "Abstract" "ExcelExport" "AssistedAuthoring" "AutomationAnywhereDocumentAssembly" "AutomationAnywhereWorkFlow" "ZapierWorkFlow" "UiPathWorkFlow" "UiPathDocumentAssembly" "PowerAutomateWorkFlow" "DiligenceReport" Example: type=TabularReport Filters projects by type. |
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/projects
{- "projects": [
- {
- "id": "0gjiwhvpeqcg",
- "name": "My Report",
- "type": "TabularReport",
- "updatedAt": "2023-03-13T20:22:31.0982176+00:00",
- "createdAt": "2023-03-13T20:22:30.6981643+00:00",
- "artifacts": {
- "version": "1",
}
}
],
}
name required | string The name of the project. |
type required | any (project-type) Enum: "TabularReport" "Abstract" "ExcelExport" "AssistedAuthoring" "AutomationAnywhereDocumentAssembly" "AutomationAnywhereWorkFlow" "ZapierWorkFlow" "UiPathWorkFlow" "UiPathDocumentAssembly" "PowerAutomateWorkFlow" "DiligenceReport" |
docset.id required | string The ID of the docset this project will be associated with. |
Array of objects (project-item) | |
autoConfirmDocuments | boolean Whether or not incoming documents will be auto confirmed for a published project. |
{- "name": "Loss Runs",
- "type": "TabularReport",
- "docset.id": "string",
- "items": [
- {
- "label": "string"
}
], - "autoConfirmDocuments": true
}
{- "id": "0gjiwhvpeqcg",
- "name": "My Report",
- "type": "TabularReport",
- "updatedAt": "2023-03-13T20:22:31.0982176+00:00",
- "createdAt": "2023-03-13T20:22:30.6981643+00:00",
- "artifacts": {
- "version": "1",
}
}
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/projects/ID
{- "id": "0gjiwhvpeqcg",
- "name": "My Report",
- "type": "TabularReport",
- "updatedAt": "2023-03-13T20:22:31.0982176+00:00",
- "createdAt": "2023-03-13T20:22:30.6981643+00:00",
- "artifacts": {
- "version": "1",
}
}
id required | string |
autoConfirmDocuments | boolean Whether or not incoming documents will be auto confirmed for a published project. |
{- "autoConfirmDocuments": true
}
{- "title": "Unsupported Media Type",
- "status": 415,
- "detail": "string",
- "instance": "string",
- "property1": null,
- "property2": null
}
id required | string |
autoConfirmDocuments required | boolean Whether or not incoming documents will be auto confirmed for a published project. |
{- "autoConfirmDocuments": true
}
{- "title": "Unsupported Media Type",
- "status": 415,
- "detail": "string",
- "instance": "string",
- "property1": null,
- "property2": null
}
{- "title": "Unsupported Media Type",
- "status": 415,
- "detail": "string",
- "instance": "string",
- "property1": null,
- "property2": null
}
projectId required | string |
version | string Examples: 1 2 latest |
name | string Filters artifacts by name. |
document.id | string Filters artifacts by document id. |
limit | integer <int32> [ 1 .. 100 ] Default: 30 Maximum number of items to return. |
cursor | string Opaque continuation token used to get additional items when a previous query returned more than |
minSize | integer <int32> Filters artifacts by minimum file size in bytes. |
maxSize | integer <int32> Filters artifacts by maximum file size in bytes |
isReadOnly | boolean Filters artifacts by read-only status. |
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/projects/ID/artifacts
{- "artifacts": [
- {
- "id": "sydeqizookql",
- "name": "document.xml",
- "size": 263206,
- "version": "1",
- "createdAt": "2023-03-21T23:15:32+00:00",
- "updatedAt": "2023-03-21T23:15:32+00:00",
- "isReadOnly": true,
- "document": {
- "id": "h6qpx6eofeez",
},
}
],
}
projectId required | string |
version required | string Examples: 1 2 latest |
artifactId required | string |
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/projects/PROJECT-ID/artifacts/latest/ARTIFACT-ID
{- "id": "sydeqizookql",
- "name": "document.xml",
- "size": 263206,
- "version": "1",
- "createdAt": "2023-03-21T23:15:32+00:00",
- "updatedAt": "2023-03-21T23:15:32+00:00",
- "isReadOnly": true,
- "document": {
- "id": "h6qpx6eofeez",
},
}
Read-only artifacts cannot be deleted.
projectId required | string |
version required | string Examples: 1 2 latest |
artifactId required | string |
curl --header "Authorization: Bearer <API-KEY>" \ --request DELETE \ https://api.docugami.com/v1preview1/projects/PROJECT-ID/artifacts/latest/ARTIFACT-ID
{- "title": "Unsupported Media Type",
- "status": 415,
- "detail": "string",
- "instance": "string",
- "property1": null,
- "property2": null
}
projectId required | string |
version required | string Examples: 1 2 latest |
artifactId required | string |
curl --header "Authorization: Bearer <API-KEY>" \ --head \ --request HEAD \ https://api.docugami.com/v1preview1/projects/PROJECT-ID/artifacts/latest/ARTIFACT-ID/content
projectId required | string |
version required | string Examples: 1 2 latest |
artifactId required | string |
curl --header "Authorization: Bearer <API-KEY>" \ --header "Accept: application/octet-stream" \ --remote-name \ --remote-header-name \ https://api.docugami.com/v1preview1/projects/PROJECT-ID/artifacts/latest/ARTIFACT-ID/content
The maximum request size is 150 MB. The allowed file extensions are: .xml, .json, .csv, .xlsx, .pdf, and .docx.
projectId required | string |
version required | string Examples: 1 2 latest |
document.id | string |
file required | string <binary> |
curl --header "Authorization: Bearer <API-KEY>" \ --form document.id=DOCUMENT-ID \ --form file=@artifact.xml \ https://api.docugami.com/v1preview1/projects/PROJECT-ID/artifacts/1/content
{- "id": "sydeqizookql",
- "name": "document.xml",
- "size": 263206,
- "version": "1",
- "createdAt": "2023-03-21T23:15:32+00:00",
- "updatedAt": "2023-03-21T23:15:32+00:00",
- "isReadOnly": true,
- "document": {
- "id": "h6qpx6eofeez",
},
}
name | string Filters sample catalog by name. |
limit | integer <int32> [ 1 .. 100 ] Default: 30 Maximum number of items to return. |
cursor | string Opaque continuation token used to get additional items when a previous query returned more than |
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/sample-catalog
{- "samples": [
- {
- "id": "xmtqwbg4g0i8",
- "name": "Service Agreements",
- "description": "Software Related Master Services Agreements that establish the legal and operational parameters for engaging in software-related services. These agreements encompass the delineation of project scope, service-level expectations, intellectual property ownership, confidentiality obligations, and the protocol for resolving disputes.",
- "version": "3",
- "createdAt": "2023-03-13T20:22:30.6981643+00:00",
- "updatedAt": "2023-03-13T20:22:31.0982176+00:00"
}
],
}
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/sample-catalog/ID
{- "id": "xmtqwbg4g0i8",
- "name": "Service Agreements",
- "description": "Software Related Master Services Agreements that establish the legal and operational parameters for engaging in software-related services. These agreements encompass the delineation of project scope, service-level expectations, intellectual property ownership, confidentiality obligations, and the protocol for resolving disputes.",
- "version": "3",
- "createdAt": "2023-03-13T20:22:30.6981643+00:00",
- "updatedAt": "2023-03-13T20:22:31.0982176+00:00"
}
name | string Filters samples by name. |
status | string (sample-status) Enum: "Ready" "InProgress" "Error" Example: status=Ready Filters samples by status |
limit | integer <int32> [ 1 .. 100 ] Default: 30 Maximum number of items to return. |
cursor | string Opaque continuation token used to get additional items when a previous query returned more than |
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/samples
{- "samples": [
- {
- "id": "gmk07l49tk2c",
- "catalog": {
- "id": "xmtqwbg4g0i8",
}, - "name": "Service Agreements",
- "description": "Software Related Master Services Agreements that establish the legal and operational parameters for engaging in software-related services. These agreements encompass the delineation of project scope, service-level expectations, intellectual property ownership, confidentiality obligations, and the protocol for resolving disputes.",
- "version": "3",
- "status": "Ready",
- "createdAt": "2023-03-13T20:22:30.6981643+00:00",
- "updatedAt": "2023-03-13T20:22:31.0982176+00:00"
}
],
}
id required | string The id of the sample catalog item. |
{- "id": "xmtqwbg4g0i8"
}
{- "samples": [
- {
- "id": "gmk07l49tk2c",
- "catalog": {
- "id": "xmtqwbg4g0i8",
}, - "name": "Service Agreements",
- "description": "Software Related Master Services Agreements that establish the legal and operational parameters for engaging in software-related services. These agreements encompass the delineation of project scope, service-level expectations, intellectual property ownership, confidentiality obligations, and the protocol for resolving disputes.",
- "version": "3",
- "status": "Ready",
- "createdAt": "2023-03-13T20:22:30.6981643+00:00",
- "updatedAt": "2023-03-13T20:22:31.0982176+00:00"
}
],
}
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/samples/ID
{- "id": "gmk07l49tk2c",
- "catalog": {
- "id": "xmtqwbg4g0i8",
}, - "name": "Service Agreements",
- "description": "Software Related Master Services Agreements that establish the legal and operational parameters for engaging in software-related services. These agreements encompass the delineation of project scope, service-level expectations, intellectual property ownership, confidentiality obligations, and the protocol for resolving disputes.",
- "version": "3",
- "status": "Ready",
- "createdAt": "2023-03-13T20:22:30.6981643+00:00",
- "updatedAt": "2023-03-13T20:22:31.0982176+00:00"
}
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/workspace
{- "id": "qgwjgy7tq0ui",
- "name": "Example Workspace",
- "createdAt": "2023-03-06T16:59:52.3057791+00:00",
- "type": "Trial",
- "expired": true,
- "expiresAt": "2023-03-21T16:59:51.3057791+00:00",
- "quota": {
- "page": {
- "max": 500,
- "used": 128,
- "maxPerDocument": 50
}, - "user": {
- "max": 1,
- "used": 1
}
}
}
target | any (Webhook target) Enum: "Documents" "Project" "Docset" Example: target=Project Filters webhooks by target type. 'read:documents' scope is required for document and docset targets and 'read:projects' for project targets. |
targetId | string Example: targetId=0gjiwhvpeqcg Filters webhooks by target id. |
limit | integer <int32> [ 1 .. 100 ] Default: 30 Maximum number of items to return. |
cursor | string Opaque continuation token used to get additional items when a previous query returned more than |
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/webhooks
{- "webhooks": [
- {
- "id": "lvf4dira8uie",
- "target": "Project",
- "targetId": "0gjiwhvpeqcg",
- "createdAt": "2023-04-19T19:45:26.3755885+00:00",
- "events": [
- "Project.Artifacts.Create"
]
}
],
}
target required | any (webhook-target) Enum: "Documents" "Project" "Docset" |
url required | string <uri> |
targetId | string |
events | Array of any (Webhook events) Items Enum: "Documents.Create" "Documents.Delete" "Docset.Document.Add" "Docset.Document.Remove" "Docset.Document.Dgml" "Project.Artifacts.Create" "Project.Artifacts.Delete" "Project.Artifacts.Modify" "Project.Artifacts.Version" |
secret | string |
{- "target": "Project",
- "targetId": "0gjiwhvpeqcg",
- "events": [
- "Project.Artifacts.Create"
], - "secret": "string"
}
{- "id": "lvf4dira8uie",
- "target": "Project",
- "targetId": "0gjiwhvpeqcg",
- "createdAt": "2023-04-19T19:45:26.3755885+00:00",
- "events": [
- "Project.Artifacts.Create"
]
}
curl --header "Authorization: Bearer <API-KEY>" \ https://api.docugami.com/v1preview1/webhooks/ID
{- "id": "lvf4dira8uie",
- "target": "Project",
- "targetId": "0gjiwhvpeqcg",
- "createdAt": "2023-04-19T19:45:26.3755885+00:00",
- "events": [
- "Project.Artifacts.Create"
]
}
curl --header "Authorization: Bearer <API-KEY>" \ --request DELETE \ https://api.docugami.com/v1preview1/webhooks/ID
{- "title": "Unsupported Media Type",
- "status": 415,
- "detail": "string",
- "instance": "string",
- "property1": null,
- "property2": null
}