> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ankra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List general chat conversations



## OpenAPI

````yaml https://platform.ankra.app/openapi.json get /api/v1/chat/general/history
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://platform.ankra.app
security: []
tags:
  - name: Clusters
    description: Create, inspect and manage clusters, and the stacks deployed on them.
  - name: Managed Clusters
    description: Provider-managed control planes, driven through one common surface.
  - name: Imported Clusters
    description: Clusters that already existed and were connected to Ankra.
  - name: Cluster Access
    description: Kubeconfigs, service-account tokens and per-cluster access grants.
  - name: Kubernetes
    description: Read and act on the Kubernetes objects inside a cluster.
  - name: DigitalOcean Clusters
    description: Provision and manage DigitalOcean Kubernetes clusters.
  - name: Hetzner Clusters
    description: Provision and manage Hetzner Kubernetes clusters.
  - name: OVH Clusters
    description: Provision and manage OVH Kubernetes clusters.
  - name: Scaleway Clusters
    description: Provision and manage Scaleway Kapsule clusters.
  - name: UpCloud Clusters
    description: Provision and manage UpCloud Kubernetes clusters.
  - name: Applications
    description: Deploy, configure and observe applications across the fleet.
  - name: Stack Profiles
    description: Reusable stack definitions, their versions and sharing.
  - name: Charts
    description: Browse the chart catalogue behind stacks and addons.
  - name: Helm
    description: Helm registries, credentials and the charts they expose.
  - name: Executions
    description: Long-running platform executions and their jobs.
  - name: Operations
    description: Cancel in-flight cluster operations and their jobs.
  - name: Chat
    description: Conversational sessions, plans and confirmable actions.
  - name: AI Agent Runs
    description: Autonomous agent runs and their outcomes.
  - name: AI Tickets
    description: The AI ticket board, its sync connections and settings.
  - name: AI Playbooks
    description: Reusable playbooks the AI lanes execute.
  - name: AI Conditions
    description: Conditions that gate AI autonomy.
  - name: AI Engineering Handoffs
    description: Work the AI lanes escalate to a human engineer.
  - name: AI Environment
    description: The environment and base stacks AI demos deploy into.
  - name: Security
    description: Findings, advisories, SBOMs, compliance and posture.
  - name: Cost
    description: Cluster and fleet cost, rate cards and cost settings.
  - name: Billing
    description: Subscription and spend caps.
  - name: Organisation
    description: Members, invitations, audit logs and organisation settings.
  - name: Account Tokens
    description: Personal access tokens for the API and CLI.
  - name: Credentials
    description: The shared credential store.
  - name: Azure Credentials
    description: Azure credentials and SSH keys.
  - name: DigitalOcean Credentials
    description: DigitalOcean credentials and SSH keys.
  - name: Hetzner Credentials
    description: Hetzner credentials and SSH keys.
  - name: OVH Credentials
    description: OVH credentials and SSH keys.
  - name: Scaleway Credentials
    description: Scaleway credentials.
  - name: UpCloud Credentials
    description: UpCloud credentials and SSH keys.
  - name: Data Source Credentials
    description: Credentials for metrics and log sources.
  - name: DNS Credentials
    description: Credentials for DNS providers.
  - name: DNS
    description: DNS zones and records, including custom organisation zones.
  - name: Cloudflare
    description: Cloudflare domains and the credentials behind them.
  - name: Variables
    description: Organisation- and cluster-scoped variables.
  - name: SOPS
    description: Encrypt and decrypt values with the organisation SOPS config.
  - name: Alerts
    description: Alert integrations and ingest credentials.
  - name: Notifications
    description: Notification routes and their delivery targets.
  - name: Support
    description: Support tickets.
