The Coda connector lets your AI agent act in each user's Coda account. Each user connects their own Coda access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 37 tools.
- Tools
- 37
- What they doRead · write · destructive
- 26 · 11 · 026 read11 write0 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Coda connection
In AgentKit > Connections, create a Coda connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'coda'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Coda:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'coda_current_user_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "coda"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Coda:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="coda_current_user_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Coda credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcoda_browser_link_resolveTurn a Coda URL copied from the browser into the object it points to (a doc, page, table, row and so on).Read-onlyResolve Browser Link
Turn a Coda URL copied from the browser into the object it points to (a doc, page, table, row and so on). Returns the object's type, id, name, API link and browser link. Use coda_browser_link_resolve when the user gives you a Coda URL and you need IDs for other tools. Use coda_docs_list to find a doc by name instead.
Inputs
urlstringrequired- Coda URL copied from the browser. Example: https://coda.io/d/Launch-Status_dAbCDeFGH/Launch-Status_sumnO.
degrade_gracefullyboolean- If true and the linked object was deleted, resolve the nearest object that still exists, up to the doc itself, instead of returning an error. Defaults to false.
coda_column_getGet details about one column in a Coda table or view.Read-onlyGet Column
Get details about one column in a Coda table or view. Returns the column's id, name, whether it is the display column, whether it is calculated and its formula, default value, format (type and options), and parent table. Use coda_column_get for one column's type and settings. Use coda_columns_list to see all columns in a table.
Inputs
column_id_or_namestringrequired- ID of the column, e.g. c-tuVwxYz. Get it from coda_columns_list. A column name also works, but Coda discourages names because users can rename columns.
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
table_id_or_namestringrequired- ID of the table or view, e.g. grid-pqRst-U. Get it from coda_tables_list. A table name also works, but Coda discourages names because users can rename tables.
coda_columns_listList the columns of a table or view in a Coda doc.Read-onlyList Columns
List the columns of a table or view in a Coda doc. Returns a page of columns with each column's id, name, whether it is the display column, whether it is calculated (and its formula), default value and format, plus nextPageToken when more exist. Use coda_columns_list to find column IDs before reading or writing rows. Use coda_column_get for one column's details.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
table_id_or_namestringrequired- ID of the table or view, e.g. grid-pqRst-U. Get it from coda_tables_list. A table name also works, but Coda discourages names because users can rename tables.
limitinteger- Maximum number of results to return in one page. Defaults to 25. Maximum 100. Example: 10.default
25 page_tokenstring- Opaque token for the next page of results. Pass the nextPageToken value from the previous response; leave empty for the first page.
visible_onlyboolean- If true, return only visible columns. Applies to base tables only, not views. Defaults to false.
coda_control_getGet one control in a Coda doc, including its type and current value.Read-onlyGet Control
Get one control in a Coda doc, including its type and current value. Returns the control's id, name, parent page, control type (such as button, slider, select or date picker) and value. Use coda_control_get to read a control's current value. Use coda_controls_list to find the control ID.
Inputs
control_id_or_namestringrequired- ID of the control, e.g. ctrl-cDefGhij. Get it from coda_controls_list. A control name also works, but Coda discourages names because users can rename controls.
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
coda_controls_listList the controls (buttons, sliders, select lists, date pickers and other inputs) in a Coda doc.Read-onlyList Controls
List the controls (buttons, sliders, select lists, date pickers and other inputs) in a Coda doc. Returns a page of controls with each control's id, name and parent page, plus nextPageToken when more exist. Use coda_controls_list to find a control ID. Use coda_control_get to read a control's type and current value.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
limitinteger- Maximum number of results to return in one page. Defaults to 25. Example: 10.default
25 page_tokenstring- Opaque token for the next page of results. Pass the nextPageToken value from the previous response; leave empty for the first page.
sort_bystring- Sort order for the results. The only supported value is `name` (alphabetical). Leave empty for the default order.one of
name
coda_current_user_getGet the Coda user that the connected API token belongs to.Read-onlyGet Current User
Get the Coda user that the connected API token belongs to. Returns the user's name, email login, picture link, home workspace, the token's name, and whether the token is scoped (restricted to certain docs or to read-only access). Use coda_current_user_get to confirm which account is connected or to get the user's workspace ID for coda_folder_create or coda_docs_list.
Inputs
This tool takes no inputs.
coda_doc_acl_settings_getGet a Coda doc's doc-wide sharing settings.Read-onlyGet Doc ACL Settings
Get a Coda doc's doc-wide sharing settings. Returns whether editors can change permissions, whether viewers can copy the doc, and whether viewers can request editing access. Use coda_doc_acl_settings_get for doc-wide sharing rules. Use coda_doc_permissions_list for the individual people and groups with access.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
coda_doc_getGet metadata for one Coda doc by its ID.Read-onlyGet Doc
Get metadata for one Coda doc by its ID. Returns the doc's id, name, owner, browser link, icon, created and updated times, folder, workspace, publishing settings, and size counts (pages, tables, rows). Use coda_doc_get when you already have a doc ID. Use coda_docs_list to find a doc by name or browse the docs you can access.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
coda_doc_permissions_listList who a Coda doc is shared with and at what access level.Read-onlyList Doc Permissions
List who a Coda doc is shared with and at what access level. Returns a page of permissions with each permission's id, principal (an email, group, domain, workspace or anyone) and access (readonly, comment or write), plus nextPageToken when more exist. Use coda_doc_permissions_list to audit a doc's sharing. Use coda_doc_acl_settings_get for doc-wide sharing settings, or coda_doc_sharing_metadata_get for what the user is allowed to share.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
limitinteger- Maximum number of results to return in one page. Defaults to 25. Example: 10.default
25 page_tokenstring- Opaque token for the next page of results. Pass the nextPageToken value from the previous response; leave empty for the first page.
coda_doc_principals_searchSearch for users and groups that a Coda doc can be shared with, by name or email.Read-onlySearch Doc Principals
Search for users and groups that a Coda doc can be shared with, by name or email. Returns up to 20 matching users (name, email login, picture) and up to 20 groups (id and name). Use coda_doc_principals_search to look up a person or group before sharing a doc. Use coda_doc_permissions_list to see who the doc is already shared with.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
querystringrequired- Name or email to search for. Example: jane or jane@example.com. An empty query returns no results.
coda_doc_sharing_metadata_getGet what the current user is allowed to do when sharing a Coda doc.Read-onlyGet Doc Sharing Metadata
Get what the current user is allowed to do when sharing a Coda doc. Returns booleans for whether the user can share the doc, share it with the workspace, share it with the organization, and copy it. Use coda_doc_sharing_metadata_get to check sharing rights before sharing. Use coda_doc_permissions_list to see who already has access.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
coda_docs_listList the Coda docs the user can access and has opened at least once, most recently used first, optionally filtered by owner, folder, workspace, starred or published state, or a search term.Read-onlyList Docs
List the Coda docs the user can access and has opened at least once, most recently used first, optionally filtered by owner, folder, workspace, starred or published state, or a search term. Returns a page of docs with each doc's id, name, owner, browser link, folder, workspace and created and updated times, plus nextPageToken when more results exist. Use coda_docs_list to browse or find a doc by name. Use coda_doc_get when you already have the doc ID, or coda_browser_link_resolve when you have a doc URL.
Inputs
folder_idstring- Return only docs in this folder. Folder IDs start with fl-, e.g. fl-1Ab234; get them from coda_folders_list.
in_galleryboolean- If true, return only docs visible in the Coda gallery.
is_ownerboolean- If true, return only docs the user owns.
is_publishedboolean- If true, return only published docs.
is_starredboolean- If true, return only starred docs; if false, only docs that are not starred. Leave empty for both.
limitinteger- Maximum number of results to return in one page. Defaults to 25. Example: 10.default
25 minimum_accessstring- Return only docs where the user has at least this access level: `readonly`, `comment`, or `write` (write covers editors and managers).one of
readonlycommentwrite page_tokenstring- Opaque token for the next page of results. Pass the nextPageToken value from the previous response; leave empty for the first page.
querystring- Search term matched against doc titles. Example: Roadmap.
source_docstring- Return only docs copied from this source doc ID. Example: AbCDeFGH.
workspace_idstring- Return only docs in this workspace. Workspace IDs start with ws-, e.g. ws-1Ab234; coda_current_user_get returns the user's workspace.
coda_folder_children_listList the direct subfolders of a Coda folder.Read-onlyList Folder Children
List the direct subfolders of a Coda folder. Returns a page of subfolders with each one's id, name, description, visibility, created time, edit permission, workspace and browser link, plus restrictedFolderIds for subfolders the user can't open, and nextPageToken when more exist. Use coda_folder_children_list to walk a folder tree. Use coda_docs_list with folder_id for the docs in a folder.
Inputs
folder_idstringrequired- ID of the folder, e.g. fl-1Ab234. Get it from coda_folders_list.
limitinteger- Maximum number of results to return in one page. Defaults to 25. Example: 10.default
25 page_tokenstring- Opaque token for the next page of results. Pass the nextPageToken value from the previous response; leave empty for the first page.
coda_folder_getGet details about one Coda folder.Read-onlyGet Folder
Get details about one Coda folder. Returns the folder's id, name, description, icon, icon color, created time, whether the user can edit it, workspace and browser link. Use coda_folder_get when you have a folder ID. Use coda_folders_list to find one, or coda_docs_list with folder_id for the docs inside it.
Inputs
folder_idstringrequired- ID of the folder, e.g. fl-1Ab234. Get it from coda_folders_list.
coda_folders_listList the Coda folders the user can access, optionally only those in one workspace or only starred ones.Read-onlyList Folders
List the Coda folders the user can access, optionally only those in one workspace or only starred ones. Returns a page of folders with each folder's id, name, description, icon, created time, edit permission, workspace and browser link, plus nextPageToken when more exist. Use coda_folders_list to find a folder ID. Use coda_folder_children_list for the subfolders of one folder, or coda_docs_list with folder_id for the docs in it.
Inputs
is_starredboolean- If true, return only starred folders; if false, only folders that are not starred. Leave empty for all.
limitinteger- Maximum number of results to return in one page. Defaults to 25. Example: 10.default
25 page_tokenstring- Opaque token for the next page of results. Pass the nextPageToken value from the previous response; leave empty for the first page.
workspace_idstring- Return only folders in this workspace, e.g. ws-1Ab234. coda_current_user_get returns the user's workspace.
coda_formula_getGet one named formula in a Coda doc, including its current computed value.Read-onlyGet Formula
Get one named formula in a Coda doc, including its current computed value. Returns the formula's id, name, parent page and value. Use coda_formula_get to read a formula's result. Use coda_formulas_list to find the formula ID.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
formula_id_or_namestringrequired- ID of the named formula, e.g. f-fgHijkLm. Get it from coda_formulas_list. A formula name also works, but Coda discourages names because users can rename formulas.
coda_formulas_listList the named formulas in a Coda doc.Read-onlyList Formulas
List the named formulas in a Coda doc. Returns a page of formulas with each formula's id, name and parent page, plus nextPageToken when more exist. Use coda_formulas_list to find a formula ID. Use coda_formula_get to read a formula's current value.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
limitinteger- Maximum number of results to return in one page. Defaults to 25. Example: 10.default
25 page_tokenstring- Opaque token for the next page of results. Pass the nextPageToken value from the previous response; leave empty for the first page.
sort_bystring- Sort order for the results. The only supported value is `name` (alphabetical). Leave empty for the default order.one of
name
coda_mutation_status_getCheck whether an asynchronous Coda write (such as a row insert, row update, page create or update, button push or automation trigger) has finished.Read-onlyGet Mutation Status
Check whether an asynchronous Coda write (such as a row insert, row update, page create or update, button push or automation trigger) has finished. Returns completed (true or false) and a warning message if the change only partly applied. Use coda_mutation_status_get with the requestId from a write tool. Status is kept for about a day after the change.
Inputs
request_idstringrequired- The requestId returned by a write tool such as coda_rows_upsert, coda_row_update, coda_page_create or coda_page_update.
coda_page_content_listRead the content of a page in a Coda doc as a list of content elements (paragraphs, headings, list items and so on) in plain text.Read-onlyList Page Content
Read the content of a page in a Coda doc as a list of content elements (paragraphs, headings, list items and so on) in plain text. Returns a page of elements with each element's id, type and text, plus nextPageToken when more content exists. Use coda_page_content_list to read a page's text directly. Use coda_page_export_begin to get the whole page as an HTML or Markdown file, or coda_page_get for page metadata only.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
page_id_or_namestringrequired- ID of the page, e.g. canvas-IjkLmnO. Get it from coda_pages_list. A page name also works, but Coda discourages names because users can rename pages, and duplicate names resolve to an arbitrary page.
content_formatstring- Format to return content in. The only supported value is `plainText` (default).one of
plainTextdefaultplainText limitinteger- Maximum number of results to return in one page. Defaults to 50. Maximum 500. Example: 10.default
50 page_tokenstring- Opaque token for the next page of results. Pass the nextPageToken value from the previous response; leave empty for the first page.
coda_page_export_status_getCheck the status of a page export started with coda_page_export_begin.Read-onlyGet Page Export Status
Check the status of a page export started with coda_page_export_begin. Returns the export id, status (inProgress, complete or failed), a downloadLink for the file once complete, and an error message if it failed. Use coda_page_export_status_get after coda_page_export_begin, repeating until the status is complete. The download link expires after a short time.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
page_id_or_namestringrequired- ID of the page, e.g. canvas-IjkLmnO. Get it from coda_pages_list. A page name also works, but Coda discourages names because users can rename pages, and duplicate names resolve to an arbitrary page.
request_idstringrequired- The requestId returned by coda_page_export_begin (its id field).
coda_page_getGet details about one page in a Coda doc.Read-onlyGet Page
Get details about one page in a Coda doc. Returns the page's id, name, subtitle, icon, cover image, content type, hidden state, parent and child pages, authors, created and updated times, and browser link. Use coda_page_get for a page's metadata. Use coda_page_content_list to read the page's text, or coda_page_export_begin to export it as HTML or Markdown.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
page_id_or_namestringrequired- ID of the page, e.g. canvas-IjkLmnO. Get it from coda_pages_list. A page name also works, but Coda discourages names because users can rename pages, and duplicate names resolve to an arbitrary page.
coda_pages_listList the pages in a Coda doc, including subpages.Read-onlyList Pages
List the pages in a Coda doc, including subpages. Returns a page of results with each page's id, name, subtitle, icon, content type, hidden state, parent and child pages, and browser link, plus nextPageToken when more pages exist. Use coda_pages_list to find a page ID. Use coda_page_get for one page's details, or coda_page_content_list to read the text on a page.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
limitinteger- Maximum number of results to return in one page. Defaults to 25. Example: 10.default
25 page_tokenstring- Opaque token for the next page of results. Pass the nextPageToken value from the previous response; leave empty for the first page.
coda_row_getGet one row from a Coda table or view.Read-onlyGet Row
Get one row from a Coda table or view. Returns the row's id, name, index, browser link, created and updated times, parent table, and cell values keyed by column ID (or name). Use coda_row_get when you already have a row ID. Use coda_rows_list to find rows or filter by a column value.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
row_id_or_namestringrequired- ID of the row, e.g. i-tuVwxYz. Get it from coda_rows_list. A row name (the value in the table's display column) also works, but if several rows share that value an arbitrary one is used.
table_id_or_namestringrequired- ID of the table or view, e.g. grid-pqRst-U. Get it from coda_tables_list. A table name also works, but Coda discourages names because users can rename tables.
use_column_namesboolean- If true, the row values are keyed by column name instead of column ID. Coda discourages this because names break when columns are renamed. Defaults to false.
value_formatstring- Format of the cell values in the response. `simple` (default) returns strings, numbers and booleans, with multi-value cells as comma-separated text; `simpleWithArrays` returns multi-value cells as JSON arrays; `rich` returns lossless structured values (Markdown text, currency and date objects, linked-row references).one of
simplesimpleWithArraysrich
coda_rows_listList rows in a Coda table or view, optionally filtered by a column value and sorted by creation, update or natural order.Read-onlyList Rows
List rows in a Coda table or view, optionally filtered by a column value and sorted by creation, update or natural order. Returns a page of rows with each row's id, name, index, browser link, created and updated times, and cell values keyed by column ID (or name), plus nextPageToken and nextSyncToken. Use coda_rows_list to read or search table data. Use coda_row_get when you already have a row ID.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
table_id_or_namestringrequired- ID of the table or view, e.g. grid-pqRst-U. Get it from coda_tables_list. A table name also works, but Coda discourages names because users can rename tables.
limitinteger- Maximum number of results to return in one page. Defaults to 25. Example: 10.default
25 page_tokenstring- Opaque token for the next page of results. Pass the nextPageToken value from the previous response; leave empty for the first page.
querystring- Filter rows by one column value, written as <column_id_or_name>:<json value>. Column names must be in double quotes and string values must be JSON-quoted. Examples: c-tuVwxYz:"Apple" or "Status":"Done" or c-AbCd:42.
sort_bystring- Row order: `createdAt` (default, oldest first), `natural` (the order shown in the table or view in the UI), or `updatedAt` (by last value change).one of
createdAtnaturalupdatedAt sync_tokenstring- nextSyncToken from a previous full listing. Pass it to get only rows changed since that call.
use_column_namesboolean- If true, the row values are keyed by column name instead of column ID. Coda discourages this because names break when columns are renamed. Defaults to false.
value_formatstring- Format of the cell values in the response. `simple` (default) returns strings, numbers and booleans, with multi-value cells as comma-separated text; `simpleWithArrays` returns multi-value cells as JSON arrays; `rich` returns lossless structured values (Markdown text, currency and date objects, linked-row references).one of
simplesimpleWithArraysrich visible_onlyboolean- If true, return only visible rows and columns. Defaults to false.
coda_table_getGet details about one table or view in a Coda doc.Read-onlyGet Table
Get details about one table or view in a Coda doc. Returns the table's id, name, type, parent page, parent table (for views), display column, row count, sorts, layout, filter info, created and updated times, and browser link. Use coda_table_get for a table's metadata. Use coda_columns_list for its columns, or coda_rows_list for its rows.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
table_id_or_namestringrequired- ID of the table or view, e.g. grid-pqRst-U. Get it from coda_tables_list. A table name also works, but Coda discourages names because users can rename tables.
use_updated_table_layoutsboolean- If true, the layout field reports `detail` and `form` for detail and form layouts instead of `masterDetail` for both. Defaults to false.
coda_tables_listList the tables and views in a Coda doc.Read-onlyList Tables
List the tables and views in a Coda doc. Returns a page of results with each table's id, name, type (table or view), parent page and browser link, plus nextPageToken when more exist. Use coda_tables_list to find a table ID. Use coda_table_get for one table's details such as row count and display column, or coda_rows_list to read its rows.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
limitinteger- Maximum number of results to return in one page. Defaults to 25. Example: 10.default
25 page_tokenstring- Opaque token for the next page of results. Pass the nextPageToken value from the previous response; leave empty for the first page.
sort_bystring- Sort order for the results. The only supported value is `name` (alphabetical). Leave empty for the default order.one of
name table_typesstring- Comma-separated list of table types to include: `table`, `view`. Leave empty to include both. Example: table.
coda_automation_triggerRun a Coda doc automation whose trigger is set to "Webhook invoked", optionally passing a JSON payload the automation can read.WriteTrigger Automation
Run a Coda doc automation whose trigger is set to "Webhook invoked", optionally passing a JSON payload the automation can read. Returns a requestId; the automation runs asynchronously, so check coda_mutation_status_get with the requestId if you need to confirm. Use coda_automation_trigger to run a webhook-invoked automation. Use coda_row_button_push to press a button in a table row instead. The automation must already exist with a Webhook invoked trigger; its rule ID is shown in the automation's settings.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
rule_idstringrequired- ID of the automation rule to run, e.g. grid-auto-b3Jmey6jBS. It appears in the doc's automation settings when the rule's trigger is "Webhook invoked".
payloadobject- JSON object to send to the automation. The automation can read it through Step 1 Result. Leave empty to send an empty object. Example: {"customer": "Acme", "amount": 120}.
coda_doc_createCreate a new Coda doc, either blank or as a copy of an existing doc, optionally in a given folder and with a first page of content.WriteCreate Doc
Create a new Coda doc, either blank or as a copy of an existing doc, optionally in a given folder and with a first page of content. Returns the new doc's id, name, browser link, owner, folder, workspace and created time. Use coda_doc_create to start a new doc. Use coda_page_create to add a page to a doc that already exists. The user must be a Doc Maker in the target workspace.
Inputs
folder_idstring- ID of the folder to create the doc in, e.g. fl-1Ab234 (from coda_folders_list). Defaults to the user's personal folder.
initial_page_contentstring- Content for the doc's first page, written in the format chosen in initial_page_content_format. Ignored when copying a source doc. Example: # Goals\n- Ship v2.
initial_page_content_formatstring- Format of initial_page_content: `markdown` (default) or `html`.one of
markdownhtmldefaultmarkdown initial_page_namestring- Name of the doc's first page. Ignored when copying a source doc. Example: Overview.
source_docstring- ID of an existing doc to copy. Leave empty to create a blank doc. Example: AbCDeFGH.
timezonestring- IANA time zone for the doc, used for date and time formulas. Example: America/Los_Angeles.
titlestring- Title of the new doc. Example: Q3 Planning.
coda_doc_updateRename a Coda doc or change its icon.WriteUpdate Doc
Rename a Coda doc or change its icon. Returns an empty object on success. Use coda_doc_update to change doc-level metadata. Use coda_page_update to change a page's name or content. Changing the title requires Doc Maker rights in the doc's workspace.
- Idempotent
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
icon_namestring- Name of a Coda icon to set on the doc, e.g. rocket. Leave empty to keep the current icon.
titlestring- New title for the doc. Leave empty to keep the current title. Example: Q3 Planning (final).
coda_folder_createCreate a new folder in a Coda workspace.WriteCreate Folder
Create a new folder in a Coda workspace. Returns the new folder's id, name, description, created time, workspace and browser link. Use coda_folder_create to add a folder. Use coda_folder_update to rename an existing one.
Inputs
namestringrequired- Name of the new folder. Example: Marketing.
workspace_idstringrequired- ID of the workspace to create the folder in, e.g. ws-1Ab234. coda_current_user_get returns the user's workspace.
descriptionstring- Description of the folder. Example: Campaign plans and briefs.
coda_folder_updateRename a Coda folder or change its description.WriteUpdate Folder
Rename a Coda folder or change its description. Returns the updated folder's id, name, description, workspace and browser link. Use coda_folder_update to change a folder's name or description. Use coda_folder_create to add a new folder.
- Idempotent
Inputs
folder_idstringrequired- ID of the folder, e.g. fl-1Ab234. Get it from coda_folders_list.
descriptionstring- New description for the folder. Leave empty to keep it.
namestring- New name for the folder. Leave empty to keep it. Example: Marketing 2026.
coda_page_createCreate a new page in a Coda doc, either a canvas page with Markdown or HTML content or a page that embeds an external URL, optionally as a subpage of another page.WriteCreate Page
Create a new page in a Coda doc, either a canvas page with Markdown or HTML content or a page that embeds an external URL, optionally as a subpage of another page. Returns the new page's id and a requestId; the page is created asynchronously, so check coda_mutation_status_get with the requestId if you need to confirm it. Use coda_page_create to add a page to an existing doc. Use coda_page_update to change or add content on an existing page, or coda_doc_create to start a new doc. The user must be a Doc Maker in the doc's workspace.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
contentstring- Content for a canvas page, written in the format chosen in content_format. Ignored for embed pages. Example: # Agenda\n- Review metrics.
content_formatstring- Format of content: `markdown` (default) or `html`.one of
markdownhtmldefaultmarkdown embed_render_methodstring- How to render the embed: `standard` or `compatibility` (use compatibility if the site doesn't display in standard mode). Only for embed pages.one of
standardcompatibility embed_urlstring- URL to embed. Required when page_type is `embed`. Example: https://example.com/dashboard.
icon_namestring- Name of a Coda icon for the page, e.g. notes.
image_urlstring- URL of a cover image for the page. Example: https://example.com/cover.png.
namestring- Name of the new page. Example: Meeting Notes.
page_typestring- Kind of page to create: `canvas` (default) for a normal page with content, or `embed` for a page that shows an external URL (set embed_url).one of
canvasembeddefaultcanvas parent_page_idstring- ID of an existing page to nest the new page under, e.g. canvas-IjkLmnO (from coda_pages_list). Leave empty for a top-level page.
subtitlestring- Subtitle shown under the page name. Example: Weekly sync notes.
coda_page_export_beginStart exporting a Coda page's content as an HTML or Markdown file.WriteBegin Page Export
Start exporting a Coda page's content as an HTML or Markdown file. Returns an export request id and its status; the export runs asynchronously. Use coda_page_export_begin to get a page as a file. Then call coda_page_export_status_get with the returned id until the status is complete and a downloadLink is present. Use coda_page_content_list to read page text directly instead.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
output_formatstringrequired- File format for the export: `markdown` or `html`.one of
markdownhtml page_id_or_namestringrequired- ID of the page, e.g. canvas-IjkLmnO. Get it from coda_pages_list. A page name also works, but Coda discourages names because users can rename pages, and duplicate names resolve to an arbitrary page.
coda_page_updateUpdate a page in a Coda doc: rename it, change its subtitle, icon, cover image or hidden state, and append, prepend or replace its content with Markdown or HTML.WriteUpdate Page
Update a page in a Coda doc: rename it, change its subtitle, icon, cover image or hidden state, and append, prepend or replace its content with Markdown or HTML. Returns the page id and a requestId; the update is applied asynchronously, so check coda_mutation_status_get with the requestId if you need to confirm it. Use coda_page_update to edit an existing page. Use coda_page_create to add a new page, or coda_doc_update to rename the doc itself. Changing the page name or icon requires Doc Maker rights in the doc's workspace.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
page_id_or_namestringrequired- ID of the page, e.g. canvas-IjkLmnO. Get it from coda_pages_list. A page name also works, but Coda discourages names because users can rename pages, and duplicate names resolve to an arbitrary page.
contentstring- New content to write to the page, in the format chosen in content_format. Leave empty to leave the content unchanged. Example: ## Action items\n- Send recap.
content_formatstring- Format of content: `markdown` (default) or `html`.one of
markdownhtmldefaultmarkdown element_idstring- ID of a content element on the page (from coda_page_content_list) to insert relative to, instead of the start or end of the page. Only used when content is set.
icon_namestring- Name of a Coda icon to set on the page, e.g. notes. Leave empty to keep it.
image_urlstring- URL of a new cover image for the page. Leave empty to keep it.
insertion_modestring- Where to put the new content: `append` (default) adds it at the end, `prepend` at the start, and `replace` overwrites the existing page content. Only used when content is set.one of
appendprependreplacedefaultappend is_hiddenboolean- Set true to hide the page from the doc's page list, false to show it. Leave empty to keep the current state.
namestring- New name for the page. Leave empty to keep it. Example: Meeting Notes (archived).
subtitlestring- New subtitle for the page. Leave empty to keep it.
coda_row_updateUpdate cell values in one existing row of a Coda table.WriteUpdate Row
Update cell values in one existing row of a Coda table. Returns the row id and a requestId; the update is applied asynchronously within a few seconds, so check coda_mutation_status_get with the requestId if you need to confirm. Use coda_row_update to change a known row by ID. Use coda_rows_upsert to add rows or update rows matched by key columns. Get column IDs from coda_columns_list and the row ID from coda_rows_list.
- Idempotent
Inputs
cellsarrayrequired- Cells to change. Each cell names a column (ID preferred, or name) and its new value: text, a number, a boolean, or a list for multi-select columns. Cells you leave out are unchanged. Example: [{"column": "c-tuVwxYz", "value": "Done"}].
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
row_id_or_namestringrequired- ID of the row, e.g. i-tuVwxYz. Get it from coda_rows_list. A row name (the value in the table's display column) also works, but if several rows share that value an arbitrary one is used.
table_id_or_namestringrequired- ID of the table or view, e.g. grid-pqRst-U. Get it from coda_tables_list. A table name also works, but Coda discourages names because users can rename tables.
disable_parsingboolean- If true, Coda stores the values exactly as sent and does not try to parse them (for example, it won't turn "$5" into a currency or "2024-01-15" into a date). Defaults to false.
coda_rows_upsertAdd one or more rows to a Coda base table, or update matching rows instead when key columns are given (upsert).WriteInsert or Upsert Rows
Add one or more rows to a Coda base table, or update matching rows instead when key columns are given (upsert). Returns a requestId and the IDs of added rows; rows are written asynchronously within a few seconds, so check coda_mutation_status_get with the requestId if you need to confirm. Use coda_rows_upsert to add rows or upsert by key. Use coda_row_update to change one known row by its ID. Works on base tables only, not views. Get column IDs from coda_columns_list.
Inputs
doc_idstringrequired- ID of the Coda doc. Get it from coda_docs_list, or from the doc's URL: it is the part after `_d` in a link like https://coda.io/d/Project-Tracker_dAbCDeFGH (here AbCDeFGH).
rowsarrayrequired- Rows to insert. Each row has a cells list, and each cell names a column (ID preferred, or name) and the value to put in it. Values can be text, numbers, booleans, or lists for multi-select columns. Example: [{"cells": [{"column": "c-tuVwxYz", "value": "Apple"}, {"column": "c-AbCdEfG", "value": 3}]}].
table_id_or_namestringrequired- ID of the table or view, e.g. grid-pqRst-U. Get it from coda_tables_list. A table name also works, but Coda discourages names because users can rename tables.
disable_parsingboolean- If true, Coda stores the values exactly as sent and does not try to parse them (for example, it won't turn "$5" into a currency or "2024-01-15" into a date). Defaults to false.
key_columnsarray- Column IDs (or names) that identify a row for upserting. When set, an incoming row whose values in these columns match an existing row updates that row (every matching row, if several match) instead of adding a new one. Leave empty to always insert. Example: ["c-tuVwxYz"].
No tools match.
