Create rows with the Superhuman Docs API
Inserts rows in a table, or updates the rows that match the keyColumns. Every matching row is updated. Only base tables take rows, not views; the change is queued and shows up in a few seconds.
- Identifier
- coda_create_rows
The request
POST https://connect.reportei.com/api/tools/coda_create_rows/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"docId": "<docId>",
"tableIdOrName": "<tableIdOrName>",
"rows": []
}
}Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| docId | string | Yes | Id of the doc, from List docs. |
| tableIdOrName | string | Yes | Id of the table, from List tables. A name also works, but names change. |
| rows | array | Yes | Rows to insert, each with the values of its cells. |
| keyColumns | array | No | Column ids from List columns that identify an existing row. With them, matching rows are updated instead of duplicated. |
Supported connections
Your customer connects their Superhuman Docs account once, with one of the modes below. The same connection serves every tool of the toolkit.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
The response
On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.
Ready for AI agents
This tool's input is a JSON Schema, available at GET /api/tools/coda_create_rows. It becomes your agent's tool definition with no conversion.
Other Superhuman Docs tools
- List docsGETLists the docs the user can access and has opened at least once, latest activity first, with id, name, owner, workspace and browserLink. Send nextPageToken as pageToken for the next page.
- Create docPOSTCreates a doc, empty or as a copy of another doc, in the My docs folder of the oldest workspace the user joined. Needs the Doc Maker role in the workspace.
- List pagesGETLists the pages of a doc with id, name, subtitle, parent and children. Send nextPageToken as pageToken for the next page.
- List page contentGETReturns the content of a page as plain text, element by element. Send nextPageToken as pageToken for the next part.
- Create pagePOSTCreates a page in a doc, or a subpage, with content in Markdown or HTML. The change is queued and shows up in a few seconds; the response has the id of the page. Needs the Doc Maker role.
- Update pagePUTRenames a page or adds content to it, at the end, at the start or replacing everything. The change is queued and shows up in a few seconds. Changing the name needs the Doc Maker role.
- List tablesGETLists the tables and views of a doc with id, name, type and parent page. Rows are written only to tables, not to views. Send nextPageToken as pageToken for the next page.
- List columnsGETLists the columns of a table with id, name and format. The column ids go in the cells of Create rows and Update row and in the query of List rows.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
