KEkeywordsai
Behaviors

List custom behaviors

Changed on

Lists your organization's custom behaviors, most recently updated first.

get/api/pulses/behaviors/custom/

Request

  • Base URL
    https://api.respan.ai
  • URL
    https://api.respan.ai/api/pulses/behaviors/custom/
  • Auth
    HTTP bearer

Query parameters

pageinteger

Page number.

page_sizeinteger

Behaviors per page. Values above 1000 are capped at 1000.

tagsstring

Only behaviors with any of these tag IDs. Comma-separated, or repeat the parameter.

Response

A page of custom behaviors.

countinteger required

Number of behaviors on this page (not the total).

nextstring uri nullable required

URL of the next page, or null on the last page.

previousstring uri nullable required

URL of the previous page, or null on the first page.

current_filtersobject

Always empty for this endpoint.

Example response

{
  "results": [
    {
      "id": "6f1c2a9e-3b7d-4c55-9a0e-2d8f4b1c7e93",
      "name": "Refund promise",
      "description": "The assistant promises a refund, credit, or compensation that the policy in the system prompt does not allow.",
      "polarity": "negative",
      "created_at": "2026-09-28T17:41:09.512340Z",
      "updated_at": "2026-09-28T17:41:09.512340Z",
      "tags": [
        {
          "id": "0b7e5f0c-2a61-4d3e-9a47-5c8f1e2d3b4a",
          "name": "Support",
          "color": "#2563EB",
          "created_at": "2026-09-12T09:30:00Z",
          "updated_at": "2026-09-12T09:30:00Z"
        }
      ]
    }
  ],
  "count": 3,
  "current_filters": {}
}

Changes

  • c30bcb383ee8Revision changes
    • 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 object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • info

      api operation id behaviors_listCustomBehaviors removed and replaced with listCustomBehaviors

    • info

      api tag Behaviors added

    • info

      api tag behaviors removed

    • info

      added subschema #2 to the / response property allOf list for the response status

  • b830b79cfd52Revision changes
    • info

      endpoint added