Delete Agent Definitions

Bulk soft-deletes one or more agent definitions and their associated versions.

DELETE https://api.futureagi.com/simulate/agent-definitions/

Authentication

X-Api-Key API Key Required

Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the Dashboard under Settings.

X-Secret-Key Secret Key Required

Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the Dashboard.

Request body

agent_ids array of UUID Required

Agent definition UUIDs to delete. Must contain at least one ID. Associated versions are also soft-deleted.

Response

200 OK
message string
Confirmation message.
agents_updated integer
Number of agent definitions deleted.
versions_updated integer
Number of agent versions deleted.

Errors

400 Bad Request Optional

Missing, malformed, or empty agent_ids.

401 Unauthorized Optional

Invalid or missing API credentials.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST
 
RESPONSE