Remove a column from a vault
Remove a column from a vault's table.
The values already extracted under the column's field_key stay stored, so a new column created with the same field_key shows them again. Nothing is re-scanned either way.
Only a custom column can be removed. A system column (Document Name, Document Status, Document Title) returns 400, and a built-in column has no ID to address. A column a connected spreadsheet owns comes off when you remove the sheet in the app.
Requires the editor or owner role in the vault and the organization-level permission to manage vaults.
Requires a user-scoped API key (u:gcai_...). A vault is shared with named people, so an organization-scoped key has no identity to resolve vault access with.
Request
- Base URLhttps://app.gc.ai/api/external/v1
- AuthAPI key in header Authorization
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
The vault ID
The column ID from GET /vaults/{id}/columns. Built-in columns report id: null and cannot be addressed here.
Response
Column removed
Changes
No recorded changes to this operation across all 1 revision of this API.