Skip to main content
DELETE
/
v1
/
source-connections
/
{id}
Delete Source Connection
curl --request DELETE \
  --url https://api.example.com/v1/source-connections/{id}
{
  "id": "<string>",
  "name": "<string>",
  "status": "<string>"
}

​
Overview

Permanently delete a source connection and all its data. What happens when you delete:
  1. Any running sync is cancelled and the API waits (up to 15s) for the worker to stop writing
  2. The source connection, sync configuration, job history, and entity metadata are cascade-deleted from the database
  3. A background cleanup workflow is scheduled to remove data from the vector database (Vespa) and raw data storage (ARF)
The API returns immediately after step 2. Vector database cleanup happens asynchronously—the data becomes unsearchable as soon as the database records are deleted.
This action cannot be undone. All synced data will be permanently deleted.

​
Path Parameters

​
id
string
required
Unique UUID identifier of the source connection to deleteExample: “550e8400-e29b-41d4-a716-446655440000”

​
Response

Returns the deleted source connection object.
​
id
string
required
UUID of the deleted connection
​
name
string
required
Name of the deleted connection
​
status
string
required
Final status of the connection

​
Example Request

curl -X DELETE https://api.airweave.ai/v1/source-connections/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "GitHub Docs Repo",
  "description": "Main documentation repository",
  "short_name": "github",
  "readable_collection_id": "documentation-ab123",
  "status": "ACTIVE",
  "created_at": "2024-03-15T09:30:00Z",
  "modified_at": "2024-03-15T14:22:15Z",
  "auth": {
    "method": "direct",
    "authenticated": true
  },
  "config": {
    "repo_name": "company/docs",
    "branch": "main"
  }
}

​
Error Responses

​
404 Not Found
Source connection with the specified ID does not exist