Skip to main content
POST
/
personas
/
build
Trigger a persona build
curl --request POST \
  --url https://api.deyta.ai/gateway/v1/personas/build \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "namespace_id": "<string>",
  "external_reference_id": "<string>"
}
'
{
  "success": true,
  "data": {
    "build_id": "build_01HV1ABC2D3EFGHJK4M5N6P7Q",
    "agent_id": "8f37a51e-2c09-4d3c-9b4e-1f4f5b9e7a02",
    "status": "accepted"
  }
}

Authorizations

Authorization
string
header
required

API key obtained from the Deyta Console

Body

application/json
namespace_id
string

Namespace ID. Required if external_reference_id is not provided.

external_reference_id
string

External reference ID. Required if namespace_id is not provided.

Response

Build accepted and queued

success
boolean
Example:

true

data
object

Acknowledgement that a build has been queued. Builds run asynchronously — poll GET /personas/status for completion.