> ## Documentation Index > Fetch the complete documentation index at: https://ago.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get Thread > Get a conversation thread by ID, including all of its messages with sources, feedback, tool calls, and attachments. API keys are admin-scoped, so admin/evaluation fields are always included. ## OpenAPI ````yaml /openapi-v1.json get /api/v1/conversations/{thread_id} openapi: 3.1.0 info: title: AGO Public API version: 1.0.0 description: Programmatic access to your AGO workspace. servers: - url: https://{tenant_id}.api.useago.com description: AGO Public API v1 variables: tenant_id: default: your-tenant-id description: Your AGO tenant identifier security: [] paths: /api/v1/conversations/{thread_id}: get: tags: - Conversations summary: Get Thread description: >- Get a conversation thread by ID, including all of its messages with sources, feedback, tool calls, and attachments. API keys are admin-scoped, so admin/evaluation fields are always included. operationId: core_api_v1_controllers_conversations_get_thread parameters: - in: path name: thread_id schema: title: Thread Id type: string required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ThreadWithMessagesOut' security: - ScopedAPIKeyAuth: [] components: schemas: ThreadWithMessagesOut: description: |- Full payload returned by ``GET /api/v1/conversations/{thread_id}`` — thread metadata plus all of its messages. Admin/evaluation fields are populated because Public API v1 keys are admin-scoped. properties: object: default: thread title: Object type: string id: title: Id type: string title: anyOf: - type: string - type: 'null' title: Title user: $ref: '#/components/schemas/ThreadUserOut' messages: default: [] items: $ref: '#/components/schemas/ThreadMessageOut' title: Messages type: array ticket: anyOf: - $ref: '#/components/schemas/ThreadTicketOut' - type: 'null' allowed_to_create_ticket: default: true title: Allowed To Create Ticket type: boolean message_if_not_allowed: default: '' title: Message If Not Allowed type: string ask_to_talk_to_human: default: false title: Ask To Talk To Human type: boolean last_message_date: anyOf: - format: date-time type: string - type: 'null' title: Last Message Date satisfaction_feedback: anyOf: - additionalProperties: true type: object - type: 'null' title: Satisfaction Feedback creation_date: anyOf: - format: date-time type: string - type: 'null' title: Creation Date evaluation: anyOf: - type: string - type: 'null' title: Evaluation evaluation_comment: anyOf: - type: string - type: 'null' title: Evaluation Comment llm_judge_evaluated: anyOf: - type: boolean - type: 'null' title: Llm Judge Evaluated llm_judge_need_review: anyOf: - type: boolean - type: 'null' title: Llm Judge Need Review llm_judge_improvement: anyOf: - type: string - type: 'null' title: Llm Judge Improvement cx_score: anyOf: - type: number - type: 'null' title: Cx Score cx_score_data: anyOf: - additionalProperties: true type: object - type: 'null' title: Cx Score Data reviewer: anyOf: - $ref: '#/components/schemas/ThreadReviewerOut' - type: 'null' admin_status: anyOf: - $ref: '#/components/schemas/ThreadAdminStatusFullOut' - type: 'null' required: - id - user title: ThreadWithMessagesOut type: object ThreadUserOut: properties: id: format: uuid title: Id type: string email: anyOf: - type: string - type: 'null' title: Email additionalInfo: anyOf: - additionalProperties: true type: object - type: 'null' title: Additionalinfo required: - id title: ThreadUserOut type: object ThreadMessageOut: properties: id: title: Id type: string content: default: '' title: Content type: string role: anyOf: - type: string - type: 'null' title: Role status: anyOf: - type: string - type: 'null' title: Status reaction: anyOf: - type: boolean - type: 'null' title: Reaction ask_to_talk_to_human: anyOf: - type: boolean - type: 'null' title: Ask To Talk To Human createdAt: anyOf: - type: string - type: 'null' title: Createdat agent: anyOf: - $ref: '#/components/schemas/MessageAgentOut' - type: 'null' routed_from_agent: anyOf: - $ref: '#/components/schemas/MessageRoutedFromAgentOut' - type: 'null' from_user: anyOf: - $ref: '#/components/schemas/MessageFromUserOut' - type: 'null' knowledge_sources: default: [] items: $ref: '#/components/schemas/MessageKnowledgeSourceOut' title: Knowledge Sources type: array feedback: anyOf: - $ref: '#/components/schemas/MessageFeedbackOut' - type: 'null' tool_call_data: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Tool Call Data attachments: anyOf: - items: $ref: '#/components/schemas/MessageAttachmentOut' type: array - type: 'null' title: Attachments required: - id title: ThreadMessageOut type: object ThreadTicketOut: properties: id: title: Id type: string subject: anyOf: - type: string - type: 'null' title: Subject product: anyOf: - type: string - type: 'null' title: Product typology: anyOf: - type: string - type: 'null' title: Typology priority: anyOf: - type: string - type: 'null' title: Priority body: anyOf: - type: string - type: 'null' title: Body ticket_url: anyOf: - type: string - type: 'null' title: Ticket Url required: - id title: ThreadTicketOut type: object ThreadReviewerOut: properties: id: title: Id type: string email: anyOf: - type: string - type: 'null' title: Email first_name: anyOf: - type: string - type: 'null' title: First Name last_name: anyOf: - type: string - type: 'null' title: Last Name required: - id title: ThreadReviewerOut type: object ThreadAdminStatusFullOut: properties: id: title: Id type: string name: title: Name type: string description: anyOf: - type: string - type: 'null' title: Description color: anyOf: - type: string - type: 'null' title: Color required: - id - name title: ThreadAdminStatusFullOut type: object MessageAgentOut: properties: id: title: Id type: string name: title: Name type: string icon: anyOf: - type: string - type: 'null' title: Icon customIcon: anyOf: - type: string - type: 'null' title: Customicon number_docs_to_display: anyOf: - type: integer - type: 'null' title: Number Docs To Display displayName: anyOf: - type: string - type: 'null' title: Displayname is_background_agent: default: false title: Is Background Agent type: boolean required: - id - name title: MessageAgentOut type: object MessageRoutedFromAgentOut: properties: id: title: Id type: string name: title: Name type: string icon: anyOf: - type: string - type: 'null' title: Icon customIcon: anyOf: - type: string - type: 'null' title: Customicon displayName: anyOf: - type: string - type: 'null' title: Displayname required: - id - name title: MessageRoutedFromAgentOut type: object MessageFromUserOut: properties: id: format: uuid title: Id type: string email: anyOf: - type: string - type: 'null' title: Email required: - id title: MessageFromUserOut type: object MessageKnowledgeSourceOut: properties: id: title: Id type: string knowledge_document: $ref: '#/components/schemas/KnowledgeDocumentSummaryOut' position: title: Position type: integer clicks: default: [] items: additionalProperties: true type: object title: Clicks type: array clicks_count: default: 0 title: Clicks Count type: integer required: - id - knowledge_document - position title: MessageKnowledgeSourceOut type: object MessageFeedbackOut: description: Shape returned by ``format_feedback_for_response`` (camelCase). properties: id: title: Id type: string messageId: anyOf: - type: string - type: 'null' title: Messageid inaccurate: default: false title: Inaccurate type: boolean incomplete: default: false title: Incomplete type: boolean informationNotFound: default: false title: Informationnotfound type: boolean technicalIssue: default: false title: Technicalissue type: boolean additionalFeedback: anyOf: - type: string - type: 'null' title: Additionalfeedback createdAt: anyOf: - type: string - type: 'null' title: Createdat threadId: anyOf: - type: string - type: 'null' title: Threadid evaluationComment: anyOf: - type: string - type: 'null' title: Evaluationcomment thread: anyOf: - additionalProperties: true type: object - type: 'null' title: Thread userEmail: anyOf: - type: string - type: 'null' title: Useremail required: - id title: MessageFeedbackOut type: object MessageAttachmentOut: properties: id: title: Id type: string name: anyOf: - type: string - type: 'null' title: Name content_type: anyOf: - type: string - type: 'null' title: Content Type file_size: anyOf: - type: integer - type: 'null' title: File Size uploaded_at: anyOf: - type: string - type: 'null' title: Uploaded At file_url: anyOf: - type: string - type: 'null' title: File Url is_safe_image: default: false title: Is Safe Image type: boolean required: - id title: MessageAttachmentOut type: object KnowledgeDocumentSummaryOut: properties: id: title: Id type: string title: anyOf: - type: string - type: 'null' title: Title page_id: anyOf: - type: string - type: 'null' title: Page Id knowledge_source: $ref: '#/components/schemas/KnowledgeSourceMetaOut' use_external_link: default: false title: Use External Link type: boolean external_link_url: anyOf: - type: string - type: 'null' title: External Link Url internal_link_url: anyOf: - type: string - type: 'null' title: Internal Link Url required: - id - knowledge_source title: KnowledgeDocumentSummaryOut type: object KnowledgeSourceMetaOut: properties: name: title: Name type: string documents_use_external_link: default: false title: Documents Use External Link type: boolean required: - name title: KnowledgeSourceMetaOut type: object securitySchemes: ScopedAPIKeyAuth: type: apiKey in: header name: X-API-Key ````