List custom behaviors

{
  "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": 1,
  "next": null,
  "previous": null,
  "current_filters": {}
}

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

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Query parameters

pageintegerOptional>=1Defaults to 1

Page number.

page_sizeintegerOptional1-1000Defaults to 100

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

tagsstringOptional

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

Response

A page of custom behaviors.

resultslist of objects

Custom behaviors, most recently updated first.

countinteger

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

nextstring or nullformat: "uri"

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

previousstring or nullformat: "uri"

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

current_filtersmap from strings to anyOptional

Always empty for this endpoint.

Errors

403

Forbidden Error

429

Too Many Requests Error