Documents

Documents enable you to organize and review data in collaborative files with linked text, documents, and images. Use these endpoints to manage documents and their sections in the Workiva Platform.

Background

The formatting for a background color/image of a section (page), or slide/layout.

Properties

Name	Type	Description	Restrictions
color	Color¦null	The background color in RGB
image	string¦null	The id of the image resource

Example

{
  "color": {
    "blue": 255,
    "green": 255,
    "red": 255
  },
  "image": "Yn91IGZvdW5kIG1lIQ"
}

Document

Details about the document, including its ID and name

Properties

Name	Type	Description	Restrictions
created	Action	When the action was performed, and details about the user who did it	read-only
customFieldGroups	[string]	An array of Custom Field Group IDs applied to the document.
customFields	any	A map of ids to values representing Custom Fields on the document.
id	string	The unique identifier of the document	read-only
linksStatus	LinksStatus	Indicates the status for links in a document, presentation, or spreadsheet.	read-only
lock	DocumentLockType¦null	The type of lock applied to this document, if any. Note this property is not tied to revision and will always reflect the document’s current lock state.
modified	Action	When the action was performed, and details about the user who did it	read-only
name	string	Name of the document	read-only
properties	DocumentProperties	Document properties are the configurations and setup for the document.
revision	string¦null	The current revision of the document	read-only
sectionCustomFieldGroups	[string]	An array of Custom Field Group IDs applied to all sections within the document.
template	boolean	Whether the document is a template	read-only

Example

{
  "created": {
    "dateTime": "2021-05-13T20:41:35Z"
  },
  "customFieldGroups": [],
  "customFields": {
    "com.workiva.gsr.legal_entity": "Workiva"
  },
  "id": "124efa2a142f472ba1ceab34ed18915f",
  "linksStatus": {
    "allLinks": "unpublished",
    "ownLinks": "published"
  },
  "lock": null,
  "modified": {
    "dateTime": "2021-07-07T16:44:54Z"
  },
  "name": "Example Company 10-K",
  "properties": {
    "backgroundColor": null,
    "lineNumbersType": "none",
    "pageBorder": {
      "color": {
        "blue": 0,
        "green": 0,
        "red": 0
      },
      "enabled": false,
      "margins": {
        "bottom": 24,
        "left": 24,
        "right": 24,
        "top": 24
      },
      "weight": 0.5
    },
    "pageLayout": {
      "pageDimensions": {
        "height": 792,
        "width": 612
      }
    },
    "pageMargins": {
      "bottom": 72,
      "left": 72,
      "right": 72,
      "top": 72,
      "type": "normal"
    },
    "printBleed": 0,
    "tableFormats": {
      "resizeRowsToFit": true
    },
    "type": "10-Q"
  },
  "revision": "5B3C4D7B",
  "sectionCustomFieldGroups": [],
  "template": false
}

DocumentExport

Details about the document export, including its format and options

Properties

Name	Type	Description	Restrictions
docxOptions	DocumentToDocxOptions¦null	Optional options to export the document as a Microsoft Word document (.DOCX). If no options are provided, all options default to False.
format	string	The file format to export the document as.	required
pdfOptions	DocumentToPdfOptions¦null	Optional options to export the document as a portable document file (.PDF). If no options are provided, all options default to False.
sections	[string]	The IDs of the sections of the document to export. Omit to export the entire document.
xhtmlOptions	DocumentToXhtmlOptions¦null	Optional options to export the document as .XHTML. If no options are provided, editableXhtml will be true and all other options will be false.

Enumerated Values

Property	Value
format	pdf
format	docx
format	xhtml

Example

{
  "docxOptions": {
    "includeLeaderDots": true,
    "showTableCellShading": true
  },
  "format": "docx",
  "sections": [
    "a8b3adb687644b27fafcb3a9875f0f0d_18",
    "a8b3adb687644b27fafcb3a9875f0f0d_19"
  ]
}

DocumentLockType

The type of the document lock.

Properties

Name	Type	Description	Restrictions
anonymous	string	The type of the document lock.

Enumerated Values

Property	Value
anonymous	locked

Example

"locked"

