> ## Documentation Index > Fetch the complete documentation index at: https://docs.truestate.io/llms.txt > Use this file to discover all available pages before exploring further. # Get Conversation ## OpenAPI ````yaml https://api.truestate.io/openapi.json get /conversations/{conversation_id} openapi: 3.1.0 info: title: TrueState Backend API summary: >- TrueState is an AI platform for business users to create high-impact AI solutions. description: > This **[TrueState](https://www.truestate.io/)** backend API allows our clients to automate and more powerfully retrieve and modify data from the TrueState platform. Example use cases include: - Accessing embeddings for a dataset. - Automating the process of dataset creation and model retraining as your data changes. - Much more. Our backend is built using the [FastAPI](https://fastapi.tiangolo.com/) framework in python using [Auth0](https://auth0.com/) and [Client API Keys](https://docs.truestate.io/docs/api/client-api-keys) for internal an external authentication, respectively. Our backend is designed to be secure, scalable, easy to use and well documented _(each router with its own linked docs page)_. Clients can only access data from their own organisation, as setup in Auth0 our the Client API Keys. See how **[here](https://docs.truestate.io/docs/api/overview)**. **PS**: You can view this API documentation in either **[Swagger](swagger/docs)** or **[Redoc](redoc/)**, but only the swagger lets you test calls. contact: name: True State Support url: http://docs.truestate.io/ email: support@truestate.io license: name: Private url: https://www.apache.org/licenses/LICENSE-2.0.html version: 0.11.78 servers: [] security: [] tags: - name: assistants description: Management of assistants - name: api-keys description: Management of each user personal Client API Keys, used to access this API. - name: models description: Management of models - name: secrets description: Management of client secrets for accessing external services - name: deployments description: Management of deployments. - name: pipelines description: Management of pipelines. - name: pipeline-runs description: Management of pipeline runs. - name: automations description: Management of Automations. - name: automation-sessions description: Management of Automation Sessions. - name: chatbots description: Chatbot endpoints. - name: check-auto-recharge description: '' - name: classification-classes description: >- Management of zero shot classifications (using ai to apply new categories to a dataset). - name: conversations description: Management of conversations - name: conventions description: Management of conventions - best practices for actuators and agents - name: credit-usage description: Management of Credits. - name: dashboards description: Management of Dashboards. - name: data description: Bigquery inference services - name: data-dictionary description: Data Dictionary endpoints. - name: datasets description: Dataset endpoints. - name: documents description: Document endpoints. - name: default description: Default health checks. - name: embedding-search description: '' - name: inference description: Model inference services - name: messages description: Management of messages - name: notebooks description: '' - name: notebook-services description: '' - name: organisations description: Management of Organisations. - name: payment-methods description: Management of Payment methods. - name: private-tasks description: '' - name: private-pipelines description: '' - name: private-data description: '' - name: renew-seats description: '' - name: tagging-lists description: Management of Tagging Lists. - name: tasks description: '' - name: task-templates description: Management of task templates (definitions and schedules). - name: agents description: '' - name: user description: Management of User. - name: user-context description: Management of User Context. - name: private-messages description: '' - name: private-llm-call description: '' - name: admin-organisations description: '' - name: private-warehouser description: '' - name: private-pipeline-tracking description: '' - name: private-pipeline-runs description: '' - name: private-reports description: '' - name: private-bootstrap description: '' - name: reports description: '' - name: private-conversations description: '' - name: private-datasets description: '' - name: private-dashboards description: '' - name: private-conventions description: '' - name: private-documents description: '' paths: /conversations/{conversation_id}: get: tags: - conversations summary: Get Conversation operationId: get_conversation_conversations__conversation_id__get parameters: - name: conversation_id in: path required: true schema: type: string title: Conversation Id - name: Api-key in: header required: false schema: anyOf: - type: string - type: 'null' title: Api-Key responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ConversationRead' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: ConversationRead: properties: id: type: string format: uuid title: Id title: type: string title: Title created_at: type: string format: date-time title: Created At context: anyOf: - $ref: '#/components/schemas/ConversationContext-Output' - type: 'null' last_assistant: anyOf: - type: string - type: 'null' title: Last Assistant associated_entity_id: anyOf: - type: string format: uuid - type: 'null' title: Associated Entity Id associated_entity_type: anyOf: - $ref: '#/components/schemas/AssociatedEntityType' - type: 'null' lease_epoch: anyOf: - type: integer - type: 'null' title: Lease Epoch last_user_message_at: anyOf: - type: string format: date-time - type: 'null' title: Last User Message At summary: anyOf: - type: string - type: 'null' title: Summary type: object required: - id - title - created_at - context - last_assistant title: ConversationRead HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ConversationContext-Output: properties: entities: items: $ref: '#/components/schemas/ContextEntity' type: array title: Entities default: [] type: object title: ConversationContext AssociatedEntityType: type: string enum: - DASHBOARD - PIPELINE - REPORT title: AssociatedEntityType 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 ContextEntity: properties: type: $ref: '#/components/schemas/ContextEntityType' id: type: string format: uuid title: Id type: object required: - type - id title: ContextEntity ContextEntityType: type: string enum: - DASHBOARD - PIPELINE - DATASET - REPORT - DOCUMENT title: ContextEntityType securitySchemes: HTTPBearer: type: http scheme: bearer ````