Delete persona

Soft-deletes a workspace-level persona. System personas cannot be deleted.

DELETE https://api.futureagi.com/simulate/api/personas/{persona_id}/

Authentication

X-Api-Key string 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 string 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.

Path parameters

persona_id string Required

The UUID of the persona to delete. The persona must be a workspace-level (custom) persona that belongs to your organization. System (prebuilt) personas cannot be deleted. The persona is soft-deleted, meaning it is marked as deleted and excluded from future listings but is not permanently removed from the database. You can retrieve persona IDs from the List personas endpoint.

Response

204 No Content
status string

Indicates the outcome of the request. Returns "success" when the persona is soft-deleted successfully.

result object

An object containing a message field with a confirmation string such as "Persona deleted successfully".

Errors

401 Unauthorized Optional

Authentication credentials were not provided or are invalid. Ensure that both X-Api-Key and X-Secret-Key headers are included in your request and contain valid, non-expired keys. Verify your API keys in the Dashboard under Settings.

403 Forbidden Optional

The specified persona is a system-level (prebuilt) persona and cannot be deleted. System personas are managed by Future AGI and are available to all workspaces. Only workspace-level personas created by your team can be deleted.

404 Not Found Optional

The persona with the specified UUID could not be found. Verify that the persona_id is correct and that the persona has not already been deleted. You can retrieve valid persona IDs from the List personas endpoint.

500 Internal Server Error Optional

An unexpected error occurred on the server while processing the request. This is not caused by your input. If this error persists, contact Future AGI support with the request details and timestamp for investigation.

GET /
Authentication
REQUEST
 
RESPONSE