Documents Plugin

Save PAGE content (optimistic concurrency + version snapshot).

PUT

http://localhost:3000/api/plugins/docs/documents/{id}/content

curl -X PUT 'http://localhost:3000/api/plugins/docs/documents/string/content' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "tenant": {},
  "tenantId": "string",
  "organization": {},
  "organizationId": "string",
  "sentTo": "string",
  "contentJson": {},
  "contentHtml": "string",
  "contentBinary": "dGVzdA==",
  "expectedUpdatedAt": "2024-01-15T09:30:00Z",
  "forceSnapshot": true,
  "mentionEmployeeIds": [
    "string"
  ],
  "metadata": {
    "schemaVersion": 0
  }
}'

const body = `{
  "tenant": {},
  "tenantId": "string",
  "organization": {},
  "organizationId": "string",
  "sentTo": "string",
  "contentJson": {},
  "contentHtml": "string",
  "contentBinary": "dGVzdA==",
  "expectedUpdatedAt": "2024-01-15T09:30:00Z",
  "forceSnapshot": true,
  "mentionEmployeeIds": [
    "string"
  ],
  "metadata": {
    "schemaVersion": 0
  }
}`;

const response = await fetch('http://localhost:3000/api/plugins/docs/documents/string/content', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
  },
  body,
});

const data = await response.text();

import requests

body = '''{
  "tenant": {},
  "tenantId": "string",
  "organization": {},
  "organizationId": "string",
  "sentTo": "string",
  "contentJson": {},
  "contentHtml": "string",
  "contentBinary": "dGVzdA==",
  "expectedUpdatedAt": "2024-01-15T09:30:00Z",
  "forceSnapshot": true,
  "mentionEmployeeIds": [
    "string"
  ],
  "metadata": {
    "schemaVersion": 0
  }
}'''

response = requests.put(
    'http://localhost:3000/api/plugins/docs/documents/string/content',
    data=body.encode('utf-8'),
    headers={
        'Content-Type': 'application/json',
    },
)
print(response.text)

Request Body

{
  "tenant": {},
  "tenantId": "string",
  "organization": {},
  "organizationId": "string",
  "sentTo": "string",
  "contentJson": {},
  "contentHtml": "string",
  "contentBinary": "dGVzdA==",
  "expectedUpdatedAt": "2024-01-15T09:30:00Z",
  "forceSnapshot": true,
  "mentionEmployeeIds": [
    "string"
  ],
  "metadata": {
    "schemaVersion": 0
  }
}

200

{
  "deletedAt": "2018-11-21T06:20:32.232Z",
  "createdAt": "2018-11-21T06:20:32.232Z",
  "updatedAt": "2018-11-21T06:20:32.232Z",
  "id": "string",
  "isActive": true,
  "isArchived": false,
  "archivedAt": "2018-11-21T06:20:32.232Z",
  "tenantId": "string",
  "organizationId": "string",
  "kind": "FOLDER",
  "index": 0,
  "name": "string",
  "icon": "string",
  "color": "string",
  "description": "string",
  "contentJson": {},
  "contentHtml": "string",
  "contentBinary": "<binary>",
  "isLocked": true,
  "storageProvider": "LOCAL",
  "storageKey": "string",
  "thumbKey": "string",
  "mimeType": "string",
  "fileSize": 0,
  "sha256": "string",
  "originalFilename": "string",
  "version": 0,
  "extractedText": "string",
  "extractedTextEdited": true,
  "summary": "string",
  "status": "UPLOADED",
  "statusMessage": "string",
  "source": "UPLOAD",
  "knowledgeStatus": "NONE",
  "aiConfidence": 0,
  "searchable": true,
  "reviewStatus": "NONE",
  "reviewReason": "extraction-failed",
  "reviewedAt": "2024-01-15T09:30:00Z",
  "visibility": "ORGANIZATION",
  "externalSource": "string",
  "externalId": "string",
  "metadata": {},
  "parentId": "string",
  "reviewedById": "string"
}

Body

application/json

tenantobject

tenantIdstring

organizationobject

organizationIdstring

sentTostring

contentJsonobjectrequired

Canonical TipTap JSON document

contentHtmlstring

Render cache (editor.getHTML()), sanitized server-side

contentBinarystring<byte>

expectedUpdatedAtstring<date-time>required

forceSnapshotboolean

mentionEmployeeIdsArray<string>

metadataUpdateDocumentContentMetadataDTO

Show child attributes

schemaVersionnumber

Parameters

idstringrequiredpath

Response

200OKDocument

Content saved successfully.

Response fields application/json

deletedAtstring<date-time>

Example

2018-11-21T06:20:32.232Z

createdAtstring<date-time>

The creation timestamp of the entity.

Example

2018-11-21T06:20:32.232Z

updatedAtstring<date-time>

The last update timestamp of the entity.

Example

2018-11-21T06:20:32.232Z

idstring

isActivebooleantrue

isArchivedbooleanfalse

archivedAtstring<date-time>

Example

2018-11-21T06:20:32.232Z

tenantIdstring

organizationIdstring

kindstringFOLDERPAGEFILErequired

indexnumberrequired

Sibling sort order within the parent

namestringrequired

Display name / page title

iconstring

colorstring

descriptionstring

contentJsonobject

contentHtmlstring

contentBinarystring<binary>

isLockedbooleanrequired

storageProviderstringLOCALS3WASABICLOUDINARYDIGITALOCEAN

storageKeystring

thumbKeystring

mimeTypestring

fileSizenumber

sha256string

originalFilenamestring

versionnumberrequired

extractedTextstring

extractedTextEditedbooleanrequired

summarystring

statusstringUPLOADEDPROCESSINGREADYFAILEDrequired

statusMessagestring

sourcestringUPLOADEDITORCHATEMAILINTEGRATIONSYSTEMIMPORTrequired

knowledgeStatusstringNONEQUEUEDINDEXINGINDEXEDFAILEDEXCLUDEDrequired

aiConfidencenumber

searchablebooleanrequired

reviewStatusstringNONEPENDINGAPPROVEDREJECTEDrequired

reviewReasonstringextraction-failedlow-confidenceai-generatedmanual

reviewedAtstring<date-time>

visibilitystringORGANIZATIONPRIVATErequired

externalSourcestring

externalIdstring

metadataobject

parentIdstring

reviewedByIdstring

409Conflict

Content changed since it was loaded.

Stack Overflow Website Demo