Delete a knowledge base

DELETE

/v1/knowledge-bases/{kb_id}

• API base path

Delete a knowledge base and cascade-delete all its documents and chunks. This action is irreversible.

Authorizations

• BearerApiKey

Parameters

Path Parameters

kb_id

required

string

/^kb_/

Example

kb_a1b2c3d4e5

Knowledge base ID

Responses

200

Knowledge base deleted

object

data

required

object

deleted

required

boolean

Example

true

401

Authentication failed or missing

object

error

required

object

code

required

Machine-readable error code

string

Allowed values: VALIDATION_ERROR AUTHENTICATION_ERROR NOT_FOUND CONFLICT RATE_LIMIT_EXCEEDED USAGE_LIMIT_EXCEEDED EXTERNAL_SERVICE_ERROR INTERNAL_ERROR

Example

VALIDATION_ERROR

message

required

Human-readable error message

string

Example

Invalid request body

details

Additional error details (e.g., validation issues)

object

key

additional properties

any

Example

{
  "error": {
    "code": "AUTHENTICATION_ERROR",
    "message": "Invalid or missing API key"
  }
}

404

Resource not found

object

error

required

object

code

required

Machine-readable error code

string

Allowed values: VALIDATION_ERROR AUTHENTICATION_ERROR NOT_FOUND CONFLICT RATE_LIMIT_EXCEEDED USAGE_LIMIT_EXCEEDED EXTERNAL_SERVICE_ERROR INTERNAL_ERROR

Example

VALIDATION_ERROR

message

required

Human-readable error message

string

Example

Invalid request body

details

Additional error details (e.g., validation issues)

object

key

additional properties

any

Example

{
  "error": {
    "code": "NOT_FOUND",
    "message": "KnowledgeBase not found: kb_nonexistent"
  }
}

429

Rate limit exceeded

object

error

required

object

code

required

Machine-readable error code

string

Allowed values: VALIDATION_ERROR AUTHENTICATION_ERROR NOT_FOUND CONFLICT RATE_LIMIT_EXCEEDED USAGE_LIMIT_EXCEEDED EXTERNAL_SERVICE_ERROR INTERNAL_ERROR

Example

VALIDATION_ERROR

message

required

Human-readable error message

string

Example

Invalid request body

details

Additional error details (e.g., validation issues)

object

key

additional properties

any

Example

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded"
  }
}