Process analytics API filter not working for custom fields in report queries

joe_743
Tue, 20 May 2025 09:29:45 +0000

Filtering by custom fields in process analytics API queries returns empty results even though the custom fields contain data and work fine in the AgilePoint UI reports.

We’ve added several custom fields to our process instances (department, priority, requestType) and can see the data populated correctly in the process analytics dashboard. However, when we try to filter by these fields using the REST API, we get zero results.

GET /api/v1/analytics/processes/instances
  ?filter=customFields.department eq 'Sales'
Response: {instances: [], totalCount: 0}

Same query in UI: Returns 47 instances correctly

Standard fields (status, startDate, processName) work perfectly in API filters. It’s only the custom fields that fail. The filter syntax appears correct based on the documentation, but I’m wondering if there’s something special about how custom field metadata needs to be registered or referenced in API queries.

Has anyone successfully filtered analytics API results using custom fields? Is there a different syntax or schema reference required?