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

Connection Setup

Login to the dashboard at https://coda.io/signin.
Click on your account.
Click on Account Settings.
Scroll to API Settings and click Generate API token.
Give your token a name and click Generate API token.
Copy the API token. Use these credentials to create a connection in ByteChef.

Actions

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

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.

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" : ""
}

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.

Additional Instructions

How to find Doc ID

Method 1: Via API

Use the GET /docs endpoint to retrieve a list of all docs and their IDs.

Method 2: Via UI

To find a Doc ID, open the document in your browser. The ID is the long string of letters and numbers in the URL after _d.

For example, in the URL https://coda.io/d/Bytechef-testing_d123abc, the Doc ID is 123abc.

The Doc ID can also be found in the output of the following actions:

Copy Doc
List Docs

How to find Table ID

Method 1: Via API

Use the GET /docs/DOC_ID/tables endpoint to retrieve a list of all tables and their IDs.

How to find Row ID

Method 1: Via API

Use the GET /docs/DOC_ID/tables/TABLE_ID/rows endpoint to retrieve a list of all rows and their IDs.

The Row ID can also be found in the output of the following actions:

Insert Row
Update Row

How to find Column ID

Method 1: Via API

Use the GET /docs/DOC_ID/tables/TABLE_ID/columns endpoint to retrieve a list of all columns and their IDs.

Coda

On this page