Skip to main content
POST
Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.
Adds columns to a report. Each column is a question the AI answers for every row’s document. New columns go after the existing ones. On a report created through the API over files, new columns start with every cell empty, and adding them computes nothing and uses no credits. Fill the new cells with Run Report, passing the new column ids as column_ids. The columns are added together or not at all: if one cannot be added, the ones added before it are removed, so you can retry the request. A report whose rows follow a repository, and a report made in the app with auto-run on, compute new columns straight away, as the app does. Their credit cost is checked against your organisation’s per-operation limit first.

Authentication

Requires an API key, or an OAuth token with reports:write. The caller also needs edit access to the report.

Path parameters

string
required
The report id.

Body parameters

object[]
required
The columns to add, from 1 to 20.

Response

Returns 201 with { "items": Column[] }: the new columns, in the order you sent them.

Errors