Backboard API home pagelight logo
  1. Assistants
  2. Clone Assistant
POST
/assistants/{assistant_id}/clone
curl --request POST \
     --url https://app.backboard.io/api/assistants/{assistant_id}/clone \
     --header 'X-API-Key: <api-key>' \
     --header 'authorization: <authorization>' \
     --header 'x_session_token: <x_session_token>' \
     --header 'Content-Type: application/json' \
     --data '{
  "name": "string",
  "description": "string",
  "system_prompt": "string",
  "copy_documents": true,
  "copy_memories": true
}'

Clone an assistant’s configuration, assistant-level documents, and active memories into a brand new assistant owned by the caller.

The clone is a point-in-time snapshot — subsequent changes to the source assistant or the clone are independent of each other. The new assistant gets its own Turbopuffer namespace; document vectors are copied across so search works immediately without re-indexing.

By default both documents and memories are copied. Use copy_documents / copy_memories to opt out of either.

​
Authorizations

X-API-Key
required
string
API Key authentication

​
Query Parameters

assistant_id
required
string
authorization
x_session_token

​
Body

application/json
name
string | null

Name for the cloned assistant

description
string | null

Optional system prompt override for the cloned assistant

system_prompt
string | null

Optional system prompt override (alias for description)

copy_documents
boolean

Whether to clone assistant-level knowledge base documents

copy_memories
boolean

Whether to clone active assistant memories

​
Response

application/json

  • 200

  • 422

Successful Response

assistant
required
object

Assistant

documents_cloned
integer

Number of assistant-level document records cloned

memories_cloned
integer

Number of active memories cloned