curl --request DELETE \
--url 'https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/public' \
--header 'Authorization: Bearer fini_your_api_key'
import requests
response = requests.delete(
"https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
result = response.json()
const response = await fetch(
"https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/public",
{
method: "DELETE",
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const result = await response.json();
{
"message": "Bot Support Agent deleted"
}
Agents
Delete agent
Delete one agent from the workspace.
DELETE
/
v2
/
bots
/
{id}
/
public
curl --request DELETE \
--url 'https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/public' \
--header 'Authorization: Bearer fini_your_api_key'
import requests
response = requests.delete(
"https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
result = response.json()
const response = await fetch(
"https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/public",
{
method: "DELETE",
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const result = await response.json();
{
"message": "Bot Support Agent deleted"
}
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.curl --request DELETE \
--url 'https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/public' \
--header 'Authorization: Bearer fini_your_api_key'
import requests
response = requests.delete(
"https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
result = response.json()
const response = await fetch(
"https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/public",
{
method: "DELETE",
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const result = await response.json();
Response
Returns a confirmation message.{
"message": "Bot Support Agent deleted"
}
Errors
400 Bad Request
400 Bad Request
The agent ID is not a valid UUID.
401 Unauthorized
401 Unauthorized
The API key is missing, malformed, revoked, or invalid.
403 Forbidden
403 Forbidden
The API key does not include the
write scope required for this route.404 Not Found
404 Not Found
The agent does not exist in the API key’s workspace.
500 Internal Server Error
500 Internal Server Error
Fini failed while deleting the agent.
Was this page helpful?