DocumentProperties

Document properties are the configurations and setup for the document.

Properties

Name	Type	Description	Restrictions
backgroundColor	Color¦null	The background color for the document.	required
lineNumbersType	LineNumbersType	The type of line numbers.	required
pageBorder	PageBorderProperties	The border properties for a page.	required
pageLayout	PageLayoutProperties	Page layout properties for a document.	required
pageMargins	PageMargins	The margins of a page. If the type is mirrored the left will represent inside and right will represent outside.	required
printBleed	number	The amount of print bleed.	required, Maximum: 72, Minimum: 0
tableFormats	DocumentTableFormats	The table formats for a document.	required
type	string¦null	The type of text document.	read-only, required, Minimum length: 1

Example

{
  "backgroundColor": null,
  "lineNumbersType": "none",
  "pageBorder": {
    "color": {
      "blue": 0,
      "green": 0,
      "red": 0
    },
    "enabled": false,
    "margins": {
      "bottom": 24,
      "left": 24,
      "right": 24,
      "top": 24
    },
    "weight": 0.5
  },
  "pageLayout": {
    "pageDimensions": {
      "height": 792,
      "width": 612
    }
  },
  "pageMargins": {
    "bottom": 72,
    "left": 72,
    "right": 72,
    "top": 72,
    "type": "normal"
  },
  "printBleed": 0,
  "tableFormats": {
    "resizeRowsToFit": true
  },
  "type": "10-Q"
}

DocumentsListResult

Returns a JSON object with data and @nextLink properties. data contains a list of Document objects, and @nextLink provides the URL to the next set of results. If there are no additional results, @nextLink doesn’t appear. If the request returns no results at all, data contains an empty array.

Properties

Name	Type	Description	Restrictions
@nextLink	string¦null	Pagination link for next set of results
data	[Document]	Details about the document, including its ID and name	required

Example

{
  "@nextLink": "<opaque_url>",
  "data": [
    {
      "created": {
        "dateTime": "2021-05-13T20:41:35Z"
      },
      "customFieldGroups": [],
      "customFields": {
        "com.workiva.gsr.legal_entity": "Workiva"
      },
      "id": "124efa2a142f472ba1ceab34ed18915f",
      "linksStatus": {
        "allLinks": "unpublished",
        "ownLinks": "published"
      },
      "lock": null,
      "modified": {
        "dateTime": "2021-07-07T16:44:54Z"
      },
      "name": "Example Company 10-K",
      "properties": {
        "backgroundColor": null,
        "lineNumbersType": "none",
        "pageBorder": {
          "color": {
            "blue": 0,
            "green": 0,
            "red": 0
          },
          "enabled": false,
          "margins": {
            "bottom": 24,
            "left": 24,
            "right": 24,
            "top": 24
          },
          "weight": 0.5
        },
        "pageLayout": {
          "pageDimensions": {
            "height": 792,
            "width": 612
          }
        },
        "pageMargins": {
          "bottom": 72,
          "left": 72,
          "right": 72,
          "top": 72,
          "type": "normal"
        },
        "printBleed": 0,
        "tableFormats": {
          "resizeRowsToFit": true
        },
        "type": "10-Q"
      },
      "revision": "5B3C4D7B",
      "sectionCustomFieldGroups": [],
      "template": false
    }
  ]
}

DocumentTableCollectionResult

Returns a JSON object with data and @nextLink properties. data contains a list of ContentTable objects, and @nextLink provides the URL to the next set of results. If there are no additional results, @nextLink doesn’t appear. If the request returns no results at all, data contains an empty array.

Properties

Name	Type	Description	Restrictions
@nextLink	string¦null	Pagination link for next set of results
data	[ContentTable]	Tables contained by this document.	required
revision	string	The revision of the document.	required

Example

{
  "@nextLink": "<opaque_url>",
  "data": [
    {
      "id": "WA7i5vbm7lNaEn6XT97lNaEn6XT9AtcW5vb22BJjMrqxmrujMrqxmru",
      "index": 0,
      "name": "Sheet 1",
      "parent": {
        "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag",
        "type": "richText"
      }
    }
  ],
  "revision": "24601abc"
}

