> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# GetConversation

# Package: containersApp

# Namespace: ContainersChat

# Method link: https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-chat/get-conversation.md

## Introduction

Retrieves a conversation by its ID.

---

## REST API

### Schema

```
 Method: getConversation
 Description: Retrieves a conversation by its GUID.
 URL: https://www.wixapis.com/containers/chat/v1/conversations/{conversationId}
 Method: GET
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  conversationId
 Method parameters: 
   param name: conversationId | type:   none | required: true 
 Return type: GetConversationResponse
  - name: conversation | type: Conversation | description: Retrieved conversation.  
     - name: id | type: string | description: Conversation GUID.  | read-only: true | validation: format GUID
     - name: projectId | type: string | description: GUID of the project this conversation belongs to.  | validation: format GUID
     - name: sessionId | type: string | description: Agent session GUID. Set when a build job begins; used to resume the coding agent session.  | validation: format GUID
     - name: status | type: ConversationStatus | description: Conversation status.  
         - enum:
         -     ACTIVE: The conversation is open and active.
         -     ARCHIVED: The conversation is archived. Currently not in use.
     - name: title | type: string | description: Conversation title. Currently defaults to `new chat`.  | validation: maxLength 200
     - name: createdDate | type: string | description: Date and time the conversation was created.  | read-only: true | validation: format date-time
     - name: updatedDate | type: string | description: Date and time the conversation was last updated.  | read-only: true | validation: format date-time
     - name: revision | type: string | description: Revision number, which increments by 1 each time the conversation is updated. To prevent conflicting changes, the current revision must be passed when updating the conversation.  | read-only: true | validation: format int64


```

### Examples

### Get Conversation
Retrieves a conversation by its ID.

```curl
curl -X GET \
  'https://www.wixapis.com/containers/chat/v1/conversations/1f5b2c8e-9a3d-4c21-8b77-2d2f6e0a9c10' \
  -H 'Authorization: <AUTH>'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.containers.chat.getConversation(conversationId)
 Description: Retrieves a conversation by its GUID.
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  conversationId
 Method parameters: 
   param name: conversationId | type: string | description: Conversation GUID. | required: true | validation: format GUID
 Return type: PROMISE<Conversation>
  - name: _id | type: string | description: Conversation GUID.  | read-only: true | validation: format GUID
  - name: projectId | type: string | description: GUID of the project this conversation belongs to.  | validation: format GUID
  - name: sessionId | type: string | description: Agent session GUID. Set when a build job begins; used to resume the coding agent session.  | validation: format GUID
  - name: status | type: ConversationStatus | description: Conversation status.  
     - enum:
     -     ACTIVE: The conversation is open and active.
     -     ARCHIVED: The conversation is archived. Currently not in use.
  - name: title | type: string | description: Conversation title. Currently defaults to `new chat`.  | validation: maxLength 200
  - name: _createdDate | type: Date | description: Date and time the conversation was created.  | read-only: true 
  - name: _updatedDate | type: Date | description: Date and time the conversation was last updated.  | read-only: true 
  - name: revision | type: string | description: Revision number, which increments by 1 each time the conversation is updated. To prevent conflicting changes, the current revision must be passed when updating the conversation.  | read-only: true | validation: format int64


```

### Examples

### Get a conversation by ID
```javascript
import { chat } from "@wix/containers";

async function getConversation() {
  const response = await chat.getConversation("1f5b2c8e-9a3d-4c21-8b77-2d2f6e0a9c10");
}

/* Promise resolves to:
 * {
 *   "_id": "1f5b2c8e-9a3d-4c21-8b77-2d2f6e0a9c10",
 *   "projectId": "8046df3c-7575-4098-a5ab-c91ad8f33c47",
 *   "status": "ACTIVE",
 *   "title": "new chat",
 *   "revision": 1,
 *   "_createdDate": "2026-07-29T09:00:00.000Z",
 *   "_updatedDate": "2026-07-29T09:00:00.000Z"
 * }
 */

```

### getConversation (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { chat } from '@wix/containers';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { chat },
  // Include the auth strategy and host as relevant
});


async function getConversation(conversationId) {
  const response = await myWixClient.chat.getConversation(conversationId);
};
```

---