Fields

Delete Field

Soft-delete a custom field (column).

Always org-scoped (you can only delete columns in your own org). Pass list_id to additionally require that the column belong to a specific list — that's the safer default for list-scoped agents since the org may have many custom columns across different lists.

delete/fields/{column_id}

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/fields/{column_id}
  • Auth: HTTP bearer

Path parameters

column_idinteger required

Column ID to delete

Query parameters

entitystring

Target entity: 'contacts' or 'companies'

list_idinteger nullable

Optional list scope guard. If provided, the column must belong to this list or the request returns 404. Use this to prevent an agent with narrow intent from accidentally deleting a column on a different list in the same org.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

Changes

No recorded changes to this operation across all 3 revisions of this API.