DocumentTableFormats

The table formats for a document.

Properties

Name	Type	Description	Restrictions
resizeRowsToFit	boolean	Whether the rows of the table will resize automatically to fit the content of the cells.	required

Example

{
  "resizeRowsToFit": true
}

DocumentToDocxOptions

Optional options to export the document as a Microsoft Word document (.DOCX). If no options are provided, all options default to False.

Properties

Name	Type	Description	Restrictions
includeLeaderDots	boolean	Whether to include leader dots when exporting to .DOCX. False by default.
showTableCellShading	boolean	Whether to show table cell shading when exporting to .DOCX. False by default.

Example

{
  "includeLeaderDots": true,
  "showTableCellShading": true
}

DocumentToPdfOptions

Optional options to export the document as a portable document file (.PDF). If no options are provided, all options default to False.

Properties

Name	Type	Description	Restrictions
includeAlternateRowFill	boolean	Whether to include alternate row fill when exporting to .PDF. False by default.
includeAttachmentLabels	boolean	Whether to include attachment labels when exporting to .PDF. False by default.
includeComments	boolean	Whether to include comments when exporting to .PDF. False by default. When True, all comments are included, even those already resolved.
includeDraftWatermark	boolean	Whether to include a “Draft” watermark when exporting to .PDF. False by default.
includeHyperlinks	boolean	Whether to include hyperlinks when exporting to .PDF. False by default.
includeLeaderDots	boolean	Whether to include leader dots when exporting to .PDF. False by default.
includeTrackChanges	boolean	Whether to include track changes when exporting to .PDF. False by default.
removeSpaceFromPartialExport	boolean	Whether to remove space from partial exports when exporting to .PDF. False by default.
tagForWebAccessibility	boolean	Whether to tag for web accessibility when exporting to .PDF. False by default.
useCmykColorspace	boolean	Whether to use CMYK colorspace when exporting to .PDF. False by default.

Example

{
  "includeAlternateRowFill": true,
  "includeAttachmentLabels": true,
  "includeComments": true,
  "includeDraftWatermark": true,
  "includeHyperlinks": true,
  "includeLeaderDots": true,
  "includeTrackChanges": true,
  "removeSpaceFromPartialExport": true,
  "tagForWebAccessibility": true,
  "useCmykColorspace": true
}

DocumentToXhtmlOptions

Optional options to export the document as .XHTML. If no options are provided, editableXhtml will be true and all other options will be false.

Properties

Name	Type	Description	Restrictions
editableSimple	boolean	Whether to produce simplified editable XHTML. This option produces editable XHTML that is simpler than the editableXHTML option. Use this option when you only need the textual and numeric content of a document, but not any of the images or complex formatting. When this option is true, all other XHTML export options must be false.
editableXhtml	boolean	Whether the resulting XHTML is editable when exporting to .XHTML. False by default. If set to true, other options must be false. When exporting XHTML that you plan to edit or modify, use this option. Otherwise, the export retains fidelity so it visually matches the document as it appears in the browser.
includeExternalHyperlinks	boolean	Whether to include external hyperlinks when exporting to .XHTML. False by default.
includeHeadersAndFooters	boolean	Whether to include the headers and footers when exporting to .XHTML. False by default.

Example

{
  "editableSimple": true,
  "editableXhtml": true,
  "includeExternalHyperlinks": true,
  "includeHeadersAndFooters": true
}

DocumentFiltersReapplication

A document filter reapply operation, which can reapply filters to a document and optionally ignore read-only filters and force hide footnotes.

Properties

Name	Type	Description	Restrictions
forceHideFootnotes	boolean	Whether filters should be reapplied if doing so would cause footnotes to be hidden.
ignoreNonEditableFilters	boolean	Skip filters that cannot be reapplied (due to not having edit permissions or locked sections) instead of returning an error.

Example

{
  "forceHideFootnotes": true,
  "ignoreNonEditableFilters": true
}

LineNumbersType

The type of line numbers.

Properties

Name	Type	Description	Restrictions
anonymous	string	The type of line numbers.

Enumerated Values

