Skip to content
Ishvana Ishvana Docs

Get Available Stances

GET
/api/chat/stances

Get list of available response stances

Retrieves all available response stances with their descriptions, approach, and focus areas. Use this endpoint to populate stance selection in the UI.

Returns: Dict containing: - stances: List of stance objects with id, name, description, focus - count: Total number of available stances

Example Response: { “stances”: [ { “id”: “brainstorming”, “name”: “Brainstorming”, “description”: “Adopt an expansive, creative approach…”, “focus”: “idea generation and creative exploration” }, … ], “count”: 7 }

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

StancesResponse

Response model for available stances listing.

Returns list of all available response stances with their descriptions, approach, and focus areas for stance selection in the UI.

Fields:

  • stances: List of stance objects with id, name, description, focus (list of dicts)
  • count: Total number of available stances (non-negative integer)

Stance Object Structure: Each stance object contains:

  • id: Stance identifier (e.g., “brainstorming”, “supportive”, “concise”)
  • name: Display name (e.g., “Brainstorming”, “Supportive”, “Concise”)
  • description: Stance description text
  • focus: Focus area description (e.g., “idea generation and creative exploration”)

Usage: GET /api/chat/stances returns this response model for stance selection UI, stance discovery, and stance management interfaces.

JSON Example:

{
  "stances": [
    {
      "id": "brainstorming",
      "name": "Brainstorming",
      "description": "Adopt an expansive, creative approach...",
      "focus": "idea generation and creative exploration"
    },
    {
      "id": "supportive",
      "name": "Supportive",
      "description": "Be encouraging and confidence-building...",
      "focus": "confidence-building and progress"
    }
  ],
  "count": 7
}
object
stances
required
Stances

List of stance objects with id, name, description, focus

Array<object>
StanceListItem

Individual stance item for stance listing.

Represents a single stance in the stances list with all metadata needed for stance selection UI and discovery.

Fields:

  • id: Stance identifier (e.g., “brainstorming”, “supportive”, “concise”)
  • name: Display name (e.g., “Brainstorming”, “Supportive”, “Concise”)
  • description: Stance description text
  • focus: Focus area description
object
id
required
Id

Stance identifier

string
name
required
Name

Display name for the stance

string
description
required
Description

Stance description text

string
focus
required
Focus

Focus area description

string
count
required
Count

Total number of available stances

integer