Conversations

Get Conversations

get

Authorizations

APIKeyHeader

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

has_morebooleanRequired

first_idany ofOptional

stringOptional

or

nullOptional

last_idany ofOptional

stringOptional

or

nullOptional

422

Validation Error

application/json

get

/projects/{project_id}/conversations

HTTPcURLJavaScriptPython

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": "2026-02-19T15:09:08.155Z",
      "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

APIKeyHeaderOAuth2PasswordBearer

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

has_morebooleanRequired

first_idany ofOptional

stringOptional

or

nullOptional

last_idany ofOptional

stringOptional

or

nullOptional

422

Validation Error

application/json

get

/projects/{project_id}/sso/conversations

HTTPcURLJavaScriptPython

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": "2026-02-19T15:09:08.155Z",
      "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

APIKeyHeader

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

typestringOptionalDefault: conversation

idstringRequired

titlestringRequired

created_atstring · date-timeRequired

is_archivedbooleanOptionalDefault: false

project_idstringRequired

user_idstringRequired

last_message_idany ofOptional

stringOptional

or

nullOptional

422

Validation Error

application/json

post

/projects/{project_id}/conversations/{conversation_id}/archive

HTTPcURLJavaScriptPython

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": "2026-02-19T15:09:08.155Z",
  "is_archived": false,
  "project_id": "text",
  "user_id": "text",
  "last_message_id": "text"
}

Delete Conversation

delete

Authorizations

APIKeyHeader

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

anyOptional

422

Validation Error

application/json

delete

/projects/{project_id}/conversations/{conversation_id}

HTTPcURLJavaScriptPython

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

APIKeyHeader

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

application/json

titlestringRequired

Responses

200

Successful Response

application/json

typestringOptionalDefault: conversation

idstringRequired

titlestringRequired

created_atstring · date-timeRequired

is_archivedbooleanOptionalDefault: false

project_idstringRequired

user_idstringRequired

last_message_idany ofOptional

stringOptional

or

nullOptional

422

Validation Error

application/json

post

/projects/{project_id}/conversations/{conversation_id}/rename

HTTPcURLJavaScriptPython

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": "2026-02-19T15:09:08.155Z",
  "is_archived": false,
  "project_id": "text",
  "user_id": "text",
  "last_message_id": "text"
}