Coda

List automation rules in a Coda document. Automations are rules that automatically perform actions based on triggers. Args: - docId: Document ID (required) - limit: Number of automations to return - pageToken: Pagination token Returns: Paginated list of automation rules with their names, triggers, and enabled status.

Trigger a webhook-enabled automation rule. Only automations with webhook triggers can be triggered via API. Args: - docId: Document ID (required) - ruleId: Automation rule ID (required) - message: Optional message payload to pass to the automation Returns: Request ID for tracking the automation execution.

List controls in a Coda document. Controls are interactive elements like buttons, sliders, checkboxes, date pickers, etc. Args: - docId: Document ID (required) - limit: Number of controls to return - pageToken: Pagination token Returns: Paginated list of controls with their types and current values.

Get the current value of a control. Args: - docId: Document ID - controlIdOrName: Control ID or name Returns: Control details including name, type, and current value.

Get details for a specific table or view. Args: - docId: Document ID - tableIdOrName: Table ID or name Returns: Table details including type, row count, columns, layout, sorts, and filters.

List Coda documents accessible to the user. Args: - isOwner: Filter to docs owned by the user - query: Search query string - isPublished: Filter to published docs - isStarred: Filter to starred docs - workspaceId: Filter by workspace - folderId: Filter by folder - limit: Number of docs to return (default: 20) - pageToken: Pagination token from previous response Returns: Paginated list of documents with ID, name, owner, workspace, and timestamps.

Get details for a specific Coda document. Args: - docId: The document ID Returns: Document details including name, owner, workspace, folder, size, and timestamps.

Create a new Coda document. Args: - title: Document title (required) - sourceDoc: ID of doc to copy from - timezone: Timezone for the doc (e.g., 'America/Los_Angeles') - folderId: Folder to create the doc in Returns: The created document.

Delete a Coda document. Args: - docId: Document ID to delete Returns: Confirmation of deletion.

List named formulas in a Coda document. Named formulas are reusable formulas defined in a doc that can be referenced elsewhere. Args: - docId: Document ID (required) - limit: Number of formulas to return - pageToken: Pagination token Returns: Paginated list of formulas with their names and current values.

Get the current value of a named formula. Args: - docId: Document ID - formulaIdOrName: Formula ID or name Returns: Formula details including name and current computed value.

List pages in a Coda document. Args: - docId: Document ID (required) - limit: Number of pages to return - pageToken: Pagination token Returns: Paginated list of pages with their hierarchy, names, and subtitles.

Get details for a specific page. Args: - docId: Document ID - pageIdOrName: Page ID or name Returns: Page details including name, subtitle, icon, parent, and children.

Create a new page in a Coda document. Args: - docId: Document ID (required) - name: Page name (required) - subtitle: Page subtitle - iconName: Icon name for the page - imageUrl: Cover image URL - parentPageIdOrName: Parent page ID or name - pageContent: Initial content (markdown or HTML) - contentFormat: Format of pageContent ('markdown' or 'html') Returns: The created page.

Update an existing page. Args: - docId: Document ID - pageIdOrName: Page ID or name to update - name: New page name - subtitle: New subtitle - iconName: New icon name - imageUrl: New cover image URL - isHidden: Whether the page should be hidden - contentUpdate: New content to append or replace - contentFormat: Format of content ('markdown' or 'html') - insertionMode: How to insert content ('append' or 'replace') Returns: The updated page.

Get sharing metadata for a document. Returns information about what sharing actions are allowed for this doc. Args: - docId: Document ID (required) Returns: Metadata about sharing capabilities (canShare, canCopy, etc.).

List permissions for a document. Shows who has access to the document and their access levels. Args: - docId: Document ID (required) - limit: Number of permissions to return - pageToken: Pagination token Returns: Paginated list of permissions with principals and access levels.

Add a permission to a document. Grants access to a user, domain, or anyone. Args: - docId: Document ID (required) - access: Access level ('readonly', 'write', 'comment', 'none') - principalType: Type of principal ('email', 'domain', 'anyone') - email: Email address (required if principalType is 'email') - domain: Domain name (required if principalType is 'domain') - suppressEmail: Don't send notification email Returns: The created permission.

Remove a permission from a document. Args: - docId: Document ID - permissionId: Permission ID to remove Returns: Confirmation of deletion.

