> ## Documentation Index > Fetch the complete documentation index at: https://docs.dimedove.com/llms.txt > Use this file to discover all available pages before exploring further. # Get conversation > Retrieves a single conversation with its complete history of messages and function calls, sorted chronologically. ## OpenAPI ````yaml /openapi/apps-api.json get /apps/{app_id}/conversations/{conversation_id} openapi: 3.1.0 info: title: Dimedove API version: 1.0.0 description: >- Programmatically manage conversations and interact with your AI agents through the Dimedove API. servers: - url: https://api.dimedove.com/v1 description: Production security: [] paths: /apps/{app_id}/conversations/{conversation_id}: get: tags: - Conversations summary: Get conversation description: >- Retrieves a single conversation with its complete history of messages and function calls, sorted chronologically. operationId: apps_api_get_conversation parameters: - in: path name: app_id schema: description: The unique identifier of the app. title: App Id type: string required: true description: The unique identifier of the app. - in: path name: conversation_id schema: description: The unique identifier of the conversation. title: Conversation Id type: string required: true description: The unique identifier of the conversation. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ConversationDetailSchema' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/OpenAIErrorSchema' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/OpenAIErrorSchema' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/OpenAIErrorSchema' security: - AppsApiKeyAuth: [] components: schemas: ConversationDetailSchema: properties: id: description: Unique identifier for the conversation. title: Id type: string object: default: conversation description: The object type. Always 'conversation'. title: Object type: string created_at: description: Unix timestamp (in seconds) of when the conversation was created. title: Created At type: integer external_user_id: anyOf: - type: string - type: 'null' description: >- The external user identifier associated with this conversation, if one was provided at creation. title: External User Id title: anyOf: - type: string - type: 'null' description: The custom title set for this conversation, if any. title: Title generated_title: anyOf: - additionalProperties: type: string type: object - type: 'null' description: >- AI-generated conversation title in supported locales. Keys are locale codes (e.g. 'en-ca', 'fr-ca'). example: en-ca: fr-ca: title: Generated Title metadata: anyOf: - additionalProperties: true type: object - type: 'null' description: >- The latest metadata snapshot associated with this conversation, if any has been provided. title: Metadata items: default: [] description: The list of messages in the conversation. items: $ref: '#/components/schemas/ConversationItemSchema' title: Items type: array required: - id - created_at title: ConversationDetailSchema type: object OpenAIErrorSchema: properties: error: $ref: '#/components/schemas/OpenAIErrorDetail' description: The error detail object. required: - error title: OpenAIErrorSchema type: object ConversationItemSchema: properties: id: description: Unique identifier for the message. title: Id type: string type: default: message description: The type of the item. Always 'message'. title: Type type: string role: description: The role of the message author (e.g. 'user', 'assistant'). title: Role type: string parts: default: [] description: >- The content parts of the message. Can be text, tool call, or data-spec parts. items: anyOf: - $ref: '#/components/schemas/TextPartSchema' - $ref: '#/components/schemas/ToolCallPartSchema' - $ref: '#/components/schemas/DataSpecPartSchema' title: Parts type: array created_at: description: Unix timestamp of when the message was created. title: Created At type: integer required: - id - role - created_at title: ConversationItemSchema type: object OpenAIErrorDetail: properties: message: description: A human-readable description of the error. title: Message type: string type: description: >- The error type identifier (e.g. 'invalid_api_key', 'not_found', 'rate_limit_exceeded'). title: Type type: string param: anyOf: - type: string - type: 'null' description: The parameter that caused the error, if applicable. title: Param code: anyOf: - type: string - type: 'null' description: An error code providing additional detail, if applicable. title: Code required: - message - type title: OpenAIErrorDetail type: object TextPartSchema: properties: type: default: text description: The type of the part. Always 'text' for text parts. title: Type type: string text: description: The text content. title: Text type: string required: - text title: TextPartSchema type: object ToolCallPartSchema: properties: type: default: tool-call description: The type of the part. Always 'tool-call' for tool call parts. title: Type type: string toolCallId: description: Unique identifier for the tool call. title: Toolcallid type: string toolName: description: The name of the tool that was called. title: Toolname type: string input: additionalProperties: true default: {} description: The input arguments passed to the tool. title: Input type: object output: anyOf: - additionalProperties: true type: object - type: 'null' description: The output returned by the tool. title: Output required: - toolCallId - toolName title: ToolCallPartSchema type: object DataSpecPartSchema: properties: type: default: data-spec description: >- The type of the part. Always 'data-spec' for generative UI spec parts. Only returned when generative UI is enabled on the application. title: Type type: string data: additionalProperties: true description: The spec data payload (e.g. patch operations for generative UI). title: Data type: object required: - data title: DataSpecPartSchema type: object securitySchemes: AppsApiKeyAuth: type: http scheme: bearer ````