Skip to main content
DELETE
Delete an agent
This permanently deletes the agent. To retain history and stop using an agent, archive it instead.
Requires Admin or Owner. Use the numeric agent ID from List agents, not its UUID. Successful deletion returns 204 No Content. Do not attempt to parse a JSON body. A missing agent or an agent outside the workspace returns 404. If campaigns or runs still depend on the agent, the service returns 409. Inspect detail.blockers; resolve the dependencies where supported or archive the agent. The service does not silently delete dependent history.
The example illustrates a conflict; the blocker keys and counts depend on the agent.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Path Parameters

workflow_id
integer
required

Response

Successful Response