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

# Get Conversation Details

> Retrieves comprehensive details for a specific conversation including metadata, event history, and current status. Returns full conversation context with all messages and interactions.



## OpenAPI

````yaml api-reference/openapi.json get /api/v1/integration/conversations/{conversation_id}
openapi: 3.1.0
info:
  title: Thesis.io APIs
  description: >-
    Thesis.io provides comprehensive AI-powered research and conversation APIs
    for DeFi analysis and blockchain research. Create conversations with
    customizable research modes including chat, deep research, and specialized
    DeFi tools for real-time market analysis. Join existing conversations via
    streaming endpoints to participate in collaborative research sessions with
    advanced AI agents.
  version: 0.32.1
servers:
  - url: https://app-be.thesis.io
    description: Production Thesis APIs
security:
  - APIKeyAuth: []
  - {}
paths:
  /api/v1/integration/conversations/{conversation_id}:
    get:
      tags:
        - conversations
        - conversations
      summary: Get Conversation Details
      description: >-
        Retrieves comprehensive details for a specific conversation including
        metadata, event history, and current status. Returns full conversation
        context with all messages and interactions.
      operationId: >-
        integration_get_conversation_api_v1_integration_conversations__conversation_id__get
      parameters:
        - name: conversation_id
          in: path
          required: true
          schema:
            type: string
            title: Conversation Id
      responses:
        '200':
          description: Conversation details retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationDetailResponse'
        '400':
          description: Invalid request data or missing required fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationErrorResponse'
        '401':
          description: Authentication required to access conversation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/openhands__server__routes__integration__conversation__FastAPIUnauthorizedErrorResponse
        '404':
          description: Conversation not found or access denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FastAPIResourceNotFoundErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FastAPIErrorResponse'
      x-codeSamples:
        - lang: bash
          label: Get conversation details
          source: >-
            curl -X GET
            'https://app-be.thesis.io/api/v1/integration/conversations/conv_abc123def456'
            \
              -H 'Authorization: Bearer YOUR_SPACE_API_TOKEN'
        - lang: python
          label: Get conversation details
          source: >-
            import requests


            conversation_id = 'conv_abc123def456'

            url =
            f'https://app-be.thesis.io/api/v1/integration/conversations/{conversation_id}'

            headers = {
                'Authorization': 'Bearer YOUR_SPACE_API_TOKEN'
            }


            response = requests.get(url, headers=headers)

            print(response.json())
        - lang: typescript
          label: Get conversation details
          source: >-
            const conversationId = 'conv_abc123def456';

            const response = await
            fetch(`https://app-be.thesis.io/api/v1/integration/conversations/${conversationId}`,
            {
              method: 'GET',
              headers: {
                'Authorization': 'Bearer YOUR_SPACE_API_TOKEN'
              }
            });


            const data = await response.json();

            console.log(data);
components:
  schemas:
    ConversationDetailResponse:
      properties:
        conversation_id:
          type: string
          title: Conversation Id
          description: Unique conversation identifier
          example: conv_abc123def456
        title:
          type: string
          title: Title
          description: Conversation title
          example: Code Review Session
        status:
          type: string
          title: Status
          description: Current conversation status
          example: RUNNING
        created_at:
          type: string
          title: Created At
          description: ISO timestamp when conversation was created
          example: '2024-01-15T10:30:00Z'
        last_updated_at:
          type: string
          title: Last Updated At
          description: ISO timestamp of last activity
          example: '2024-01-15T11:45:00Z'
        selected_repository:
          anyOf:
            - type: string
            - type: 'null'
          title: Selected Repository
          description: Associated repository if any
          example: user/project-repo
        research_mode:
          anyOf:
            - type: string
            - type: 'null'
          title: Research Mode
          description: Research mode used in conversation
          example: deep_research
        events:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Events
          description: List of conversation events/messages
        final_result:
          anyOf:
            - type: string
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Final Result
          description: Final result if conversation is completed
      type: object
      required:
        - conversation_id
        - title
        - status
        - created_at
        - last_updated_at
        - selected_repository
        - research_mode
      title: ConversationDetailResponse
    ConversationErrorResponse:
      properties:
        status:
          type: string
          title: Status
          description: Error status, always 'error' for failures
          example: error
        message:
          type: string
          title: Message
          description: Human-readable error message
          example: Invalid request data or missing required fields
        msg_id:
          type: string
          title: Msg Id
          description: Machine-readable error code for categorization
          example: INVALID_REQUEST_DATA
      type: object
      required:
        - status
        - message
        - msg_id
      title: ConversationErrorResponse
    openhands__server__routes__integration__conversation__FastAPIUnauthorizedErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Error details from FastAPI
          example: Unauthorized or invalid token
      type: object
      required:
        - detail
      title: FastAPIUnauthorizedErrorResponse
    FastAPIResourceNotFoundErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Error details from FastAPI
          example: Resource not found
      type: object
      required:
        - detail
      title: FastAPIResourceNotFoundErrorResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FastAPIErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Error details from FastAPI
          example: Internal server error
      type: object
      required:
        - detail
      title: FastAPIErrorResponse
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Enter your API token in the format: Bearer <your_token_here>'

````