Trigger a build

Queue a fire-and-forget build for the persona. Works for first builds and rebuilds. Builds run asynchronously; poll GET /personas/status for completion. Provide exactly one of namespace_id or external_reference_id.

POST /personas/build

Trigger a persona build

cURL

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>"
}
'

202

{
  "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

202

application/json

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.

Show child attributes