---
title: "POST /inference-pipelines/{inferencePipelineId}/users"
method: POST
path: "/inference-pipelines/{inferencePipelineId}/users"
tags: ["Monitoring"]
---

# POST /inference-pipelines/{inferencePipelineId}/users

`POST /inference-pipelines/{inferencePipelineId}/users`

Get aggregated user data for an inference pipeline with pagination and metadata.

Returns a list of users who have interacted with the inference pipeline, including
their activity statistics such as session counts, record counts, token usage, and costs.

## Path parameters

- `inferencePipelineId` string, uuid, required

## Query parameters

- `page` integer
- `perPage` integer
- `sortColumn` string
- `asc` boolean

## Request body

- DatasetFilter, nullable
  - `columnFilters` union[], nullable
    - union
      - object
        - `measurement` string, required — The name of the column.
        - `operator` 'contains_none' | 'contains_any' | 'contains_all' | 'one_of' | 'none_of', required
        - `value` union[], required
          - union
            - string
            - number
      - object
        - `measurement` string, required — The name of the column.
        - `operator` '>' | '>=' | 'is' | '<' | '<=' | '!=', required
        - `value` number, float, nullable, required
      - object
        - `measurement` string, required — The name of the column.
        - `operator` 'is' | '!=', required
        - `value` union, required
          - string
          - boolean
  - `searchQueryOr` string[], nullable
  - `searchQueryAnd` string[], nullable
  - `notSearchQueryOr` string[], nullable
  - `notSearchQueryAnd` string[], nullable
  - `rowIdList` integer[], nullable
  - `excludeRowIdList` integer[], nullable

## Response `200`

Response OK.

- object
  - `items` UserAggregation[], required — Array of user aggregation data
    - `id` string, required — The unique user identifier
    - `dateOfFirstRecord` string, date-time, required — Timestamp of the user's first event/trace
    - `dateOfLastRecord` string, date-time, required — Timestamp of the user's last event/trace
    - `sessions` integer, required — Count of unique sessions for this user
    - `records` integer, required — Total number of traces/rows for this user
    - `tokens` number, float, required — Total token count for this user
    - `cost` number, float, required — Total cost for this user

## Other responses

- `202` — Request accepted, data is being loaded.
- `default` — Unexpected error.

---

[API](https://skmtc.net/openlayer/apis/openlayer-api.md) · [All operations](https://skmtc.net/openlayer/apis/openlayer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openlayer/openlayer-api/versions/d0e74f00c900/schema)