---
title: "Get agent conversation"
method: GET
path: "/v0/agents/{id}/conversation"
---

# Get agent conversation

`GET /v0/agents/{id}/conversation`

## Request

- Base URL: `https://api.cursor.com`
- URL: `https://api.cursor.com/v0/agents/{id}/conversation`
- Auth: HTTP bearer

Retrieve the conversation history of a cloud agent, including all user prompts and assistant responses

## Path parameters

- `id` string, required

## Response `200`

Conversation retrieved successfully

- object
  - `id` string, required: Unique identifier for the cloud agent
  - `messages` object[], required: Array of conversation messages ordered chronologically
    - `id` string, required: Unique identifier for the message
    - `type` 'user_message' | 'assistant_message', required: Type of message - either from the user or the model
    - `text` string, required: The content of the message

## Other responses

- `400`: Invalid request - bad agent ID format
- `401`: Unauthorized - invalid or missing API key
- `403`: Forbidden - insufficient permissions
- `404`: Agent not found or access denied
- `409`: Conflict - agent is deleted or archived
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/cursor/apis/cursor-cloud-agents-api.md) - [All operations](https://skmtc.dev/cursor/apis/cursor-cloud-agents-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cursor/apis/cursor-cloud-agents-api/revisions/62c9131c7ea0?raw)