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

# Changes to List prompts

`POST /api/prompts/list/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 19 revisions.

- **2026-10-21** `c30bcb383ee8`: 9 breaking, 12 info
- **2026-10-02** `b830b79cfd52`: 16 breaking, 4 warning, 51 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`: 36 breaking, 61 warning, 17 info
- **2026-07-31** `c26d550029f8`: 12 breaking, 12 warning, 88 info

## Changes

- **2026-10-21** `c30bcb383ee8`: 9 breaking, 12 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/current_version` became nullable for the status `200`
  - the response property `results/items/description` became nullable for the status `200`
  - the response property `results/items/live_version` became nullable for the status `200`
  - the response property `results/items/prompt_slug` became nullable for the status `200`
  - the `results/items/current_version` response's property type changed from no type to `object` for status `200`
  - the `results/items/live_version` response's property type changed from no type to `object` for status `200`
  - api operation id `prompts_listPrompts` removed and replaced with `listPrompts`
  - the endpoint scheme security `DashboardJwt` was added to the API
  - api tag `Prompts` added
  - api tag `prompts` removed
  - added the optional property `results/items/current_version/model` to the response with the `200` status
  - added the optional property `results/items/current_version/updated_at` to the response with the `200` status
  - added the optional property `results/items/current_version/version` to the response with the `200` status
  - added the optional property `results/items/live_version/model` to the response with the `200` status
  - added the optional property `results/items/live_version/updated_at` to the response with the `200` status
  - added the optional property `results/items/live_version/version` to the response with the `200` status
  - removed `#/components/schemas/ApiPromptsListPostResponsesContentApplicationJsonSchemaResultsItemsCurrentVersion, subschema #2` from the `results/items/current_version` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/ApiPromptsListPostResponsesContentApplicationJsonSchemaResultsItemsLiveVersion, subschema #2` from the `results/items/live_version` response property `oneOf` list for the response status `200`
- **2026-10-02** `b830b79cfd52`: 16 breaking, 4 warning, 51 info
  - removed the enum value `iexact` of the request property `filters/current_version__updated_at/operator`
  - removed the enum value `iexact` of the request property `filters/description/operator`
  - removed the enum value `iexact` of the request property `filters/is_deleted/operator`
  - removed the enum value `iexact` of the request property `filters/name/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_slug/operator`
  - removed the enum value `iexact` of the request property `filters/starred/operator`
  - removed the enum value `iexact` of the request property `filters/tags/operator`
  - removed the enum value `isnull` of the request property `filters/current_version__updated_at/operator`
  - removed the enum value `isnull` of the request property `filters/description/operator`
  - removed the enum value `isnull` of the request property `filters/is_deleted/operator`
  - removed the enum value `isnull` of the request property `filters/name/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_slug/operator`
  - removed the enum value `isnull` of the request property `filters/starred/operator`
  - removed the enum value `isnull` of the request property `filters/tags/operator`
  - removed the request property `filters/created_at`
  - removed the request property `filters/updated_at`
  - removed the optional property `results/items/created_at` from the response with the `200` status
  - removed the optional property `results/items/updated_at` from the response with the `200` status
  - added the new optional request property `filters/current_version__created_at`
  - added the new `empty` enum value to the request property `filters/current_version__updated_at/operator`
  - added the new `empty` enum value to the request property `filters/description/operator`
  - added the new `empty` enum value to the request property `filters/is_deleted/operator`
  - added the new `empty` enum value to the request property `filters/name/operator`
  - added the new `empty` enum value to the request property `filters/prompt_id/operator`
  - added the new `empty` enum value to the request property `filters/prompt_slug/operator`
  - added the new `empty` enum value to the request property `filters/starred/operator`
  - added the new `empty` enum value to the request property `filters/tags/operator`
  - added the new `not_contains` enum value to the request property `filters/current_version__updated_at/operator`
  - added the new `not_contains` enum value to the request property `filters/description/operator`
  - added the new `not_contains` enum value to the request property `filters/is_deleted/operator`
  - added the new `not_contains` enum value to the request property `filters/name/operator`
  - added the new `not_contains` enum value to the request property `filters/prompt_id/operator`
  - added the new `not_contains` enum value to the request property `filters/prompt_slug/operator`
  - added the new `not_contains` enum value to the request property `filters/starred/operator`
  - added the new `not_contains` enum value to the request property `filters/tags/operator`
  - added the new `not_empty` enum value to the request property `filters/current_version__updated_at/operator`
  - added the new `not_empty` enum value to the request property `filters/description/operator`
  - added the new `not_empty` enum value to the request property `filters/is_deleted/operator`
  - …31 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-prompts` removed and replaced with `prompts_listPrompts`
- **2026-08-22** `b18c72975097`: 1 warning
  - for the `query` request parameter `page_size`, the max was set to `100.00`
- **2026-08-13** `4e064cf81dae`: 36 breaking, 61 warning, 17 info
  - the `query` request parameter `sort_by` was restricted to a list of enum values
  - for the `query` request parameter `page`, default value `1` was added
  - for the `query` request parameter `page_size`, default value `25` was added
  - for the `query` request parameter `sort_by`, default value `-id` was added
  - the response property `results/items/description` became nullable for the status `200`
  - the response property `count` became optional for the status `200`
  - the response property `results` became optional for the status `200`
  - the response property `results/items/current_version` became optional for the status `200`
  - the response property `results/items/id` became optional for the status `200`
  - the response property `results/items/live_version` became optional for the status `200`
  - the response property `results/items/tags` became optional for the status `200`
  - the response property `results/items/tags/items/color` became optional for the status `200`
  - the response property `results/items/tags/items/created_at` became optional for the status `200`
  - the response property `results/items/tags/items/id` became optional for the status `200`
  - the response property `results/items/tags/items/name` became optional for the status `200`
  - the response property `results/items/tags/items/updated_at` became optional for the status `200`
  - added `#/components/schemas/ApiPromptsListPostResponsesContentApplicationJsonSchemaResultsItemsCurrentVersion, subschema #2` to the `results/items/current_version` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ApiPromptsListPostResponsesContentApplicationJsonSchemaResultsItemsLiveVersion, subschema #2` to the `results/items/live_version` response property `oneOf` list for the response status `200`
  - the `next` response's property format changed from `uri` to no format for status `200`
  - the `previous` response's property format changed from `uri` to no format for status `200`
  - the `results/items/current_version` response's property type changed from `object` to no type for status `200`
  - the `results/items/id` response's property type changed from `integer` to `string` for status `200`
  - the `results/items/live_version` response's property type changed from `object` to no type for status `200`
  - removed the required property `results/items/commit_count` from the response with the `200` status
  - removed the required property `results/items/created_by` from the response with the `200` status
  - removed the required property `results/items/current_version/edited_by` from the response with the `200` status
  - removed the required property `results/items/current_version/id` from the response with the `200` status
  - removed the required property `results/items/current_version/prompt` from the response with the `200` status
  - removed the required property `results/items/current_version/updated_at` from the response with the `200` status
  - removed the required property `results/items/full_prompt_id` from the response with the `200` status
  - removed the required property `results/items/live_version/edited_by` from the response with the `200` status
  - removed the required property `results/items/live_version/id` from the response with the `200` status
  - removed the required property `results/items/live_version/prompt` from the response with the `200` status
  - removed the required property `results/items/live_version/updated_at` from the response with the `200` status
  - removed the required property `results/items/organization` from the response with the `200` status
  - removed the required property `results/items/prompt_live_version_number` from the response with the `200` status
  - removed the optional property `current_filters` from the response with the `200` status
  - removed the optional property `filters_data` from the response with the `200` status
  - removed the optional property `results/items/current_version/created_at` from the response with the `200` status
  - removed the optional property `results/items/current_version/description` from the response with the `200` status
  - …74 more
