> ## 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: [] paths: /api/v1/chat/general/history: get: tags: - Chat API 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: title: Total Count type: integer 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 title: Created At type: string 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: title: Title type: string updated_at: format: date-time title: Updated At type: string 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 ````