Property	Value
anonymous	none
anonymous	continuous
anonymous	restartEachPage

Example

"none"

LinksPublicationOptions

Options for publishing links.

Properties

Name	Type	Description	Restrictions
publishType	string	Whether or not all links should be published. When “ownLinks” only links one has last edited are published. When “allLinks” all links in document or presentation are published.	required

Enumerated Values

Property	Value
publishType	ownLinks
publishType	allLinks

Example

{
  "publishType": "ownLinks"
}

FooterProperties

Properties for footer of a section

Properties

Name	Type	Description	Restrictions
alternatingPage	boolean	Do the headers/footers alternate between even and odd, otherwise the odd header/footer is shown for both even and odd pages.
differentFirstPage	boolean	If the first page has different header/footer value
differentLastPage	boolean	If the last page has different header/footer value
margin	object¦null	Properties related to the margins of a header and footer
margin.left	number¦null	The left edge margin in points	Minimum: 0
margin.right	number¦null	The right edge margin in points	Minimum: 0
matchSectionMargins	boolean	Whether the margins match the section margins
positionFromBottom	number¦null	The position from the bottom for footer in points	Minimum: 0
sameAsPrevious	boolean	Whether the previous section’s headers/footers shown on this section

Example

{
  "alternatingPage": false,
  "differentFirstPage": false,
  "differentLastPage": false,
  "margin": {
    "left": 10,
    "right": 10
  },
  "matchSectionMargins": false,
  "positionFromBottom": 10,
  "sameAsPrevious": false
}

HeaderFooterProperties

Properties for header and footer of a section

Properties

Name	Type	Description	Restrictions
alternatingPage	boolean	Do the headers/footers alternate between even and odd, otherwise the odd header/footer is shown for both even and odd pages.
differentFirstPage	boolean	If the first page has different header/footer value
differentLastPage	boolean	If the last page has different header/footer value
margin	object¦null	Properties related to the margins of a header and footer
margin.left	number¦null	The left edge margin in points	Minimum: 0
margin.right	number¦null	The right edge margin in points	Minimum: 0
matchSectionMargins	boolean	Whether the margins match the section margins
sameAsPrevious	boolean	Whether the previous section’s headers/footers shown on this section

Example

{
  "alternatingPage": false,
  "differentFirstPage": false,
  "differentLastPage": false,
  "margin": {
    "left": 10,
    "right": 10
  },
  "matchSectionMargins": false,
  "sameAsPrevious": false
}

HeaderProperties

Properties for header of a section

Properties

Name	Type	Description	Restrictions
alternatingPage	boolean	Do the headers/footers alternate between even and odd, otherwise the odd header/footer is shown for both even and odd pages.
differentFirstPage	boolean	If the first page has different header/footer value
differentLastPage	boolean	If the last page has different header/footer value
margin	object¦null	Properties related to the margins of a header and footer
margin.left	number¦null	The left edge margin in points	Minimum: 0
margin.right	number¦null	The right edge margin in points	Minimum: 0
matchSectionMargins	boolean	Whether the margins match the section margins
positionFromTop	number¦null	Is the position from the top for header in points	Minimum: 0
sameAsPrevious	boolean	Whether the previous section’s headers/footers shown on this section

Example

{
  "alternatingPage": false,
  "differentFirstPage": false,
  "differentLastPage": false,
  "margin": {
    "left": 10,
    "right": 10
  },
  "matchSectionMargins": false,
  "positionFromTop": 10,
  "sameAsPrevious": false
}

HeadersFooters

Set of headers or footers for a section or as the defaults on a document. The odd header/footer will be used on even pages if the alternating property in the header/footer part of the section properties is set to false.

Properties

Name	Type	Description	Restrictions
even	RichTextRef¦null	Reference to the RichText for even pages	read-only
first	RichTextRef¦null	Reference to the RichText for the first header	read-only
last	RichTextRef¦null	Reference to the RichText for the last header	read-only
odd	RichTextRef¦null	Reference to the RichText for odd pages	read-only

Example