- **2026-07-31** `c26d550029f8`: 12 breaking, 12 warning, 88 info
  - for the `query` request parameter `page`, default value `1` was removed
  - for the `query` request parameter `page_size`, default value `25` was removed
  - for the `query` request parameter `sort_by`, default value `-id` was removed
  - removed the enum value `-current_version__updated_at` from the `query` request parameter `sort_by`
  - removed the enum value `-id` from the `query` request parameter `sort_by`
  - removed the enum value `current_version__updated_at` from the `query` request parameter `sort_by`
  - removed the enum value `id` from the `query` request parameter `sort_by`
  - the `next` response's property format changed from no format to `uri` for status `200`
  - the `previous` response's property format changed from no format to `uri` for status `200`
  - the `results/items/current_version` response's property type changed from no type to `object` for status `200`
  - the `results/items/id` response's property type changed from `string` to `integer` for status `200`
  - the `results/items/live_version` response's property type changed from no type to `object` for status `200`
  - removed the request property `filters/created_at`
  - removed the request property `filters/current_version__updated_at`
  - removed the request property `filters/description`
  - removed the request property `filters/is_deleted`
  - removed the request property `filters/name`
  - removed the request property `filters/prompt_id`
  - removed the request property `filters/prompt_slug`
  - removed the request property `filters/starred`
  - removed the request property `filters/tags`
  - removed the request property `filters/updated_at`
  - removed the optional property `results/items/created_at` from the response with the `200` status
  - removed the optional property `results/items/updated_at` from the response with the `200` status
  - removed the non-success response with the status `401`
  - added the optional property `current_filters` to the response with the `200` status
  - added the optional property `filters_data` to the response with the `200` status
  - added the optional property `results/items/current_version/created_at` to the response with the `200` status
  - added the optional property `results/items/current_version/description` to the response with the `200` status
  - added the optional property `results/items/current_version/fallback_models` to the response with the `200` status
  - added the optional property `results/items/current_version/frequency_penalty` to the response with the `200` status
  - added the optional property `results/items/current_version/is_deployed` to the response with the `200` status
  - added the optional property `results/items/current_version/is_enforcing_response_format` to the response with the `200` status
  - added the optional property `results/items/current_version/json_schema` to the response with the `200` status
  - added the optional property `results/items/current_version/load_balance_models` to the response with the `200` status
  - added the optional property `results/items/current_version/max_tokens` to the response with the `200` status
  - added the optional property `results/items/current_version/messages` to the response with the `200` status
  - added the optional property `results/items/current_version/model` to the response with the `200` status
  - added the optional property `results/items/current_version/parent_prompt` to the response with the `200` status
  - added the optional property `results/items/current_version/presence_penalty` to the response with the `200` status
  - …72 more

---

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