/coda-documents | Type: Application | PCID required: Yes
Tools
coda_documents_add_go_link
Add a go link Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
organizationId | string | Yes | — | ID of the organization. |
creatorEmail | string | No | — | Optional creator email for the Go Link. Only organization admins can set this field. |
description | string | No | — | Optional description for the Go Link. |
destinationUrl | string | Yes | — | The URL that the Go Link redirects to. |
name | string | Yes | — | The name of the Go Link that comes after go/. Only alphanumeric characters, dashes, and underscores are allowed. |
urlPattern | string | No | — | Optional destination URL with {*} placeholders for variables to be inserted. Variables are specified like go/<name>/<var1>/<var2>. |
coda_documents_add_permission
Add permission Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
access | string | Yes | — | Type of access (excluding none). |
principal | object | Yes | — | Metadata about a principal to add to a doc. |
suppressEmail | boolean | No | — | When true suppresses email notification |
coda_documents_begin_page_content_export
Begin content export Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
pageIdOrName | string | Yes | — | ID or name of the page. Names are discouraged because they’re easily prone to being changed by users. If you’re using a name, be sure to URI-encode it. If you provide a name and there are multiple pages with the same name, an arbitrary one will be selected. |
outputFormat | string | Yes | — | Supported output content formats that can be requested for getting content for an existing page. |
coda_documents_create_doc
Create doc Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
folderId | string | No | — | The ID of the folder within which to create this doc. Defaults to your “My docs” folder in the oldest workspace you joined; this is subject to change. You can get this ID by opening the folder in the docs list on your computer and grabbing the folderId query parameter. |
initialPage | object | No | — | Initial Page |
sourceDoc | string | No | — | An optional doc ID from which to create a copy. |
timezone | string | No | — | The timezone to use for the newly created doc. |
title | string | No | — | Title of the new doc. Defaults to ‘Untitled’. |
coda_documents_create_folder
Create folder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
description | string | No | — | Description of the folder. |
name | string | Yes | — | Name of the folder. |
workspaceId | string | Yes | — | ID of the workspace where the folder should be created. |
coda_documents_create_page
Create a page Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
iconName | string | No | — | Name of the icon. |
imageUrl | string | No | — | Url of the cover image to use. |
name | string | No | — | Name of the page. |
pageContent | object | No | — | Content that can be added to a page at creation time, either text (or rich text) or a URL to create a full-page embed. |
parentPageId | string | No | — | The ID of this new page’s parent, if creating a subpage. |
subtitle | string | No | — | Subtitle of the page. |
coda_documents_delete_doc
Delete doc Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
coda_documents_delete_folder
Delete folder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
folderId | string | Yes | — | ID of the folder. |
coda_documents_delete_page
Delete a page Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
pageIdOrName | string | Yes | — | ID or name of the page. Names are discouraged because they’re easily prone to being changed by users. If you’re using a name, be sure to URI-encode it. If you provide a name and there are multiple pages with the same name, an arbitrary one will be selected. |
coda_documents_delete_page_content
Delete page content Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
pageIdOrName | string | Yes | — | ID or name of the page. Names are discouraged because they’re easily prone to being changed by users. If you’re using a name, be sure to URI-encode it. If you provide a name and there are multiple pages with the same name, an arbitrary one will be selected. |
elementIds | string[] | No | — | IDs of the elements to delete from the page. If omitted or empty, all content will be deleted. |
coda_documents_delete_permission
Delete permission Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
permissionId | string | Yes | — | ID of a permission on a doc. |
coda_documents_get_acl_settings
Get ACL settings Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
coda_documents_get_doc
Get info about a doc Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
coda_documents_get_folder
Get folder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
folderId | string | Yes | — | ID of the folder. |
coda_documents_get_mutation_status
Get mutation status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
requestId | string | Yes | — | ID of the request. |
coda_documents_get_page
Get a page Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
pageIdOrName | string | Yes | — | ID or name of the page. Names are discouraged because they’re easily prone to being changed by users. If you’re using a name, be sure to URI-encode it. If you provide a name and there are multiple pages with the same name, an arbitrary one will be selected. |
coda_documents_get_page_content_export_status
Content export status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
pageIdOrName | string | Yes | — | ID or name of the page. Names are discouraged because they’re easily prone to being changed by users. If you’re using a name, be sure to URI-encode it. If you provide a name and there are multiple pages with the same name, an arbitrary one will be selected. |
requestId | string | Yes | — | ID of the request. |
coda_documents_get_permissions
List permissions Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
limit | integer | No | — | Maximum number of results to return in this query. |
pageToken | string | No | — | An opaque token used to fetch the next page of results. |
coda_documents_get_sharing_metadata
Get sharing metadata Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
coda_documents_list_docs
List available docs Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
isOwner | boolean | No | — | Show only docs owned by the user. |
isPublished | boolean | No | — | Show only published docs. |
query | string | No | — | Search term used to filter down results. |
sourceDoc | string | No | — | Show only docs copied from the specified doc ID. |
isStarred | boolean | No | — | If true, returns docs that are starred. If false, returns docs that are not starred. |
inGallery | boolean | No | — | Show only docs visible within the gallery. |
workspaceId | string | No | — | Show only docs belonging to the given workspace. |
folderId | string | No | — | Show only docs belonging to the given folder. |
limit | integer | No | — | Maximum number of results to return in this query. |
pageToken | string | No | — | An opaque token used to fetch the next page of results. |
coda_documents_list_folders
List folders Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Show only folders belonging to the given workspace. |
isStarred | boolean | No | — | If true, returns folders that are starred. If false, returns folders that are not starred. If not specified, returns all folders. |
limit | integer | No | — | Maximum number of results to return in this query. |
pageToken | string | No | — | An opaque token used to fetch the next page of results. |
coda_documents_list_page_content
List page content Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
pageIdOrName | string | Yes | — | ID or name of the page. Names are discouraged because they’re easily prone to being changed by users. If you’re using a name, be sure to URI-encode it. If you provide a name and there are multiple pages with the same name, an arbitrary one will be selected. |
limit | integer | No | — | Maximum number of content items to return in this query. |
pageToken | string | No | — | An opaque token used to fetch the next page of results. |
contentFormat | string | No | — | The format to return content in. Defaults to plainText. |
coda_documents_list_pages
List pages Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
limit | integer | No | — | Maximum number of results to return in this query. |
pageToken | string | No | — | An opaque token used to fetch the next page of results. |
coda_documents_publish_doc
Publish doc Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
categoryNames | string[] | No | — | The names of categories to apply to the document. |
discoverable | boolean | No | — | If true, indicates that the doc is discoverable. |
earnCredit | boolean | No | — | If true, new users may be required to sign in to view content within this document. You will receive Coda credit for each user who signs up via your doc. |
mode | string | No | — | Which interaction mode the published doc should use. |
slug | string | No | — | Slug for the published doc. |
coda_documents_resolve_browser_link
Resolve browser link Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
url | string | Yes | — | The browser link to try to resolve. |
degradeGracefully | boolean | No | — | By default, attempting to resolve the Coda URL of a deleted object will result in an error. If this flag is set, the next-available object, all the way up to the doc itself, will be resolved. |
coda_documents_search_principals
Search principals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
query | string | No | — | Search term used to filter down results. |
coda_documents_unpublish_doc
Unpublish doc Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
coda_documents_update_acl_settings
Update ACL settings Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
allowCopying | boolean | No | — | When true, allows doc viewers to copy the doc. |
allowEditorsToChangePermissions | boolean | No | — | When true, allows editors to change doc permissions. When false, only doc owner can change doc permissions. |
allowViewersToRequestEditing | boolean | No | — | When true, allows doc viewers to request editing permissions. |
coda_documents_update_doc
Update doc Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
iconName | string | No | — | Name of the icon. |
title | string | No | — | Title of the doc. |
coda_documents_update_folder
Update folder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
folderId | string | Yes | — | ID of the folder. |
description | string | No | — | Description of the folder. |
name | string | No | — | Name of the folder. |
coda_documents_update_page
Update a page Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
docId | string | Yes | — | ID of the doc. |
pageIdOrName | string | Yes | — | ID or name of the page. Names are discouraged because they’re easily prone to being changed by users. If you’re using a name, be sure to URI-encode it. If you provide a name and there are multiple pages with the same name, an arbitrary one will be selected. |
contentUpdate | object | No | — | Content Update |
iconName | string | No | — | Name of the icon. |
imageUrl | string | No | — | Url of the cover image to use. |
isHidden | boolean | No | — | Whether the page is hidden or not. Note that for pages that cannot be hidden, like the sole top-level page in a doc, this will be ignored. |
name | string | No | — | Name of the page. |
subtitle | string | No | — | Subtitle of the page. |