Get ACL settings for a document. Returns sharing configuration options for the document. Args: - docId: Document ID Returns: ACL settings including editor permissions and copying settings.

Update ACL settings for a document. Args: - docId: Document ID - allowEditorsToChangePermissions: Allow editors to manage permissions - allowCopying: Allow users to copy the doc - allowViewersToRequestEditing: Allow viewers to request edit access Returns: The updated ACL settings.

List available publishing categories. Categories are used when publishing docs to the Coda gallery. Returns: List of category names.

Publish a document to make it publicly accessible. Args: - docId: Document ID (required) - slug: Custom URL slug for the published doc - discoverable: Make the doc discoverable in the gallery - earnCredit: Earn Coda credits when others copy the doc - categoryNames: Categories for the published doc - mode: Publishing mode ('view', 'play', 'edit') Returns: Confirmation of publication.

Unpublish a document. Makes a previously published document private again. Args: - docId: Document ID Returns: Confirmation of unpublication.

List rows in a table. Args: - docId: Document ID (required) - tableIdOrName: Table ID or name (required) - query: Filter rows using a query (e.g., "Status:Active") - sortBy: Column ID or name to sort by (prefix with '-' for descending) - useColumnNames: Use column names instead of IDs in response - valueFormat: Value format ('simple', 'simpleWithArrays', 'rich') - visibleOnly: Only return visible rows - limit: Number of rows to return - pageToken: Pagination token Returns: Paginated list of rows with their values.

Get a single row from a table. Args: - docId: Document ID - tableIdOrName: Table ID or name - rowIdOrName: Row ID or name (display column value) - useColumnNames: Use column names instead of IDs Returns: Row details with all column values.

Insert or upsert rows into a table. When keyColumns is provided, rows matching the key columns will be updated instead of inserted. Args: - docId: Document ID (required) - tableIdOrName: Table ID or name (required) - rows: Array of rows to insert/upsert. Each row has cells: [{ column: 'ColName', value: 'Value' }] - keyColumns: Column names/IDs to use for upsert matching - disableParsing: Disable Coda's value parsing Returns: The request ID and list of added/updated row IDs.

Update a single row in a table. Args: - docId: Document ID (required) - tableIdOrName: Table ID or name (required) - rowIdOrName: Row ID or name to update (required) - cells: Array of cells to update: [{ column: 'ColName', value: 'NewValue' }] - disableParsing: Disable Coda's value parsing Returns: The request ID and row ID.

Delete a single row from a table. Args: - docId: Document ID - tableIdOrName: Table ID or name - rowIdOrName: Row ID or name to delete Returns: The request ID and deleted row ID.

Delete multiple rows from a table. Args: - docId: Document ID - tableIdOrName: Table ID or name - rowIds: Array of row IDs to delete Returns: The request ID and list of deleted row IDs.

Push a button in a table row. Args: - docId: Document ID - tableIdOrName: Table ID or name - rowIdOrName: Row ID or name - columnIdOrName: Button column ID or name Returns: The request ID and confirmation.

List tables and views in a Coda document. Args: - docId: Document ID (required) - tableTypes: Filter by type ('table', 'view', or both) - sortBy: Sort by 'name', 'createdAt', or 'updatedAt' - limit: Number of tables to return - pageToken: Pagination token Returns: Paginated list of tables with their type, row count, layout, and timestamps.

List columns in a table. Args: - docId: Document ID - tableIdOrName: Table ID or name - limit: Number of columns to return - pageToken: Pagination token Returns: Paginated list of columns with their ID, name, type, and format details.

Get details for a specific column. Args: - docId: Document ID - tableIdOrName: Table ID or name - columnIdOrName: Column ID or name Returns: Column details including name, type, format, formula (if calculated), and default value.

Get information about the current authenticated user. Returns: User information including name, login ID, and workspace details.

Resolve a Coda URL to get metadata about the referenced object. Converts a browser URL to API resource information. Args: - url: The Coda URL to resolve (e.g., https://coda.io/d/...) - degradeGracefully: If true, resolves to the next-available parent object if the exact object is deleted Returns: Resource information including type, ID, and href.

Check the status of an asynchronous mutation. Many write operations return a request ID and complete asynchronously. Use this to check if a mutation has finished processing. Args: - requestId: The request ID from a mutation response Returns: Mutation status including whether it's completed and any warnings.