# Conversations

## GET /projects/{project\_id}/conversations

> Get Conversations

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"APIKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","description":"API Key. [Learn how to get it](/docs/api-reference/how-to-get-credentials).","in":"header","name":"X-API-Key"}},"schemas":{"InfinitePagination_Conversation_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Conversation"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"first_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Id"},"last_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Id"}},"type":"object","required":["data","has_more"],"title":"InfinitePagination[Conversation]"},"Conversation":{"properties":{"type":{"type":"string","title":"Type","default":"conversation"},"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"is_archived":{"type":"boolean","title":"Is Archived","default":false},"project_id":{"type":"string","title":"Project Id"},"user_id":{"type":"string","title":"User Id"},"last_message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Message Id"}},"type":"object","required":["id","title","created_at","project_id","user_id"],"title":"Conversation"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"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"}}},"paths":{"/projects/{project_id}/conversations":{"get":{"tags":["conversations"],"summary":"Get Conversations","operationId":"get_conversations_projects__project_id__conversations_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"X-User-Id","in":"header","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-User-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfinitePagination_Conversation_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## GET /projects/{project\_id}/sso/conversations

> Get Conversations Sso

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"APIKeyHeader":[]},{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","description":"API Key. [Learn how to get it](/docs/api-reference/how-to-get-credentials).","in":"header","name":"X-API-Key"},"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}}}},"schemas":{"InfinitePagination_Conversation_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Conversation"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"first_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Id"},"last_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Id"}},"type":"object","required":["data","has_more"],"title":"InfinitePagination[Conversation]"},"Conversation":{"properties":{"type":{"type":"string","title":"Type","default":"conversation"},"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"is_archived":{"type":"boolean","title":"Is Archived","default":false},"project_id":{"type":"string","title":"Project Id"},"user_id":{"type":"string","title":"User Id"},"last_message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Message Id"}},"type":"object","required":["id","title","created_at","project_id","user_id"],"title":"Conversation"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"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"}}},"paths":{"/projects/{project_id}/sso/conversations":{"get":{"tags":["conversations"],"summary":"Get Conversations Sso","operationId":"get_conversations_sso_projects__project_id__sso_conversations_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"X-User-Id","in":"header","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-User-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfinitePagination_Conversation_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## POST /projects/{project\_id}/conversations/{conversation\_id}/archive

> Archive Conversation

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"APIKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","description":"API Key. [Learn how to get it](/docs/api-reference/how-to-get-credentials).","in":"header","name":"X-API-Key"}},"schemas":{"Conversation":{"properties":{"type":{"type":"string","title":"Type","default":"conversation"},"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"is_archived":{"type":"boolean","title":"Is Archived","default":false},"project_id":{"type":"string","title":"Project Id"},"user_id":{"type":"string","title":"User Id"},"last_message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Message Id"}},"type":"object","required":["id","title","created_at","project_id","user_id"],"title":"Conversation"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"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"}}},"paths":{"/projects/{project_id}/conversations/{conversation_id}/archive":{"post":{"tags":["conversations"],"summary":"Archive Conversation","operationId":"archive_conversation_projects__project_id__conversations__conversation_id__archive_post","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}},{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"is_archived","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Is Archived"}},{"name":"X-User-Id","in":"header","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-User-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## DELETE /projects/{project\_id}/conversations/{conversation\_id}

> Delete Conversation

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"APIKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","description":"API Key. [Learn how to get it](/docs/api-reference/how-to-get-credentials).","in":"header","name":"X-API-Key"}},"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"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"}}},"paths":{"/projects/{project_id}/conversations/{conversation_id}":{"delete":{"tags":["conversations"],"summary":"Delete Conversation","operationId":"delete_conversation_projects__project_id__conversations__conversation_id__delete","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}},{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"X-User-Id","in":"header","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-User-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Rename Conversation

> Rename a conversation.\
> \
> Args:\
>     conversation\_id: The ID of the conversation to rename\
>     request: The request containing the new title\
>     project\_metadata: The metadata of the project the conversation belongs to\
>     conversation\_service: Service for managing conversations\
>     user\_id: ID of the authenticated user\
> \
> Returns:\
>     The updated conversation

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"APIKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","description":"API Key. [Learn how to get it](/docs/api-reference/how-to-get-credentials).","in":"header","name":"X-API-Key"}},"schemas":{"apps__modules__chat__submodules__conversations__api__router__RenameConversationRequest":{"properties":{"title":{"type":"string","title":"Title"}},"type":"object","required":["title"],"title":"RenameConversationRequest"},"Conversation":{"properties":{"type":{"type":"string","title":"Type","default":"conversation"},"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"is_archived":{"type":"boolean","title":"Is Archived","default":false},"project_id":{"type":"string","title":"Project Id"},"user_id":{"type":"string","title":"User Id"},"last_message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Message Id"}},"type":"object","required":["id","title","created_at","project_id","user_id"],"title":"Conversation"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"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"}}},"paths":{"/projects/{project_id}/conversations/{conversation_id}/rename":{"post":{"tags":["conversations"],"summary":"Rename Conversation","description":"Rename a conversation.\n\nArgs:\n    conversation_id: The ID of the conversation to rename\n    request: The request containing the new title\n    project_metadata: The metadata of the project the conversation belongs to\n    conversation_service: Service for managing conversations\n    user_id: ID of the authenticated user\n\nReturns:\n    The updated conversation","operationId":"rename_conversation_projects__project_id__conversations__conversation_id__rename_post","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}},{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"X-User-Id","in":"header","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-User-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/apps__modules__chat__submodules__conversations__api__router__RenameConversationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```