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,
    "footnotes": {
      "line": {
        "color": {
          "alpha": 100,
          "blue": 0,
          "green": 0,
          "red": 0
        },
        "enabled": true,
        "length": 180,
        "style": "single",
        "weight": 1
      },
      "prefix": "",
      "restartsAt": "continuous",
      "sequenceStarts": 1,
      "style": "numeric",
      "suffix": ""
    },
    "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
    },
    "trackChanges": false,
    "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
footnotes	FootnoteProperties	The footnote properties for a document or section.	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
trackChanges	boolean	Whether track changes is enabled for the entire document. When true, this setting overrides per-section track changes; section values may still be read and written but do not apply while this document-level setting is on.	required
type	string¦null	The type of text document.	read-only, required, Minimum length: 1

Example

{
  "backgroundColor": null,
  "footnotes": {
    "line": {
      "color": {
        "alpha": 100,
        "blue": 0,
        "green": 0,
        "red": 0
      },
      "enabled": true,
      "length": 180,
      "style": "single",
      "weight": 1
    },
    "prefix": "",
    "restartsAt": "continuous",
    "sequenceStarts": 1,
    "style": "numeric",
    "suffix": ""
  },
  "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
  },
  "trackChanges": false,
  "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,
        "footnotes": {
          "line": {
            "color": {
              "alpha": 100,
              "blue": 0,
              "green": 0,
              "red": 0
            },
            "enabled": true,
            "length": 180,
            "style": "single",
            "weight": 1
          },
          "prefix": "",
          "restartsAt": "continuous",
          "sequenceStarts": 1,
          "style": "numeric",
          "suffix": ""
        },
        "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
        },
        "trackChanges": false,
        "type": "10-Q"
      },
      "revision": "5B3C4D7B",
      "sectionCustomFieldGroups": [],
      "template": false
    }
  ]
}

Bookmark

A bookmark in a document.

Properties

Name	Type	Description	Restrictions
id	string	The unique identifier of the bookmark.	read-only, required
location	BookmarkLocation	The location where a bookmark is attached within a document.	required
name	string	The display name of the bookmark.	required, Maximum length: 250

Example

{
  "id": "string",
  "location": {
    "richTextSelection": {
      "id": "string",
      "selection": {
        "start": {
          "offset": 0,
          "paragraphIndex": 0
        },
        "stop": {
          "offset": 10,
          "paragraphIndex": 2
        }
      }
    },
    "tableRange": {
      "id": "string",
      "range": {
        "startColumn": 0,
        "startRow": 5,
        "stopColumn": 3,
        "stopRow": 9
      }
    },
    "type": "richTextSelection"
  },
  "name": "string"
}

BookmarkBatchEdit

A collection of bookmark edits to perform atomically.

Properties

Name	Type	Description	Restrictions
data	[BookmarkEdit]	The collection of bookmark edits.	required, Minimum items: 1, Maximum items: 100
revision	string¦null	Revision to apply edits against. Defaults to head.

Example

{
  "data": [
    {
      "deleteBookmark": {
        "bookmark": "string"
      },
      "insertBookmark": {
        "location": {
          "richTextSelection": {
            "id": "string",
            "selection": {
              "start": {
                "offset": 0,
                "paragraphIndex": 0
              },
              "stop": {
                "offset": 10,
                "paragraphIndex": 2
              }
            }
          },
          "tableRange": {
            "id": "string",
            "range": {
              "startColumn": 0,
              "startRow": 5,
              "stopColumn": 3,
              "stopRow": 9
            }
          },
          "type": "richTextSelection"
        },
        "name": "string"
      },
      "type": "insertBookmark",
      "updateBookmark": {
        "bookmark": "string",
        "name": "string"
      }
    }
  ],
  "revision": "string"
}

BookmarkPageNumber

A dynamic content text element which will be replaced with the page number of a specified bookmark during layout.

Properties

Name	Type	Description	Restrictions
bookmark	string	The id of the bookmark whose page number this element represents.	Minimum length: 1
format	RichTextFormat	The formatting options applied to rich text elements.
length	integer	The number of characters (32-bit unicode code point) for a text element or range of text in a selection. Most elements will have a length of 1, even if it is dynamic content which will be replaced by possibly multiple characters. The lengths are used when editing with offsets from an element. The sum of the lengths up to a specific element from another is the offset between those text elements.	Minimum: 1
offset	integer	The number of items to skip over in a collection before the items which will be returned or worked on. The items may be shapes, sections, elements, characters, slides, etc depending on which object or path the offset is being used on.	Minimum: 0
style	StyleRef	A reference to a style.

Example

