documents

Updates the specified document content.

Changed on

Updates document content using UTF-8 HTML or Markdown. Set contentFormat to html or markdown; HTML is the default. Exported Markdown uses hidden metadata to preserve safe editor structures during re-import. <Check title="Required Permissions" icon="key">The user must have at least write permission for the specified document.</Check>

put/documents/{documentId}/content

Request

  • Base URL: https://api.awork.com/api/v1
  • URL: https://api.awork.com/api/v1/documents/{documentId}/content
  • Auth: HTTP bearer

Path parameters

documentIdstring uuid required

The id of the document to update.

Request body multipart/form-data

contentstring binary required

The UTF-8 document content. Use Awork.Core.Models.Documents.Documents.DocumentContentForm.ContentFormat to select HTML or Markdown input.

contentFormat'html' | 'markdown'

The input format of Awork.Core.Models.Documents.Documents.DocumentContentForm.Content. Defaults to html. Canonical awork Markdown supports lossless re-import of safe editor content.

Response

OK

idstring uuid

The id of the entity.

createdOnstring date-time

The date this entity was created.

createdBystring uuid

The id of the user who created this entity.

updatedOnstring date-time

The date this entity was last modified.

updatedBystring uuid

The id of the user who last modified this entity.

namestring nullable

The name of the document.

currentDocumentVersionIdstring uuid nullable

The id of the current document version.

documentSpaceIdstring uuid nullable

The id of the document space.

parentIdstring uuid nullable

The id of the document's parent document.

projectIdstring uuid nullable

The id of the project this document references.

taskIdstring uuid nullable

The id of the task this document references.

emojistring nullable

The emoji of the document.

isPrivateboolean

Whether the document is private.

ordernumber double nullable

The order of the document in either the list of private docs, the referenced document space or in the referenced project.

isExternalboolean

Whether the document belongs to an external project.

isHiddenForConnectUsersboolean

Whether the document is hidden for connect users.

workspaceAccessLevelstring nullable

Determines the level of access to this document granted to all workspace users. Can be either not set (no access), read, or manage.

inheritedWorkspaceAccessFromDocumentIdstring uuid nullable

The id of the document the workspace access level permission has been inherited from.

movedToTrashOnstring date-time nullable

The date the document has been moved to the trash

movedToTrashBystring uuid nullable

The id of the user that moved the document to the trash.

rootDocumentCreatedBystring uuid

The user id of the creator of the root document of this document's document tree.

Changes

  • 1556e0487867Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API

  • 8e46cf415581Revision changes
    • info

      api operation id PutDocumentContentByDocumentId removed and replaced with documents_PutDocumentContentByDocumentId