Delete Thread

DELETE

/api/chat/threads/{thread_id}

• DivinityEngine - Local development
• DivinityEngine - Localhost alternative

Delete a conversation thread

Permanently deletes a conversation thread and all its messages. This action cannot be undone.

Args: request: FastAPI request object thread_id: Thread identifier to delete backend: Backend service instance (injected via dependency)

Returns: ThreadDeleteResponse: Deletion confirmation

Parameters

Path Parameters

thread_id

required

Thread Id

string

Responses

200

Successful Response

ThreadDeleteResponse

Thread deletion response model - ULTRA-COMPLETE (40+ fields).

Confirms successful deletion of a conversation thread and all its messages.

Fields: status: Deletion status (“success”, “error”) message: Human-readable confirmation message thread_id: ID of deleted thread

Used By: - DELETE /api/chat/threads/{thread_id} endpoint - Thread deletion confirmation - Thread management UI

object

status

required

Status

Deletion status (‘success’ or ‘error’)

string

message

required

Message

Human-readable confirmation message

string

threadId

required

Threadid

ID of deleted thread

string

deletedMessageCount

Any of:

integer

integer

null

null

deletedAt

Any of:

string

string

null

null

deletedBy

Any of:

string

string

null

null

softDelete

Any of:

boolean

boolean

null

null

permanentDelete

Any of:

boolean

boolean

null

null

canRestore

Any of:

boolean

boolean

null

null

restoreUntil

Any of:

string

string

null

null

threadTitle

Any of:

string

string

null

null

projectId

Any of:

string

string

null

null

conversationId

Any of:

string

string

null

null

requestId

Any of:

string

string

null

null

userId

Any of:

string

string

null

null

sessionId

Any of:

string

string

null

null

traceId

Any of:

string

string

null

null

correlationId

Any of:

string

string

null

null

operationDurationMs

Any of:

number

number

null

null

apiVersion

Any of:

string

string

null

null

serverVersion

Any of:

string

string

null

null

clientVersion

Any of:

string

string

null

null

timestamp

Any of:

string

string

null

null

errors

Any of:

Array<string>

Array<string>

null

null

warnings

Any of:

Array<string>

Array<string>

null

null

errorCount

Any of:

integer

integer

null

null

warningCount

Any of:

integer

integer

null

null

auditLogId

Any of:

string

string

null

null

backupCreated

Any of:

boolean

boolean

null

null

backupLocation

Any of:

string

string

null

null

environment

Any of:

string

string

null

null

region

Any of:

string

string

null

null

customMetadata

Any of:

CustomMetadataInfo

CustomMetadataInfo

Custom metadata container for extensibility.

Provides a structured container for custom key-value metadata that doesn’t fit into predefined fields. Supports common metadata patterns.

Fields: tags: List of tags for categorization labels: Key-value labels annotations: Additional annotations source: Data source identifier version: Data version

Used By: - Various models’ custom_metadata fields

object

tags

Any of:

Array<string>

Array<string>

null

null

labels

Any of:

object

object

key

additional properties

string

null

null

annotations

Any of:

object

object

key

additional properties

string

null

null

source

Any of:

string

string

null

null

version

Any of:

string

string

null

null

extra

Any of:

object

object

key

additional properties

string

null

null

null

null

deprecationNotice

Any of:

string

string

null

null

migrationGuide

Any of:

string

string

null

null

extra

Any of:

CustomMetadataInfo

CustomMetadataInfo

Custom metadata container for extensibility.

Provides a structured container for custom key-value metadata that doesn’t fit into predefined fields. Supports common metadata patterns.

Fields: tags: List of tags for categorization labels: Key-value labels annotations: Additional annotations source: Data source identifier version: Data version

Used By: - Various models’ custom_metadata fields

object

tags

Any of:

Array<string>

Array<string>

null

null

labels

Any of:

object

object

key

additional properties

string

null

null

annotations

Any of:

object

object

key

additional properties

string

null

null

source

Any of:

string

string

null

null

version

Any of:

string

string

null

null

extra

Any of:

object

object

key

additional properties

string

null

null

null

null

422

Validation Error

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object