Prompts

List prompts

Changed on Oct 21, 2026

post/api/prompts/list/

Request

Base URL
https://api.respan.ai
URL
https://api.respan.ai/api/prompts/list/
Auth
- HTTP bearer
- or HTTP bearer

Query parameters

pageinteger

Page number.

page_sizeinteger

Number of prompts per page. Maximum is 100.

sort_by'-id' | 'id' | '-current_version__updated_at' | 'current_version__updated_at'

Sort field. Prefix with - for descending. Common values are -id and -current_version__updated_at.

Request body

Example request

{
  "filters": {
    "prompt_id": {
      "operator": "gte",
      "value": [
        0.01
      ]
    },
    "prompt_slug": {
      "operator": "gte",
      "value": [
        0.01
      ]
    },
    "name": {
      "operator": "gte",
      "value": [
        0.01
      ]
    },
    "description": {
      "operator": "gte",
      "value": [
        0.01
      ]
    },
    "starred": {
      "operator": "gte",
      "value": [
        0.01
      ]
    },
    "tags": {
      "operator": "gte",
      "value": [
        0.01
      ]
    },
    "current_version__updated_at": {
      "operator": "gte",
      "value": [
        0.01
      ]
    },
    "current_version__created_at": {
      "operator": "gte",
      "value": [
        0.01
      ]
    },
    "is_deleted": {
      "operator": "gte",
      "value": [
        0.01
      ]
    }
  }
}

Response

Paginated list of prompts.

countinteger

Number of results on this page, not the total. Request pages until next is null to get every result.

nextstring nullable

Next page URL.

previousstring nullable

Previous page URL.

Example response

{
  "count": 42,
  "next": "https://api.respan.ai/api/prompts/list/?page=2",
  "previous": null,
  "results": [
    {
      "id": "prompt_abc123",
      "name": "Customer Support Assistant",
      "description": "Handles customer support queries with empathy",
      "prompt_slug": "customer-support-assistant",
      "tags": [
        {
          "id": "tag_abc123",
          "name": "support",
          "color": "#3B82F6",
          "created_at": "2026-01-01T00:00:00Z",
          "updated_at": "2026-01-01T00:00:00Z"
        }
      ],
      "current_version": {
        "version": 3,
        "model": "gpt-4o",
        "updated_at": "2026-01-20T10:30:00Z"
      },
      "live_version": {
        "version": 2,
        "model": "gpt-4o-mini",
        "updated_at": "2026-01-15T08:00:00Z"
      },
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-20T10:30:00Z"
    }
  ]
}

Changes

Oct 21, 2026c30bcb383ee8 Revision changes
- breaking
  request body became required
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the // response's property type changed from no type to object for status
- breaking
  the // response's property type changed from no type to object for status
- info
  api operation id prompts_listPrompts removed and replaced with listPrompts
- info
  the endpoint scheme security DashboardJwt was added to the API
- info
  api tag Prompts added
- info
  api tag prompts removed
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  removed subschema #2 from the // response property oneOf list for the response status
- info
  removed subschema #2 from the // response property oneOf list for the response status
Oct 2, 2026b830b79cfd52 Revision changes
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value iexact of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- breaking
  removed the enum value isnull of the request property //
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- info
  added the new optional request property /
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new empty enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_contains enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_empty enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_endswith enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_in enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the new not_startswith enum value to the request property //
- info
  added the non-success response with the status
- info
  removed the non-success response with the status

Operation history (4 revisions)