Get workflow aggregations

Base URL: https://{kibana_url}

GET /api/workflows/aggs
GET /s/{space_id}/api/workflows/aggs

Auth

Retrieve distinct values and their counts for the specified workflow fields. Useful for building filters such as lists of tags or creators.

Required authorization

Privileges workflowsManagement:read or workflowsManagement:managed:read

Path parameters

space_id string optional: An identifier for the space. If space_id is not provided in the URL, the default space is used. Refer to Spaces for more information.

Query parameters

fields string[] · min items: 1 · max items: 25 required: Field or fields to aggregate on.
managed enum: Filter aggregations by managed status.; Values: all managed unmanaged

Response

200

Indicates a successful response

application/json

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

GET kbn://api/workflows/aggs?fields=tags&fields=createdBy

curl Shell

curl \
  -X GET "${KIBANA_URL}/api/workflows/aggs?fields=tags&fields=createdBy" \
  -H "Authorization: ApiKey ${API_KEY}"

Response

Example response with tag and createdBy aggregations

{
  "createdBy": [
    {
      "doc_count": 2,
      "key": "elastic"
    }
  ],
  "tags": [
    {
      "doc_count": 1,
      "key": "reporting"
    },
    {
      "doc_count": 1,
      "key": "security"
    },
    {
      "doc_count": 1,
      "key": "triage"
    }
  ]
}