{
  "bookmark": "string",
  "format": {
    "backgroundColor": {
      "blue": 128,
      "green": 128,
      "red": 128
    },
    "baselineShift": "superscript",
    "bold": true,
    "characterSpacing": -25,
    "font": "Times New Roman",
    "italic": true,
    "size": 14,
    "strikethrough": true,
    "textColor": {
      "blue": 128,
      "green": 128,
      "red": 128
    },
    "underline": true
  },
  "length": 1,
  "offset": 10,
  "style": {
    "revision": "2B3C4D5E",
    "style": "c3R5bGUta2V5Ol90Ymw",
    "styleGuide": "a4a9271b80e94cccb541160c9f8e61d6"
  }
}

BookmarkCollection

A paginated collection of bookmarks within a document, returned in document order.

Properties

Name	Type	Description	Restrictions
@nextLink	string¦null	A link to the next page of bookmarks.
data	[Bookmark]	Bookmarks contained by this document.	required

Example

{
  "@nextLink": "string",
  "data": [
    {
      "id": "string",
      "location": {
        "richTextSelection": {
          "id": "string",
          "selection": {
            "start": {
              "offset": 0,
              "paragraphIndex": 0
            },
            "stop": {
              "offset": 10,
              "paragraphIndex": 2
            }
          }
        },
        "tableRange": {
          "id": "string",
          "range": {
            "startColumn": 0,
            "startRow": 5,
            "stopColumn": 3,
            "stopRow": 9
          }
        },
        "type": "richTextSelection"
      },
      "name": "string"
    }
  ]
}

BookmarkEdit

A single bookmark edit operation.

Properties

Name	Type	Description	Restrictions
deleteBookmark	DeleteBookmark	Deletes an existing bookmark by ID.
insertBookmark	InsertBookmark	Creates a new bookmark at the specified location.
type	BookmarkEditType	The type of bookmark edit operation.	required
updateBookmark	UpdateBookmark	Updates mutable properties of an existing bookmark.

Example

{
  "deleteBookmark": {
    "bookmark": "string"
  },
  "insertBookmark": {
    "location": {
      "richTextSelection": {
        "id": "string",
        "selection": {
          "start": {
            "offset": 0,
            "paragraphIndex": 0
          },
          "stop": {
            "offset": 10,
            "paragraphIndex": 2
          }
        }
      },
      "tableRange": {
        "id": "string",
        "range": {
          "startColumn": 0,
          "startRow": 5,
          "stopColumn": 3,
          "stopRow": 9
        }
      },
      "type": "richTextSelection"
    },
    "name": "string"
  },
  "type": "insertBookmark",
  "updateBookmark": {
    "bookmark": "string",
    "name": "string"
  }
}

BookmarkEditType

The type of bookmark edit operation.

Properties

Name	Type	Description	Restrictions
anonymous	string	The type of bookmark edit operation.

Enumerated Values

Property	Value
anonymous	insertBookmark
anonymous	deleteBookmark
anonymous	updateBookmark

Example

"insertBookmark"

BookmarkLocation

The location where a bookmark is attached within a document.

Properties

Name	Type	Description	Restrictions
richTextSelection	RichTextBookmarkLocation	A bookmark location within a rich text content.
tableRange	TableRangeBookmarkLocation	A bookmark location within a table range.
type	BookmarkLocationType	The type of location where a bookmark is attached.	required

Example

{
  "richTextSelection": {
    "id": "string",
    "selection": {
      "start": {
        "offset": 0,
        "paragraphIndex": 0
      },
      "stop": {
        "offset": 10,
        "paragraphIndex": 2
      }
    }
  },
  "tableRange": {
    "id": "string",
    "range": {
      "startColumn": 0,
      "startRow": 5,
      "stopColumn": 3,
      "stopRow": 9
    }
  },
  "type": "richTextSelection"
}

BookmarkLocationType

The type of location where a bookmark is attached.

Properties

Name	Type	Description	Restrictions
anonymous	string	The type of location where a bookmark is attached.

Enumerated Values

Property	Value
anonymous	richTextSelection
anonymous	tableRange

Example

"richTextSelection"

DeleteBookmark

Deletes an existing bookmark by ID.

Properties

Name	Type	Description	Restrictions
bookmark	string	The bookmark ID to delete.	required

Example

{
  "bookmark": "string"
}

InsertBookmark

Creates a new bookmark at the specified location.

Properties

Name	Type	Description	Restrictions
location	BookmarkLocation	The location where a bookmark is attached within a document.	required
name	string¦null	Display name for the bookmark. If omitted, a name is auto-generated from the bookmarked content.	Maximum length: 250

Example

