List behaviors | Respan Docs

{
  "columns": [
    {
      "id": "behavior__refusal",
      "key": "refusal",
      "name": "Refusal",
      "polarity": "neutral",
      "type": "boolean",
      "source": "builtin"
    },
    {
      "id": "behavior__instruction_miss",
      "key": "instruction_miss",
      "name": "Instruction Miss",
      "polarity": "negative",
      "type": "boolean",
      "source": "builtin"
    },
    {
      "id": "behavior__6f1c2a9e-3b7d-4c55-9a0e-2d8f4b1c7e93",
      "key": "6f1c2a9e-3b7d-4c55-9a0e-2d8f4b1c7e93",
      "name": "Refund promise",
      "polarity": "negative",
      "type": "boolean",
      "source": "custom"
    }
  ],
  "is_span_behaviors_enabled": true,
  "max_selected_columns": 20,
  "true_probability_threshold": 0.65
}

Lists every behavior turned on for your organization, built-in and custom, with the key it’s counted under. Use the keys with the other behavior endpoints. Returns an empty list instead of an error when behaviors are off.

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.

Response

The behaviors.

columnslist of objects

Built-in behaviors, then custom behaviors oldest first. Turned-off behaviors are left out. Empty when behaviors are off for the organization.

is_span_behaviors_enabledboolean

Whether behaviors are turned on for the organization.

max_selected_columnsinteger

Most behaviors one spans list or summary request can ask counts for in behavior_columns.

true_probability_thresholddouble

A behavior fires on a span when its latest score is at or above this value.

Errors

403

Forbidden Error

429

Too Many Requests Error