Delete an agent

Delete the agent. The call is idempotent: deleting a non-existent agent returns 204. Deletion does not cascade to the agent’s threads — existing threads remain queryable but cannot start new runs (attempts return 502). Delete threads explicitly when you want to clean them up.

DELETE /agents/{agent_id}

Delete an agent

cURL

curl --request DELETE \
  --url https://api.smith.langchain.com/v1/deepagents/agents/{agent_id} \
  --header 'X-Api-Key: <api-key>'

204

Authorizations

X-Api-Key · string · header · default: LANGSMITH_API_KEY · required

Path Parameters

agent_id · string<uuid> · required

Managed Deep Agent ID.

Response

204

Agent deleted.