{
  "even": {
    "revision": "2B3C4D5E",
    "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
  },
  "first": {
    "revision": "2B3C4D5E",
    "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
  },
  "last": {
    "revision": "2B3C4D5E",
    "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
  },
  "odd": {
    "revision": "2B3C4D5E",
    "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
  }
}

Margins

The margins of a rectangle for properties of objects such as a shape, text box, or page.

Properties

Name	Type	Description	Restrictions
bottom	number¦null	The bottom edge margin in points.	Minimum: 0
left	number¦null	The left edge margin in points.	Minimum: 0
right	number¦null	The right edge margin in points.	Minimum: 0
top	number¦null	The top edge margin in points.	Minimum: 0

Example

{
  "bottom": 10,
  "left": 10,
  "right": 10,
  "top": 10
}

PageBorderProperties

The border properties for a page.

Properties

Name	Type	Description	Restrictions
color	Color	Represents a color.	required
enabled	boolean	Whether the page border is enabled.	required
margins	object	The margins of the page border in points. If the page margins type is mirrored the left will represent inside and the right will represent outside.	required
margins.bottom	number	The bottom edge margin in points.	required, Minimum: 0
margins.left	number	The left edge margin in points.	required, Minimum: 0
margins.right	number	The right edge margin in points.	required, Minimum: 0
margins.top	number	The top edge margin in points.	required, Minimum: 0
weight	number	The thickness of the border, in points.	required, Maximum: 6, Minimum: 0

Example

{
  "color": {
    "blue": 0,
    "green": 0,
    "red": 0
  },
  "enabled": false,
  "margins": {
    "bottom": 24,
    "left": 24,
    "right": 24,
    "top": 24
  },
  "weight": 0.5
}

PageLayoutProperties

Page layout properties for a document.

Properties

Name	Type	Description	Restrictions
pageDimensions	Dimensions	The dimension of the page. Note that the preset page sizes that appear in the UI will just be a specific dimension value here (such as 612x792 for US Letter).	required

Example

{
  "pageDimensions": {
    "height": 792,
    "width": 612
  }
}

PageMargins

The margins of a page. If the type is mirrored the left will represent inside and right will represent outside.

Properties

Name	Type	Description	Restrictions
bottom	number	The bottom edge margin in points.	Minimum: 0
left	number	The left edge margin in points.	Minimum: 0
right	number	The right edge margin in points.	Minimum: 0
top	number	The top edge margin in points.	Minimum: 0
type	PageMarginsType	The type of the page margins.	required

Example

{
  "bottom": 72,
  "left": 72,
  "right": 72,
  "top": 72,
  "type": "normal"
}

PageMarginsType

The type of the page margins.

Properties

Name	Type	Description	Restrictions
anonymous	string	The type of the page margins.

Enumerated Values

Property	Value
anonymous	normal
anonymous	mirrored

Example

"normal"

Section

Details about the section, including its ID and name.

Properties

Name	Type	Description	Restrictions
body	RichTextRef¦null	Reference to the RichText content for this section	read-only
children	[Section]	An array of partial information about any sections within the section	read-only
customFields	any	A map of ids to values representing Custom Fields on the section.
drawingBody	DrawingRef¦null	Reference to the Drawing content for this section	read-only
footers	HeadersFooters¦null	Footers for this section	read-only
headers	HeadersFooters¦null	Headers for this section	read-only
id	string¦null	The unique identifier of the section
index	integer	The integer index of the section relative to its parent section (or to the document if no parent section). The special value -1 may be used to position a section at the end of its siblings list.
lock	SectionLockType¦null	The type of lock applied to this section, if any. Note this property is not tied to revision and will always reflect the section’s current lock state.
name	string	The name of the section
nonPrinting	boolean	Whether or not the section is non-printing
parent	Section¦null	The section’s ID and name
properties	SectionProperties¦null	Properties of this section	read-only
revision	string¦null	Current revision of this section	read-only

Example

