---
title: "Changes to List users"
method: POST
path: "/api/users/list/"
---

# Changes to List users

`POST /api/users/list/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 19 revisions.

- **2026-10-21** `c30bcb383ee8`: 16 breaking, 4 info
- **2026-10-02** `b830b79cfd52`: 46 breaking, 5 warning, 142 info
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
- **2026-09-12** `22b868ef3f22`: 1 info
- **2026-08-22** `b18c72975097`: 1 warning
- **2026-08-13** `4e064cf81dae`: 1 breaking, 16 warning, 11 info
- **2026-07-31** `c26d550029f8`: 14 breaking, 5 warning, 8 info

## Changes

- **2026-10-21** `c30bcb383ee8`: 16 breaking, 4 info
  - request body became required
  - the response property `next` became nullable for the status `200`
  - the response property `previous` became nullable for the status `200`
  - the response property `results/items/average_latency` became nullable for the status `200`
  - the response property `results/items/average_ttft` became nullable for the status `200`
  - the response property `results/items/email` became nullable for the status `200`
  - the response property `results/items/name` became nullable for the status `200`
  - the response property `results/items/period_budget` became nullable for the status `200`
  - the response property `results/items/total_budget` became nullable for the status `200`
  - the `results/items/average_latency` response's property type changed from `number, null` to `number`, and format from `double` to no format for status `200`
  - the `results/items/average_monthly_cost` response's property format changed from `double` to no format for status `200`
  - the `results/items/average_ttft` response's property type changed from `number, null` to `number`, and format from `double` to no format for status `200`
  - the `results/items/cost` response's property format changed from `double` to no format for status `200`
  - the `results/items/period_budget` response's property type changed from `number, null` to `number`, and format from `double` to no format for status `200`
  - the `results/items/total_budget` response's property type changed from `number, null` to `number`, and format from `double` to no format for status `200`
  - the `results/items/total_cost` response's property format changed from `double` to no format for status `200`
  - api operation id `users_listCustomers` removed and replaced with `listCustomers`
  - the endpoint scheme security `DashboardJwt` was added to the API
  - api tag `Users` added
  - api tag `users` removed
- **2026-10-02** `b830b79cfd52`: 46 breaking, 5 warning, 142 info
  - removed the enum value `iexact` of the request property `filters/cache_key/operator`
  - removed the enum value `iexact` of the request property `filters/completion_tokens/operator`
  - removed the enum value `iexact` of the request property `filters/cost/operator`
  - removed the enum value `iexact` of the request property `filters/custom_identifier/operator`
  - removed the enum value `iexact` of the request property `filters/customer_identifier/operator`
  - removed the enum value `iexact` of the request property `filters/group_identifier/operator`
  - removed the enum value `iexact` of the request property `filters/is_root_span/operator`
  - removed the enum value `iexact` of the request property `filters/latency/operator`
  - removed the enum value `iexact` of the request property `filters/log_type/operator`
  - removed the enum value `iexact` of the request property `filters/model/operator`
  - removed the enum value `iexact` of the request property `filters/positive_feedback/operator`
  - removed the enum value `iexact` of the request property `filters/prompt_id/operator`
  - removed the enum value `iexact` of the request property `filters/prompt_tokens/operator`
  - removed the enum value `iexact` of the request property `filters/span_name/operator`
  - removed the enum value `iexact` of the request property `filters/span_parent_id/operator`
  - removed the enum value `iexact` of the request property `filters/span_workflow_name/operator`
  - removed the enum value `iexact` of the request property `filters/status/operator`
  - removed the enum value `iexact` of the request property `filters/status_code/operator`
  - removed the enum value `iexact` of the request property `filters/stream/operator`
  - removed the enum value `iexact` of the request property `filters/thread_identifier/operator`
  - removed the enum value `iexact` of the request property `filters/total_tokens/operator`
  - removed the enum value `iexact` of the request property `filters/trace_unique_id/operator`
  - removed the enum value `iexact` of the request property `filters/unique_id/operator`
  - removed the enum value `isnull` of the request property `filters/cache_key/operator`
  - removed the enum value `isnull` of the request property `filters/completion_tokens/operator`
  - removed the enum value `isnull` of the request property `filters/cost/operator`
  - removed the enum value `isnull` of the request property `filters/custom_identifier/operator`
  - removed the enum value `isnull` of the request property `filters/customer_identifier/operator`
  - removed the enum value `isnull` of the request property `filters/group_identifier/operator`
  - removed the enum value `isnull` of the request property `filters/is_root_span/operator`
  - removed the enum value `isnull` of the request property `filters/latency/operator`
  - removed the enum value `isnull` of the request property `filters/log_type/operator`
  - removed the enum value `isnull` of the request property `filters/model/operator`
  - removed the enum value `isnull` of the request property `filters/positive_feedback/operator`
  - removed the enum value `isnull` of the request property `filters/prompt_id/operator`
  - removed the enum value `isnull` of the request property `filters/prompt_tokens/operator`
  - removed the enum value `isnull` of the request property `filters/span_name/operator`
  - removed the enum value `isnull` of the request property `filters/span_parent_id/operator`
  - removed the enum value `isnull` of the request property `filters/span_workflow_name/operator`
  - removed the enum value `isnull` of the request property `filters/status/operator`
  - …153 more
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `RespanApiKey` was added to the API
- **2026-09-12** `22b868ef3f22`: 1 info
  - api operation id `list-customers` removed and replaced with `users_listCustomers`
- **2026-08-22** `b18c72975097`: 1 warning
  - for the `query` request parameter `page_size`, the max was set to `1000.00`
- **2026-08-13** `4e064cf81dae`: 1 breaking, 16 warning, 11 info
  - removed the success response with the status `201`
  - removed the request property `active_days`
  - removed the request property `average_latency`
  - removed the request property `average_ttft`
  - removed the request property `cost`
  - removed the request property `customer_identifier`
  - removed the request property `email`
  - removed the request property `environment`
  - removed the request property `first_seen`
  - removed the request property `last_active_timeframe`
  - removed the request property `name`
  - removed the request property `number_of_requests`
  - removed the request property `tokens`
  - removed the request property `total_cost`
  - removed the request property `total_requests`
  - removed the request property `total_tokens`
  - removed the request property `unique_organization_id`
  - added the new optional `query` request parameter `environment`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `page_size`
  - added the new optional `query` request parameter `sort_by`
  - added the new optional request property `filters`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `413`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
  - added the success response with the status `200`
- **2026-07-31** `c26d550029f8`: 14 breaking, 5 warning, 8 info
  - added the new required request property `active_days`
  - added the new required request property `average_latency`
  - added the new required request property `average_ttft`
  - added the new required request property `cost`
  - added the new required request property `customer_identifier`
  - added the new required request property `environment`
  - added the new required request property `first_seen`
  - added the new required request property `last_active_timeframe`
  - added the new required request property `number_of_requests`
  - added the new required request property `tokens`
  - added the new required request property `total_cost`
  - added the new required request property `total_requests`
  - added the new required request property `total_tokens`
  - removed the success response with the status `200`
  - deleted the `query` request parameter `environment`
  - deleted the `query` request parameter `page`
  - deleted the `query` request parameter `page_size`
  - deleted the `query` request parameter `sort_by`
  - removed the request property `filters`
  - added the new optional request property `email`
  - added the new optional request property `name`
  - added the new optional request property `unique_organization_id`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `429`
  - removed the non-success response with the status `500`
  - added the success response with the status `201`

---

[Operation](https://skmtc.dev/keywordsai/apis/respan-api/docs/api/users/list/post.md) - [API](https://skmtc.dev/keywordsai/apis/respan-api.md) - [Page](https://skmtc.dev/keywordsai/apis/respan-api/changes/api/users/list/post)