paths:
  /api/v1/chat/general/history:
    get:
      tags:
        - Chat
      summary: List general chat conversations
      operationId: list_general_chat_history_endpoint_api_v1_chat_general_history_get
      parameters:
        - description: Show all conversations including deleted
          in: query
          name: show_all
          required: false
          schema:
            default: true
            description: Show all conversations including deleted
            examples:
              - true
            title: Show All
            type: boolean
        - description: Maximum number of conversations to return
          in: query
          name: limit
          required: false
          schema:
            default: 50
            description: Maximum number of conversations to return
            examples:
              - 50
            maximum: 1000
            minimum: 1
            title: Limit
            type: integer
        - description: Number of conversations to skip
          in: query
          name: offset
          required: false
          schema:
            default: 0
            description: Number of conversations to skip
            examples:
              - 0
            minimum: 0
            title: Offset
            type: integer
        - description: Return conversation metadata with empty messages and a message_count
          in: query
          name: metadata_only
          required: false
          schema:
            default: false
            description: >-
              Return conversation metadata with empty messages and a
              message_count
            examples:
              - false
            title: Metadata Only
            type: boolean
        - in: header
          name: authorization
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
        - in: header
          name: x-ankra-organisation-id
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Ankra-Organisation-Id
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListChatConversationsResponse'
          description: Chat conversations retrieved successfully
        '401':
          description: Unauthorized
        '404':
          description: Not found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    ListChatConversationsResponse:
      properties:
        conversations:
          items:
            $ref: '#/components/schemas/ChatConversation'
          title: Conversations
          type: array
        total_count:
          type: integer
          title: Total Count
      required:
        - conversations
        - total_count
      title: ListChatConversationsResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ChatConversation:
      properties:
        cluster_id:
          anyOf:
            - format: uuid4
              type: string
            - type: 'null'
          title: Cluster Id
        cluster_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Cluster Name
        context_summary:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Context Summary
        created_at:
          format: date-time
          type: string
          title: Created At
        id:
          format: uuid4
          title: Id
          type: string
        message_count:
          anyOf:
            - type: integer
            - type: 'null'
          description: Total stored messages; set when the list was fetched metadata-only
          title: Message Count
        messages:
          items:
            $ref: '#/components/schemas/ChatMessage'
          title: Messages
          type: array
        organisation_id:
          format: uuid4
          title: Organisation Id
          type: string
        question_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Question Type
        title:
          type: string
          title: Title
        updated_at:
          format: date-time
          type: string
          title: Updated At
        user_id:
          title: User Id
          type: string
      required:
        - id
        - user_id
        - organisation_id
        - cluster_id
        - title
        - question_type
        - messages
        - context_summary
        - created_at
        - updated_at
      title: ChatConversation
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    ChatMessage:
      properties:
        actionResult:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: >-
            Confirmed action outcome attached to this message (drives the inline
            result card)
          title: Actionresult
        complete:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Complete analysis with suggestions and links
          title: Complete
        content:
          description: Message content
          title: Content
          type: string
        context:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Context information
          title: Context
        hidden:
          anyOf:
            - type: boolean
            - type: 'null'
          description: >-
            System-generated continuation turn persisted for model context only;
            never rendered in the transcript
          title: Hidden
        id:
          anyOf:
            - type: string
            - type: 'null'
          description: Message ID
          title: Id
        parts:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: >-
            Ordered content parts (text, thinking, tools, question, error, card,
            stack-preview) in stream order. Opaque to the backend; rendered by
            the portal.
          title: Parts
        pendingActions:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Action proposals awaiting confirmation when the message was saved
          title: Pendingactions
        pendingQuestion:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Structured question awaiting a user answer
          title: Pendingquestion
        plan:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Plan proposal and step results for plan mode messages
          title: Plan
        redactions:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: 'Stream secret-filter summary: pattern_counts, total, sample_tokens'
          title: Redactions
        role:
          description: 'Message role: user or assistant'
          title: Role
          type: string
        structuredBlocks:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Structured blocks emitted by the AI stream
          title: Structuredblocks
        timestamp:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: Message timestamp
          title: Timestamp
        toolsUsed:
          anyOf:
            - items:
                $ref: '#/components/schemas/ToolUsedInfo'
              type: array
            - type: 'null'
          description: Tools used to generate response
          title: Toolsused
        triage:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Triage information
          title: Triage
        verificationMismatch:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: >-
            Grounding-verifier contradictions surfaced for this message:
            {contradictions: [{resource_name, claim_value, claim_type,
            offending_excerpt, execution_status, error_excerpt}]}
          title: Verificationmismatch
      required:
        - role
        - content
      title: ChatMessage
      type: object
    ToolUsedInfo:
      properties:
        category:
          anyOf:
            - type: string
            - type: 'null'
          description: Tool category for grouping in the UI
          title: Category
        durationMs:
          anyOf:
            - type: integer
            - type: 'null'
          description: Tool execution duration in milliseconds, server-reported
          title: Durationms
        error:
          anyOf:
            - type: string
            - type: 'null'
          description: Sanitized error message when status is error
          title: Error
        id:
          description: Tool execution ID
          title: Id
          type: string
        parametersPreview:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Sanitized snapshot of the tool input parameters
          title: Parameterspreview
        resultCount:
          anyOf:
            - type: integer
            - type: 'null'
          description: Number of items retrieved
          title: Resultcount
        resultPreview:
          anyOf:
            - {}
            - type: 'null'
          description: Sanitized, truncated snapshot of the tool result for drill-down
          title: Resultpreview
        status:
          description: 'Tool execution status: success or error'
          title: Status
          type: string
        toolName:
          description: Name of the tool used
          title: Toolname
          type: string
      required:
        - id
        - toolName
        - status
      title: ToolUsedInfo
      type: object

````