Project Chat Deletion Endpoint

Overview

This endpoint allows users to delete a specific chat conversation from a project.

Request Details

HTTP Method

DELETE

Route

/api/users/[user_id]/projects/[project_id]/chats/[chat_id]

Route Parameters

Parameter	Type	Required	Description
user_id	integer	Yes	The ID of the authenticated user
project_id	integer	Yes	The ID of the project
chat_id	integer	Yes	The ID of the chat to delete

Headers

Header	Value	Required	Description
Accept	application/json	Yes	Specifies the response format
Cookie	neptun-session	Yes	Session authentication cookie

Query Parameters

No query parameters required.

Request Body

No request body required.

Response Format

Response Status Codes

Status Code	Description
200	Successfully deleted chat
401	Unauthorized (invalid or missing session)
404	Chat or project not found
500	Server error

Success Response (200 OK)

Returns true on successful deletion.

true

Error Response (404 Not Found)

{
  "statusCode": 404,
  "statusMessage": "Not Found",
  "message": "Chat not found"
}

TypeScript Interface

type ApiResponse = boolean

Python Model

from pydantic import BaseModel

class ApiResponse(BaseModel):
    success: bool

Code Examples

cURL Example

curl -X DELETE "https://neptun-webui.vercel.app/api/users/1/projects/1/chats/1" \
  -H "Accept: application/json" \
  -H "Cookie: neptun-session=your-session-cookie"

Python Example

import httpx

async def delete_project_chat(
    user_id: int,
    project_id: int,
    chat_id: int,
    session_cookie: str
) -> bool:
    url = f"https://neptun-webui.vercel.app/api/users/{user_id}/projects/{project_id}/chats/{chat_id}"

    async with httpx.AsyncClient() as client:
        response = await client.delete(
            url,
            headers={
                "Accept": "application/json",
                "Cookie": f"neptun-session={session_cookie}"
            }
        )
        response.raise_for_status()
        return response.json()

TypeScript/JavaScript Example

async function deleteProjectChat(
  userId: number,
  projectId: number,
  chatId: number,
  sessionCookie: string
): Promise<boolean> {
  const response = await fetch(
    `https://neptun-webui.vercel.app/api/users/${userId}/projects/${projectId}/chats/${chatId}`,
    {
      method: 'DELETE',
      headers: {
        Accept: 'application/json',
        Cookie: `neptun-session=${sessionCookie}`,
      },
    }
  )

  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`)
  }

  return await response.json()
}

Notes

• The session cookie is required for authentication
• The chat must belong to the specified project
• Both the project-chat link and the actual chat conversation will be deleted
• This operation cannot be undone