Delete Custom Fields for Historical Points

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Use this GET API to delete a custom field configured for historical points import. The API performs a soft delete. It marks the custom field as inactive but does not remove existing historical points data associated with that field. Historical records continue to retain previously stored values.

Use this API when you want to:

  • Prevent further use of a custom field in historical points imports.
  • Clean up unused or incorrectly configured custom fields.
  • Deactivate a field without affecting existing historical data.

Prerequisites

  • The custom field you want to delete must exist.
🚧

Warning

Deleting a custom field is a soft delete operation. The field is marked as inactive, but existing historical points data retains the field values.

Example request

curl --location 'https://eu.intouch.capillarytech.com/v2/historicalPoints/deleteCustomFields?field_name=testField2' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic bmVlIwMzZhNGNjZGMzMzQzMWVmOWFjOQ==' \
--data ''

Query parameters

ParameterTypeRequired?Description
field_namestringYesName of the custom field to soft delete.

Example response

{
    "status": true,
    "message": "SUCCESSFULLY_DELETED_HISTORICAL_POINTS_CUSTOM_FIELD",
    "warnings": []
}

Response parameters

ParameterDatatypeDescription
-statusbooleantrue if the operation was successful, false otherwise.
-messagestringDescribes the result of the operation.
warningsarrayList of warning messages.

Error codes

CodeDescription
2203Error while deleting the historical points custom field. Returned when the delete operation fails or an exception occurs.
Query Params
string
required
Body Params
Headers
string
required
Defaults to Basic bmVlcmFqLmRvYzpiNGFmODA0MDA5Y2IwMzZhNGNjZGMzMzQzMWVmOWFj
Response

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json