Conversations

Get Conversations

get
Authorizations
X-API-KeystringRequired

API Key. Learn how to get it.

Path parameters
project_idstringRequired
Header parameters
X-User-Idany ofRequired
stringOptional
or
nullOptional
Responses
200

Successful Response

application/json
get
/projects/{project_id}/conversations
GET /projects/{project_id}/conversations HTTP/1.1
Host: api.stack-ai.com
X-API-Key: YOUR_API_KEY
X-User-Id: text
Accept: */*

{
  "data": [
    {
      "type": "conversation",
      "id": "text",
      "title": "text",
      "created_at": "2025-11-28T01:31:40.342Z",
      "is_archived": false,
      "project_id": "text",
      "user_id": "text",
      "last_message_id": "text"
    }
  ],
  "has_more": true,
  "first_id": "text",
  "last_id": "text"
}

Get Conversations Sso

get
Authorizations
X-API-KeystringRequired

API Key. Learn how to get it.

Path parameters
project_idstringRequired
Header parameters
X-User-Idany ofRequired
stringOptional
or
nullOptional
Responses
200

Successful Response

application/json
get
/projects/{project_id}/sso/conversations
GET /projects/{project_id}/sso/conversations HTTP/1.1
Host: api.stack-ai.com
X-API-Key: YOUR_API_KEY
X-User-Id: text
Accept: */*

{
  "data": [
    {
      "type": "conversation",
      "id": "text",
      "title": "text",
      "created_at": "2025-11-28T01:31:40.342Z",
      "is_archived": false,
      "project_id": "text",
      "user_id": "text",
      "last_message_id": "text"
    }
  ],
  "has_more": true,
  "first_id": "text",
  "last_id": "text"
}

Archive Conversation

post
Authorizations
X-API-KeystringRequired

API Key. Learn how to get it.

Path parameters
conversation_idstringRequired
project_idstringRequired
Query parameters
is_archivedbooleanOptionalDefault: true
Header parameters
X-User-Idany ofRequired
stringOptional
or
nullOptional
Responses
200

Successful Response

application/json
post
/projects/{project_id}/conversations/{conversation_id}/archive
POST /projects/{project_id}/conversations/{conversation_id}/archive HTTP/1.1
Host: api.stack-ai.com
X-API-Key: YOUR_API_KEY
X-User-Id: text
Accept: */*

{
  "type": "conversation",
  "id": "text",
  "title": "text",
  "created_at": "2025-11-28T01:31:40.342Z",
  "is_archived": false,
  "project_id": "text",
  "user_id": "text",
  "last_message_id": "text"
}

Delete Conversation

delete
Authorizations
X-API-KeystringRequired

API Key. Learn how to get it.

Path parameters
conversation_idstringRequired
project_idstringRequired
Header parameters
X-User-Idany ofRequired
stringOptional
or
nullOptional
Responses
200

Successful Response

application/json
Responseany
delete
/projects/{project_id}/conversations/{conversation_id}
DELETE /projects/{project_id}/conversations/{conversation_id} HTTP/1.1
Host: api.stack-ai.com
X-API-Key: YOUR_API_KEY
X-User-Id: text
Accept: */*

No content

Rename Conversation

post

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

Authorizations
X-API-KeystringRequired

API Key. Learn how to get it.

Path parameters
conversation_idstringRequired
project_idstringRequired
Header parameters
X-User-Idany ofRequired
stringOptional
or
nullOptional
Body
titlestringRequired
Responses
200

Successful Response

application/json
post
/projects/{project_id}/conversations/{conversation_id}/rename
POST /projects/{project_id}/conversations/{conversation_id}/rename HTTP/1.1
Host: api.stack-ai.com
X-API-Key: YOUR_API_KEY
X-User-Id: text
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "title": "text"
}
{
  "type": "conversation",
  "id": "text",
  "title": "text",
  "created_at": "2025-11-28T01:31:40.342Z",
  "is_archived": false,
  "project_id": "text",
  "user_id": "text",
  "last_message_id": "text"
}
PreviousRun FlowNextMessages

Last updated

Was this helpful?