# Get assistant conversation thread (/api/analytics/assistant-thread)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1740 · updated: 2026-09-23 -->
Related: [Get feedback](/api/analytics/feedback.md), [Get feedback by page](/api/analytics/feedback-by-page.md), [Get assistant conversations](/api/analytics/assistant-conversations.md), [Get assistant caller stats](/api/analytics/assistant-caller-stats.md), [Get search queries](/api/analytics/searches.md), [Get page views](/api/analytics/views.md)

## Usage [#usage]

Use this endpoint to fetch the full message transcript of a single assistant conversation as JSON. The response includes the ordered list of user and assistant messages, each with an ID, role, content, and timestamp.

Common uses:

* Attach the conversation transcript to a support ticket when a user reaches out from the assistant.
* Reconstruct a specific conversation for review, quality assurance, or offline analysis.

## Getting a thread ID [#getting-a-thread-id]

You can obtain a `threadId` from either of the following sources:

* The `id` field of any row returned by [Get assistant conversations](/api/analytics/assistant-conversations).
* The `threadId` query parameter that Mintlify appends to the support URL when the assistant deflects to your support platform using [link deflection](/assistant/configure#deflect-to-a-support-link).

## Rate limits [#rate-limits]

This endpoint allows 100 requests per organization per hour. All analytics endpoints share this limit.

`GET /v1/analytics/{projectId}/assistant/threads/{threadId}`

Returns the full message transcript for a single assistant conversation thread. The thread ID is available from the assistant conversations endpoint, or as the `threadId` query parameter appended to assistant link-mode deflection support URLs.

Authenticate with an admin API key.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "schema": {
        "type": "string",
        "description": "Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard."
      },
      "required": true,
      "name": "projectId",
      "in": "path"
    },
    {
      "schema": {
        "type": "string",
        "format": "ulid",
        "description": "Assistant conversation thread ID (ULID)."
      },
      "required": true,
      "name": "threadId",
      "in": "path"
    }
  ],
  "responses": {
    "200": {
      "description": "The conversation transcript",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "threadId": {
                "type": "string",
                "description": "Assistant conversation thread identifier (ULID)."
              },
              "createdAt": {
                "type": "string",
                "description": "Timestamp when the thread was created."
              },
              "messages": {
                "type": "array",
                "description": "Ordered list of messages exchanged in the thread.",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Unique message identifier."
                    },
                    "role": {
                      "type": "string",
                      "enum": [
                        "user",
                        "assistant"
                      ],
                      "description": "Whether the message was sent by the user or the assistant."
                    },
                    "content": {
                      "type": "string",
                      "description": "The text content of the message."
                    },
                    "createdAt": {
                      "type": "string",
                      "description": "Timestamp when the message was sent."
                    }
                  },
                  "required": [
                    "id",
                    "role",
                    "content",
                    "createdAt"
                  ]
                }
              }
            },
            "required": [
              "threadId",
              "createdAt",
              "messages"
            ]
          }
        }
      }
    },
    "400": {
      "description": "Invalid thread ID",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Error message describing what went wrong."
              },
              "details": {
                "type": "array",
                "description": "Additional details about the error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Description of a specific validation or processing error."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    },
    "404": {
      "description": "Thread not found",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Error message describing what went wrong."
              },
              "details": {
                "type": "array",
                "description": "Additional details about the error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Description of a specific validation or processing error."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    },
    "500": {
      "description": "Server error",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Error message describing what went wrong."
              },
              "details": {
                "type": "array",
                "description": "Additional details about the error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Description of a specific validation or processing error."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    }
  }
}
```