Delete Field

Permanently delete a custom field from your workspace. The field path parameter accepts the field UUID.

Deletion Behavior

What happens when a field is removed

  • A successful request permanently deletes the field and returns an empty response body.
  • Existing contact attributes that use the deleted field name are removed from contacts in the workspace.
  • The field must belong to the workspace in the path.
DELETE
/v1/workspaces/:workspace/fields/:field

Permanently delete a custom field by UUID

Path parameters

workspacestring Required

ID of your workspace

fieldstring Required

Field UUID

Delete Field
curl -X DELETE https://api.leadpush.io/v1/workspaces/:workspace/fields/:field \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {token}"

Success and Errors

Expected outcomes for delete requests

  • Successful requests return an empty success response body.
  • Requests for fields outside the workspace are rejected.