Delete Column

Delete a column and its cells from a report.

DELETE /api/v1/reports/{report_id}/columns/{column_id}

cURL

curl -X DELETE "https://api.wordsmith.ai/api/v1/reports/f544ddfc-24d5-4947-939c-ba2d1bcba35b/columns/56cdb1cf-a2ea-4102-ad7e-dfa91c94c897" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

204 No Content

Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.

Deletes one column from a report, with every cell in it.

This endpoint is REST only. No MCP tool deletes a column.

Authentication

Requires an API key, or an OAuth token with reports:write. As in the app, the caller needs permission to delete the report, not only to edit it.

Path parameters

report_id · string · required

The report id.

column_id · string · required

The column id.

Response

Returns 204 with no body.

cURL

curl -X DELETE "https://api.wordsmith.ai/api/v1/reports/f544ddfc-24d5-4947-939c-ba2d1bcba35b/columns/56cdb1cf-a2ea-4102-ad7e-dfa91c94c897" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

204 No Content

Errors

Status	error_code	When
403	forbidden	The caller can read the report but cannot delete it.
404	resource_not_found	No report or column with these ids, or the caller cannot read the report.