{
  "location": {
    "richTextSelection": {
      "id": "string",
      "selection": {
        "start": {
          "offset": 0,
          "paragraphIndex": 0
        },
        "stop": {
          "offset": 10,
          "paragraphIndex": 2
        }
      }
    },
    "tableRange": {
      "id": "string",
      "range": {
        "startColumn": 0,
        "startRow": 5,
        "stopColumn": 3,
        "stopRow": 9
      }
    },
    "type": "richTextSelection"
  },
  "name": "string"
}

RichTextBookmarkLocation

A bookmark location within a rich text content.

Properties

Name	Type	Description	Restrictions
id	string	The rich text content ID containing the bookmark.	required
selection	RichTextSelection	Describes a selection within piece of rich text	required

Example

{
  "id": "string",
  "selection": {
    "start": {
      "offset": 0,
      "paragraphIndex": 0
    },
    "stop": {
      "offset": 10,
      "paragraphIndex": 2
    }
  }
}

TableRangeBookmarkLocation

A bookmark location within a table range.

Properties

Name	Type	Description	Restrictions
id	string	The table content ID containing the bookmark.	required
range	CellRange	A range of cells in a table. If any field is omitted or null, the range is unbounded in that direction. All indexes are zero based.	required

Example

{
  "id": "string",
  "range": {
    "startColumn": 0,
    "startRow": 5,
    "stopColumn": 3,
    "stopRow": 9
  }
}

UpdateBookmark

Updates mutable properties of an existing bookmark.

Properties

Name	Type	Description	Restrictions
bookmark	string	The bookmark ID to update.	required
name	string¦null	New display name for the bookmark. If null, the name is left unchanged.	Maximum length: 250

Example

{
  "bookmark": "string",
  "name": "string"
}

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"

LinksDestinationReplacementOptions

Options for replacing link destinations.

Properties

Name	Type	Description	Restrictions
replacementMapping	object	A map of existing destination link IDs to replacement link IDs. Replacement IDs can be either anchor IDs (source links) or destination link IDs.	required
replacementMapping.additionalProperties	string	The unique identifier of a destination link or anchor (compact-encoded WURL).	Minimum length: 1

Example

{
  "replacementMapping": {
    "WA7i5vbm7lNaEn6XT9AtcW5vb22BJjMrqxmru": "XB8j6wco8mObFo7YU0BudX6wp33CKkNsrynou",
    "YC9k7xdp9nPcGp8ZV1CveY7xq44DLlOtrzoov": "ZD0l8yep0oQdHq9AW2DwfZ8yr55EMmPuszppw"
  }
}

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
}

FootnoteLine

The properties of the footnote line.

Properties

Name	Type	Description	Restrictions
color	RGBAColor	A color with transparency. A null color will use the default based on where the color is used.	required
enabled	boolean	Whether the footnote line is enabled.	required
length	number	The length of the footnote line, in points.	required, Minimum: 144
style	FootnoteLineStyle	The style of the footnote line.	required
weight	number	The thickness of the footnote line, in points.	required, Maximum: 10, Minimum: 0.25

Example

{
  "color": {
    "alpha": 100,
    "blue": 128,
    "green": 128,
    "red": 128
  },
  "enabled": true,
  "length": 144,
  "style": "single",
  "weight": 0.25
}

FootnoteLineStyle

The style of the footnote line.

Properties

Name	Type	Description	Restrictions
anonymous	string	The style of the footnote line.

Enumerated Values

Property	Value
anonymous	single
anonymous	double
anonymous	ditted
anonymous	dashed
anonymous	small-dash
anonymous	long-dash
anonymous	long-dash-dot

Example

"single"

FootnoteProperties

The footnote properties for a document or section.

Properties

Name	Type	Description	Restrictions
line	FootnoteLine	The properties of the footnote line.	required
prefix	string	Prefix for each footnote.	required, Maximum length: 10
restartsAt	FootnoteRestartsAt	The restart strategy for footnote numbering.	required
sequenceStarts	integer	The number that footnotes will start counting from.	required, Maximum: 100000, Minimum: 1
style	FootnoteStyle	The style of footnote numbering.	required
suffix	string	Suffix for each footnote.	required, Maximum length: 10

Example

{
  "line": {
    "color": {
      "alpha": 100,
      "blue": 128,
      "green": 128,
      "red": 128
    },
    "enabled": true,
    "length": 144,
    "style": "single",
    "weight": 0.25
  },
  "prefix": "string",
  "restartsAt": "continuous",
  "sequenceStarts": 1,
  "style": "numeric",
  "suffix": "string"
}

FootnoteRestartsAt

The restart strategy for footnote numbering.

Properties

Name	Type	Description	Restrictions
anonymous	string	The restart strategy for footnote numbering.

Enumerated Values