{
  "body": {
    "revision": "2B3C4D5E",
    "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
  },
  "children": [
    {
      "id": "a8b3adb687644b27fafcb3a9875f0f0d_18",
      "name": "Risk factors",
      "revision": "5B3C4D7B"
    }
  ],
  "customFields": null,
  "drawingBody": {
    "drawing": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag",
    "revision": "2c6438ab4541de6d"
  },
  "footers": {
    "even": {
      "revision": "2B3C4D5E",
      "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
    },
    "first": {
      "revision": "2B3C4D5E",
      "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
    },
    "last": {
      "revision": "2B3C4D5E",
      "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
    },
    "odd": {
      "revision": "2B3C4D5E",
      "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
    }
  },
  "headers": {
    "even": {
      "revision": "2B3C4D5E",
      "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
    },
    "first": {
      "revision": "2B3C4D5E",
      "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
    },
    "last": {
      "revision": "2B3C4D5E",
      "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
    },
    "odd": {
      "revision": "2B3C4D5E",
      "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
    }
  },
  "id": "a8b3adb687644b27fafcb3a9875f0f0d_18",
  "index": 1,
  "lock": "lock",
  "name": "Risk factors",
  "nonPrinting": true,
  "parent": {
    "id": "a8b3adb687644b27fafcb3a9875f0f0d_18",
    "name": "Risk factors",
    "revision": "5B3C4D7B"
  },
  "properties": {
    "background": {
      "color": {
        "blue": 43,
        "green": 85,
        "red": 111
      },
      "image": "Yn91IGZvdW5kIG1lIQ"
    },
    "edgarKeepTogether": false,
    "exhibit": false,
    "footerProperties": {
      "alternatingPage": false,
      "differentFirstPage": false,
      "differentLastPage": false,
      "margin": {
        "left": 10,
        "right": 10
      },
      "matchSectionMargins": false,
      "positionFromBottom": 10,
      "sameAsPrevious": false
    },
    "headerProperties": {
      "alternatingPage": false,
      "differentFirstPage": false,
      "differentLastPage": false,
      "margin": {
        "left": 10,
        "right": 10
      },
      "matchSectionMargins": false,
      "positionFromTop": 10,
      "sameAsPrevious": false
    },
    "margins": {
      "bottom": 10,
      "left": 10,
      "right": 10,
      "top": 10
    },
    "pageBreakBefore": false,
    "pageDimensions": {
      "height": 240,
      "width": 320
    },
    "pageNumber": {
      "reset": false,
      "startAt": 1
    },
    "restartFootnoteNumbering": false,
    "trackChanges": false
  },
  "revision": "5B3C4D7B"
}

SectionCopy

Details about the destination document and, optionally, the destination section.

Properties

Name	Type	Description	Restrictions
document	string	The unique identifier of the document to copy a section into	required
sectionIndex	integer	The integer index of where within the siblings to place the new section; 0 by default. To place the section at the end of its siblings, use the special value -1.
sectionName	string¦null	The name of the new section, if different than the source section
sectionParent	string¦null	The ID of the parent section to copy the section into. To place the section at the top level of the document, use the default null.

Example

{
  "document": "327afa1a152f372fa1aeadb35ed28925d",
  "sectionIndex": 2,
  "sectionName": "October 2020",
  "sectionParent": "327afa1a152f372fa1aeadb35ed28925d_1"
}

SectionEdit

An edit to a section

Properties

Name	Type	Description	Restrictions
clearLock	ClearSectionLockEdit	Clears the selected section’s lock value
setLock	SetSectionLockEdit	Updates the selected section’s lock to the set value
setNonPrinting	SetNonPrintingEdit	Updates sections nonPrinting to the set value
type	SectionEditType	The type of the section edit	required

Example

{
  "setNonPrinting": {
    "nonPrinting": true,
    "selection": [
      "9fdff0887cb5425292dfb1fdd759753a_35",
      "9fdff0887cb5425292dfb1fdd759753a_50"
    ]
  },
  "type": "setNonPrinting"
}

SectionEditType

The type of the section edit

Properties

Name	Type	Description	Restrictions
anonymous	string	The type of the section edit

Enumerated Values

Property	Value
anonymous	clearLock
anonymous	setLock
anonymous	setNonPrinting

Example

"clearLock"

SectionLockType

A lock applied to a section.

Properties

Name	Type	Description	Restrictions
anonymous	string	A lock applied to a section.

Enumerated Values

Property	Value
anonymous	lock

