v1

latestOpenAPI 3.0.12026-08-0621301.7 MB
Filters

Update filter

Updates an existing filter.

put/filters/{id}

Path parameters

idinteger required

The ID of the filter

Query parameters

include_field_codeboolean

If set to true, each condition in the response includes a field_code field identifying the field by its code name

Request body

namestring

The name of the filter

conditionsobject required

The conditions of the filter as a JSON object. Please note that a maximum of 16 conditions is allowed per filter and date values must be supplied in the YYYY-MM-DD format. It requires a minimum structure as follows: {"glue":"and","conditions":[{"glue":"and","conditions": [CONDITION_OBJECTS]},{"glue":"or","conditions":[CONDITION_OBJECTS]}]}. Replace CONDITION_OBJECTS with JSON objects of the following structure: {"object":"","field_id":"", "operator":"","value":"", "extra_value":""} or leave the array empty. Depending on the object type you should use another API endpoint to get field_id. There are five types of objects you can choose from: "person", "deal", "organization", "product", "activity" and you can use these types of operators depending on what type of a field you have: "IS NOT NULL", "IS NULL", "<=", ">=", "<", ">", "!=", "=", "LIKE '$%'", "LIKE '%$%'", "NOT LIKE '$%'". To get a better understanding of how filters work try creating them directly from the Pipedrive application.

Response

Success

successboolean

If the response is successful or not