Property	Value
anonymous	continuous
anonymous	section
anonymous	page

Example

"continuous"

FootnoteStyle

The style of footnote numbering.

Properties

Name	Type	Description	Restrictions
anonymous	string	The style of footnote numbering.

Enumerated Values

Property	Value
anonymous	numeric
anonymous	uppercaseAlphabetic
anonymous	lowercaseAlphabetic
anonymous	uppercaseRoman
anonymous	lowercaseRoman
anonymous	symbol

Example

"numeric"

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"

RGBAColor

A color with transparency. A null color will use the default based on where the color is used.

Properties

Name	Type	Description	Restrictions
alpha	integer	The percent of opacity where 0 is fully transparent and 100 is fully opaque.	required, Maximum: 100, Minimum: 0
blue	integer	The blue component of the color.	required, Maximum: 255, Minimum: 0
green	integer	The green component of the color.	required, Maximum: 255, Minimum: 0
red	integer	The red component of the color.	required, Maximum: 255, Minimum: 0

Example

{
  "alpha": 100,
  "blue": 128,
  "green": 128,
  "red": 128
}

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
    },
    "footnotes": {
      "line": {
        "color": {
          "alpha": 100,
          "blue": 0,
          "green": 0,
          "red": 0
        },
        "enabled": true,
        "length": 180,
        "style": "single",
        "weight": 1
      },
      "prefix": "",
      "restartsAt": "continuous",
      "sequenceStarts": 1,
      "style": "numeric",
      "suffix": ""
    },
    "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"

SectionFootnoteLine

The properties of the footnote line for a section. Null indicates the property is inherited from the document.

Properties

Name	Type	Description	Restrictions
color	RGBAColor¦null	A color with transparency. A null color will use the default based on where the color is used.	required
enabled	boolean¦null	Whether the footnote line is enabled.	required
length	number¦null	The length of the footnote line, in points.	required, Minimum: 144
style	FootnoteLineStyle¦null	The style of the footnote line.	required
weight	number¦null	The thickness of the footnote line, in points.	required, Maximum: 10, Minimum: 0.25

Example

{
  "color": {
    "alpha": 100,
    "blue": 128,
    "green": 128,
    "red": 128
  },
  "enabled": true,
  "length": 144,
  "style": "single",
  "weight": 0.25
}

SectionFootnoteProperties

The footnote properties for a section. Null indicates the property is inherited from the document.

Properties

Name	Type	Description	Restrictions
line	SectionFootnoteLine¦null	The properties of the footnote line for a section. Null indicates the property is inherited from the document.	required
prefix	string¦null	Prefix for each footnote.	required, Maximum length: 10
restartsAt	FootnoteRestartsAt¦null	The restart strategy for footnote numbering.	required
sequenceStarts	integer¦null	The number that footnotes will start counting from.	required, Maximum: 100000, Minimum: 1
style	FootnoteStyle¦null	The style of footnote numbering.	required
suffix	string¦null	Suffix for each footnote.	required, Maximum length: 10

Example

{
  "line": {
    "color": {
      "alpha": 100,
      "blue": 128,
      "green": 128,
      "red": 128
    },
    "enabled": true,
    "length": 144,
    "style": "single",
    "weight": 0.25
  },
  "prefix": "string",
  "restartsAt": "continuous",
  "sequenceStarts": 1,
  "style": "numeric",
  "suffix": "string"
}

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
        },
        "footnotes": {
          "line": {
            "color": {
              "alpha": 100,
              "blue": 0,
              "green": 0,
              "red": 0
            },
            "enabled": true,
            "length": 180,
            "style": "single",
            "weight": 1
          },
          "prefix": "",
          "restartsAt": "continuous",
          "sequenceStarts": 1,
          "style": "numeric",
          "suffix": ""
        },
        "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
        },
        "footnotes": {
          "line": {
            "color": {
              "alpha": 100,
              "blue": 0,
              "green": 0,
              "red": 0
            },
            "enabled": true,
            "length": 180,
            "style": "single",
            "weight": 1
          },
          "prefix": "",
          "restartsAt": "continuous",
          "sequenceStarts": 1,
          "style": "numeric",
          "suffix": ""
        },
        "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
footnotes	SectionFootnoteProperties	The footnote properties for a section. Null indicates the property is inherited from the document.
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
  },
  "footnotes": {
    "line": {
      "color": {
        "alpha": 100,
        "blue": 0,
        "green": 0,
        "red": 0
      },
      "enabled": true,
      "length": 180,
      "style": "single",
      "weight": 1
    },
    "prefix": "",
    "restartsAt": "continuous",
    "sequenceStarts": 1,
    "style": "numeric",
    "suffix": ""
  },
  "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"
]