Example

"lock"

SectionsEdits

A collection of section edits to perform

Properties

Name	Type	Description	Restrictions
data	[SectionEdit]	The collection of edits	required, Minimum items: 1, Maximum items: 240

Example

{
  "data": [
    {
      "setNonPrinting": {
        "nonPrinting": true,
        "selection": [
          "9fdff0887cb5425292dfb1fdd759753a_35",
          "9fdff0887cb5425292dfb1fdd759753a_50"
        ]
      },
      "type": "setNonPrinting"
    },
    {
      "setNonPrinting": {
        "nonPrinting": false,
        "selection": [
          "9fdff0887cb5425292dfb1fdd759753a_45",
          "9fdff0887cb5425292dfb1fdd759753a_40"
        ]
      },
      "type": "setNonPrinting"
    }
  ]
}

SectionsListResult

Returns a JSON object with data and @nextLink properties. data contains a list of Section objects, and @nextLink provides the URL to the next set of results. If there are no additional results, @nextLink doesn’t appear. If the request returns no results at all, data contains an empty array.

Properties

Name	Type	Description	Restrictions
@nextLink	string¦null	Pagination link for next set of results
data	[Section]	Details about the section, including its ID and name.	required

Example

{
  "@nextLink": "<opaque_url>",
  "data": [
    {
      "body": {
        "revision": "2B3C4D5E",
        "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
      },
      "children": [
        null
      ],
      "customFields": null,
      "drawingBody": {
        "drawing": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag",
        "revision": "2c6438ab4541de6d"
      },
      "footers": {
        "even": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        },
        "first": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        },
        "last": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        },
        "odd": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        }
      },
      "headers": {
        "even": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        },
        "first": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        },
        "last": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        },
        "odd": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        }
      },
      "id": "a8b3adb687644b27fafcb3a9875f0f0d_18",
      "index": 1,
      "lock": "lock",
      "name": "Risk factors",
      "nonPrinting": true,
      "parent": null,
      "properties": {
        "background": {
          "color": {
            "blue": 43,
            "green": 85,
            "red": 111
          },
          "image": "Yn91IGZvdW5kIG1lIQ"
        },
        "edgarKeepTogether": false,
        "exhibit": false,
        "footerProperties": {
          "alternatingPage": false,
          "differentFirstPage": false,
          "differentLastPage": false,
          "margin": {
            "left": 10,
            "right": 10
          },
          "matchSectionMargins": false,
          "positionFromBottom": 10,
          "sameAsPrevious": false
        },
        "headerProperties": {
          "alternatingPage": false,
          "differentFirstPage": false,
          "differentLastPage": false,
          "margin": {
            "left": 10,
            "right": 10
          },
          "matchSectionMargins": false,
          "positionFromTop": 10,
          "sameAsPrevious": false
        },
        "margins": {
          "bottom": 10,
          "left": 10,
          "right": 10,
          "top": 10
        },
        "pageBreakBefore": false,
        "pageDimensions": {
          "height": 240,
          "width": 320
        },
        "pageNumber": {
          "reset": false,
          "startAt": 1
        },
        "restartFootnoteNumbering": false,
        "trackChanges": false
      },
      "revision": "5B3C4D7B"
    }
  ]
}

SectionsListResult

Returns a JSON object with data and @nextLink properties. data contains a list of Section objects, and @nextLink provides the URL to the next set of results. If there are no additional results, @nextLink doesn’t appear. If the request returns no results at all, data contains an empty array.

Properties

Name	Type	Description	Restrictions
@nextLink	string¦null	Pagination link for next set of results
data	[Section]	Details about the section, including its ID and name.	required

Example

