Duplicate persona

Creates a copy of an existing persona as a new workspace-level persona with a custom name.

POST https://api.futureagi.com/simulate/api/personas/duplicate/{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 source persona to duplicate. This can be either a system-level (prebuilt) persona or a workspace-level (custom) persona. All attributes from the source persona are copied to the new persona except the name, which must be provided in the request body. The new persona is always created as a workspace-level persona regardless of the source persona’s type.

Request body

name string Required

The name for the duplicated persona. Must be unique within your workspace and must not conflict with any existing system or workspace persona names. The comparison is case-insensitive. Maximum 255 characters. Choose a descriptive name that distinguishes this copy from the original persona.

Response

201 Created
status string

Indicates the outcome of the request. Returns "success" when the persona is duplicated successfully.

result object

The full persona object of the newly created copy. All attributes are inherited from the source persona except name (set to the provided value), id (a new UUID), and persona_type (always set to "workspace"). Includes created_at and updated_at timestamps reflecting the creation time of the copy.

Errors

400 Bad Request Optional

The request payload is invalid. This can occur when the name field is missing or empty, when the provided name already exists as a persona in your workspace (case-insensitive), or when the organization context could not be determined from the request. Review the response body for specific validation error details.

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.

404 Not Found Optional

The source persona with the specified UUID could not be found. Verify that the persona_id is correct and that the source persona has not 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