Coda

Coda is a collaborative all-in-one productivity tool that combines documents, spreadsheets, apps, and databases into a single platform.

Categories: Productivity and Collaboration

Type: coda/v1

Connections

Version: 1

Bearer Token

Properties

Name	Label	Type	Description	Required
token	Token	STRING		true

Actions

List Docs

Name: listDocs

Returns a list of docs accessible by the user, and which they have opened at least once.

Properties

Name	Label	Type	Description	Required
isOwner	Is Owner	BOOLEAN Options true, false	Show only docs owned by the user.	false
isPublished	Is Published	BOOLEAN Options true, false	Show only published docs.	false
limit	Limit	INTEGER	Maximum number of results to return in this query.	false

Example JSON Structure

{
  "label" : "List Docs",
  "name" : "listDocs",
  "parameters" : {
    "isOwner" : false,
    "isPublished" : false,
    "limit" : 1
  },
  "type" : "coda/v1/listDocs"
}

Properties

Name	Type	Description
items	ARRAY Items [{STRING(id), STRING(type), STRING(href), STRING(browserLink), STRING(name), STRING(owner), STRING(ownerName), STRING(createdAt), STRING(updatedAt), {STRING(name), STRING(type), STRING(browserLink)}(icon), {NUMBER(totalRowCount), NUMBER(tableAndViewCount), NUMBER(pageCount), BOOLEAN(overApiSizeLimit)}(docSize), {STRING(id), STRING(type), STRING(href), STRING(browserLink)}(sourceDoc), STRING(workspaceId), STRING(folderId), {STRING(id), STRING(type), STRING(browserLink), STRING(name)}(workspace), {STRING(id), STRING(type), STRING(browserLink), STRING(name)}(folder)}]
href	STRING	API link to these results.

Output Example

{
  "items" : [ {
    "id" : "",
    "type" : "",
    "href" : "",
    "browserLink" : "",
    "name" : "",
    "owner" : "",
    "ownerName" : "",
    "createdAt" : "",
    "updatedAt" : "",
    "icon" : {
      "name" : "",
      "type" : "",
      "browserLink" : ""
    },
    "docSize" : {
      "totalRowCount" : 0.0,
      "tableAndViewCount" : 0.0,
      "pageCount" : 0.0,
      "overApiSizeLimit" : false
    },
    "sourceDoc" : {
      "id" : "",
      "type" : "",
      "href" : "",
      "browserLink" : ""
    },
    "workspaceId" : "",
    "folderId" : "",
    "workspace" : {
      "id" : "",
      "type" : "",
      "browserLink" : "",
      "name" : ""
    },
    "folder" : {
      "id" : "",
      "type" : "",
      "browserLink" : "",
      "name" : ""
    }
  } ],
  "href" : ""
}

Copy Doc

Name: copyDoc

Copies an existing doc.

Properties

Name	Label	Type	Description	Required
title	Title	STRING	Title of the new doc.	true
sourceDoc	Source Doc	STRING	A doc ID from which to create a copy.	true

Example JSON Structure

{
  "label" : "Copy Doc",
  "name" : "copyDoc",
  "parameters" : {
    "title" : "",
    "sourceDoc" : ""
  },
  "type" : "coda/v1/copyDoc"
}

Properties

Name	Type	Description
id	STRING	ID of the Coda doc.
type	STRING	The type of this resource.
href	STRING	API link to the Coda doc.
browserLink	STRING	Browser-friendly link to the Coda doc.
name	STRING	Name of the doc.
owner	STRING	Email address of the doc owner.
ownerName	STRING	Name of the doc owner.
createdAt	STRING	Timestamp for when the doc was created.
updatedAt	STRING	Timestamp for when the doc was last modified.
icon	OBJECT Properties {STRING(name), STRING(type), STRING(browserLink)}	Info about the icon.
sourceDoc	OBJECT Properties {STRING(id), STRING(type), STRING(href), STRING(browserLink)}	Reference to a Coda doc from which this doc was copied, if any.
workspaceId	STRING	ID of the Coda workspace containing this doc.
folderId	STRING	ID of the Coda folder containing this doc.
workspace	OBJECT Properties {STRING(id), STRING(type), STRING(browserLink), STRING(name)}	Reference to a Coda workspace.
folder	OBJECT Properties {STRING(id), STRING(type), STRING(browserLink), STRING(name)}	Reference to a Coda folder.
requestId	STRING	An arbitrary unique identifier for this request.

Output Example

{
  "id" : "",
  "type" : "",
  "href" : "",
  "browserLink" : "",
  "name" : "",
  "owner" : "",
  "ownerName" : "",
  "createdAt" : "",
  "updatedAt" : "",
  "icon" : {
    "name" : "",
    "type" : "",
    "browserLink" : ""
  },
  "sourceDoc" : {
    "id" : "",
    "type" : "",
    "href" : "",
    "browserLink" : ""
  },
  "workspaceId" : "",
  "folderId" : "",
  "workspace" : {
    "id" : "",
    "type" : "",
    "browserLink" : "",
    "name" : ""
  },
  "folder" : {
    "id" : "",
    "type" : "",
    "browserLink" : "",
    "name" : ""
  },
  "requestId" : ""
}

Update Row

Name: updateRow

Updates the specified row in the table.

Properties

Name	Label	Type	Description	Required
docId	Doc ID	STRING	ID of the doc.	true
tableId	Table ID	STRING Depends On docId	ID or name of the table.	true
rowId	Row ID	STRING Depends On docId, tableId	ID or name of the row.	true
row	Row	OBJECT Properties {[{STRING(column), STRING(value)}](cells)}	An edit made to a particular row.	true

Example JSON Structure

{
  "label" : "Update Row",
  "name" : "updateRow",
  "parameters" : {
    "docId" : "",
    "tableId" : "",
    "rowId" : "",
    "row" : {
      "cells" : [ {
        "column" : "",
        "value" : ""
      } ]
    }
  },
  "type" : "coda/v1/updateRow"
}

Properties

Name	Type	Description
requestId	STRING	An arbitrary unique identifier for this request.
id	STRING	ID of the updated row.

Output Example

{
  "requestId" : "",
  "id" : ""
}

Insert Row

Name: insertRow

Inserts row into a table.

Properties

Name	Label	Type	Description	Required
docId	Doc ID	STRING	ID of the doc.	true
tableId	Table ID	STRING Depends On docId	ID of the table.	true
rowValues		DYNAMIC_PROPERTIES Depends On docId, tableId		false

Example JSON Structure

{
  "label" : "Insert Row",
  "name" : "insertRow",
  "parameters" : {
    "docId" : "",
    "tableId" : "",
    "rowValues" : { }
  },
  "type" : "coda/v1/insertRow"
}

Properties

Name	Type	Description
requestId	STRING	An arbitrary unique identifier for this request.
addedRowIds	ARRAY Items [STRING]	Row IDs for rows that will be added.

Output Example

{
  "requestId" : "",
  "addedRowIds" : [ "" ]
}

What to do if your action is not listed here?

If this component doesn't have the action you need, you can use Custom Action to create your own. Custom Actions empower you to define HTTP requests tailored to your specific requirements, allowing for greater flexibility in integrating with external services or APIs.

To create a Custom Action, simply specify the desired HTTP method, path, and any necessary parameters. This way, you can extend the functionality of your component beyond the predefined actions, ensuring that you can meet all your integration needs effectively.

On this page