Skip to main content
DELETE
Deletes one agent in the workspace tied to your API key.
Deleting an agent removes it from the workspace. Use List agents first to confirm the ID and name before calling this route.

Headers

string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.

Path parameters

string
required
Agent ID to delete. Use List agents to get the botId.

Response

Returns a confirmation message.

Errors

The agent ID is not a valid UUID.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the write scope required for this route.
The agent does not exist in the API key’s workspace.
Fini failed while deleting the agent.