Generates a People filter from a description, or changes an existing one.

POST

https://api.cobra.de/v1/crm/lists/people/ai-filter

Last modified:2026-08-20 08:17:30

Supply currentFilter to change a filter instead of building a new one; the description is
then read as a change instruction and only what it asks for is changed. A change request is
refused with 400 when the existing filter contains criteria this endpoint cannot represent, rather
than risking their silent loss.

The generator never asks a question back: an ambiguous criterion is filtered with the most likely
reading and the interpretation is spelled out in warnings, which the client has to show.
Status failed comes back as 200 with a message - the manual filter path stays usable.

Send timeZone as the caller's IANA zone. Date rules resolve their day boundaries in it, so
a wrong zone makes the generated filter and the same filter after an edit cover different days.

filterGraphQL is compiled by the same translator the manual path uses; clients should save
it rather than recompiling, so the two sides cannot drift.

Request

Header Params

Body Params

application/json

Example

{
    "prompt": "Alle Kunden bei der Volkswagen AG",
    "currentFilter": {
        "groups": [
            {
                "rules": [
                    {
                        "column": "string",
                        "condition": "string",
                        "value": null
                    }
                ]
            }
        ]
    },
    "timeZone": "Europe/Berlin"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.cobra.de/v1/crm/lists/people/ai-filter' \
--header 'X-Integration-Name: API Documentation' \
--header 'X-Integration-Provider: cobra GmbH' \
--header 'X-Cobra-TenantId: 12e39e53-ece1-4d8d-8958-e782de1dbef0' \
--header 'X-Integration-Contact: info@cobra.de' \
--header 'Accept-Language: de-DE' \
--header 'Content-Type: application/json' \
--data '{
    "prompt": "Alle Kunden bei der Volkswagen AG",
    "currentFilter": {
        "groups": [
            {
                "rules": [
                    {
                        "column": "string",
                        "condition": "string",
                        "value": null
                    }
                ]
            }
        ]
    },
    "timeZone": "Europe/Berlin"
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "data": {
        "status": "ok",
        "filter": {
            "groups": [
                {
                    "rules": [
                        {
                            "column": "string",
                            "condition": "string",
                            "value": null
                        }
                    ]
                }
            ]
        },
        "filterGraphQl": "where: { lifecycle: { some: { text: { _in: [\"Kunde\"] } } } }",
        "explanation": "string",
        "warnings": [
            {
                "kind": "missing",
                "text": "Für einen Werbewiderspruch gibt es kein Filterfeld."
            }
        ],
        "matchCount": 890,
        "matchCountBefore": 1240
    },
    "message": "string",
    "metaData": {
        "totalResults": 0,
        "responseTimeStamp": "2019-08-24T14:15:22.123Z"
    },
    "statusCode": 0
}

🟠400

🟠403

🟠429

🔴502

🔴503

Modified at 2026-08-20 08:17:30

Sets or clears a personal pin on a filter list.

Gets a People List by its ID