Delete VectorDB Connection

Endpoint

DELETE /apiops/projects/{projectName}/vector-dbs/{vectorDbName}/

Authentication

Requires a Personal API Access Token.

Header

Authorization: Bearer YOUR_TOKEN

Request

Headers

Header	Value	Required
Authorization	Bearer {token}	Yes

Path Parameters

Parameter	Type	Required	Description
projectName	string	Yes	Project name
vectorDbName	string	Yes	Vector DB connection name (must exist)

Query Parameters

None

Response

Success Response (200 OK)

{
  "status": "SUCCESS",
  "deploymentResult": {
    "success": true
  }
}

Error Response (400 Bad Request)

{
  "status": "FAILURE",
  "resultMessage": "Vector DB connection (name: pgvector-primary) was not found!"
}

or

{
  "status": "FAILURE",
  "resultMessage": "Vector DB connection name can not be empty!"
}

Error Response (401 Unauthorized)

{
  "status": "FAILURE",
  "resultMessage": "Token is not valid!"
}

cURL Example

curl -X DELETE \
  "https://demo.apinizer.com/apiops/projects/MyProject/vector-dbs/pgvector-primary/" \
  -H "Authorization: Bearer YOUR_TOKEN"

Notes and Warnings

• Undeploy: Deleting a connection removes it from the database and undeploys it from the workers.
• Not Found: Deleting a non-existent name returns 400 Bad Request with status: FAILURE.
• References: If the connection is still referenced by a RAG Injection policy (vectorDbRef) or Semantic Cache, those references will break — check usage before deleting.
• Irreversible: Deletion cannot be undone; recreate the connection with POST if needed.

Related Documentation

• Get VectorDB Connection - Verify a connection exists before deleting
• Create VectorDB Connection - Recreate a connection
• VectorDB Connections API - Resource overview
• AI Gateway API - Full AI Gateway APIops surface