{
  "@nextLink": "<opaque_url>",
  "data": [
    {
      "body": {
        "revision": "2B3C4D5E",
        "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
      },
      "children": [
        null
      ],
      "customFields": null,
      "drawingBody": {
        "drawing": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag",
        "revision": "2c6438ab4541de6d"
      },
      "footers": {
        "even": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        },
        "first": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        },
        "last": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        },
        "odd": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        }
      },
      "headers": {
        "even": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        },
        "first": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        },
        "last": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        },
        "odd": {
          "revision": "2B3C4D5E",
          "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag"
        }
      },
      "id": "a8b3adb687644b27fafcb3a9875f0f0d_18",
      "index": 1,
      "lock": "lock",
      "name": "Risk factors",
      "nonPrinting": true,
      "parent": null,
      "properties": {
        "background": {
          "color": {
            "blue": 43,
            "green": 85,
            "red": 111
          },
          "image": "Yn91IGZvdW5kIG1lIQ"
        },
        "edgarKeepTogether": false,
        "exhibit": false,
        "footerProperties": {
          "alternatingPage": false,
          "differentFirstPage": false,
          "differentLastPage": false,
          "margin": {
            "left": 10,
            "right": 10
          },
          "matchSectionMargins": false,
          "positionFromBottom": 10,
          "sameAsPrevious": false
        },
        "headerProperties": {
          "alternatingPage": false,
          "differentFirstPage": false,
          "differentLastPage": false,
          "margin": {
            "left": 10,
            "right": 10
          },
          "matchSectionMargins": false,
          "positionFromTop": 10,
          "sameAsPrevious": false
        },
        "margins": {
          "bottom": 10,
          "left": 10,
          "right": 10,
          "top": 10
        },
        "pageBreakBefore": false,
        "pageDimensions": {
          "height": 240,
          "width": 320
        },
        "pageNumber": {
          "reset": false,
          "startAt": 1
        },
        "restartFootnoteNumbering": false,
        "trackChanges": false
      },
      "revision": "5B3C4D7B"
    }
  ]
}

SectionLockType

A lock applied to a section.

Properties

Name	Type	Description	Restrictions
anonymous	string	A lock applied to a section.

Enumerated Values

Property	Value
anonymous	lock

Example

"lock"

SectionProperties

Section properties are the configurations and setup for the section.

Properties

Name	Type	Description	Restrictions
background	Background	The formatting for a background color/image of a section (page), or slide/layout.
edgarKeepTogether	boolean¦null	Determines if page breaks should be ignored for this section in Edgar export
exhibit	boolean¦null	Whether or not the section is an exhibit
footer	FooterProperties	Properties for the footer
header	HeaderProperties	Properties for the header
margins	Margins	Margins for each page
pageBreakBefore	boolean	Whether or not there should be a page break before the section
pageDimensions	Dimensions¦null	Dimensions of each page
pageNumber	object	Page number properties
pageNumber.reset	boolean	Whether the page numbers should restart at the section
pageNumber.startAt	integer	The page number to start numbering at in this section	Minimum: 1
restartFootnoteNumbering	boolean	Whether or not to restart footnote numbering in the section
trackChanges	boolean	Whether or not track changes is enabled

Example

{
  "background": {
    "color": {
      "blue": 43,
      "green": 85,
      "red": 111
    },
    "image": "Yn91IGZvdW5kIG1lIQ"
  },
  "edgarKeepTogether": false,
  "exhibit": false,
  "footerProperties": {
    "alternatingPage": false,
    "differentFirstPage": false,
    "differentLastPage": false,
    "margin": {
      "left": 10,
      "right": 10
    },
    "matchSectionMargins": false,
    "positionFromBottom": 10,
    "sameAsPrevious": false
  },
  "headerProperties": {
    "alternatingPage": false,
    "differentFirstPage": false,
    "differentLastPage": false,
    "margin": {
      "left": 10,
      "right": 10
    },
    "matchSectionMargins": false,
    "positionFromTop": 10,
    "sameAsPrevious": false
  },
  "margins": {
    "bottom": 10,
    "left": 10,
    "right": 10,
    "top": 10
  },
  "pageBreakBefore": false,
  "pageDimensions": {
    "height": 240,
    "width": 320
  },
  "pageNumber": {
    "reset": false,
    "startAt": 1
  },
  "restartFootnoteNumbering": false,
  "trackChanges": false
}

SectionSelection

A selection of one or more sections

Properties

None

Example

[
  "e34730f79a144b1b8977aa8884c208ee_321",
  "e34730f79a144b1b8977aa8884c208ee_123"
]