DELETE /v1/agents/knowledge/sources/{source_id}

Remove a source from Knowledge; agents stop answering from it.

Removes a source from Knowledge, with everything read from it. Agents no longer answer from it. To keep it but have agents ignore it, set active to false with PATCH instead.

Needs the agents.knowledge:write scope.

Path parameters

Field	Type	Required	Notes
source_id	string	Yes	The source’s id.

Request

cURL

curl -X DELETE "https://api.fireflo.au/v1/agents/knowledge/sources/b7e4c1d2-5a3f-4e8b-9c6d-1a2f3e4b5c6d" \
  -H "Authorization: Bearer $OMNI_API_KEY"

Response

204 No Content — no body.

Errors

Every refusal is {"error": {"code", "message", "field"}}; field is there when one input is at fault.

Status	Error code	When
404	not_found	No knowledge source of this account’s has that id.
404	module_off	The account doesn’t have AI agents on: they aren’t in its plan, or are switched off for it.
403	scope_missing	The key doesn’t have the agents.knowledge:write scope.

Any request can also be refused for its key, its account or its rate (key_required, invalid_key, account_suspended, plan_excludes_api, address_not_allowed, rate_limited); see the overview.