---
title: "POST /v1/operations/agents.create"
method: POST
path: "/v1/operations/agents.create"
---

# POST /v1/operations/agents.create

`POST /v1/operations/agents.create`

## Request

- Base URL: `https://sagots.com` (the document declares no server; this is the origin it was published from)
- URL: `https://sagots.com/v1/operations/agents.create`
- Auth: HTTP bearer

## Request body

- object
  - `workspaceId` string, uuid, required
  - `persona` object, required
    - `name` string, required
    - `instructions` string, required
    - `greeting` string, required
    - `inboundGreeting` string, required
    - `voice` 'Aoede' | 'Sulafat' | 'Kore' | 'Puck' | 'Charon' | 'Fenrir', required
    - `language` string, required
    - `knowledge` string, required
    - `offer` string, required
    - `questions` string[], required
    - `integrationId` string, uuid, nullable, required
    - `integrationIds` string[]: Selected action connections. An explicit empty list removes all; overrides legacy integrationId.
    - `handoffOwner` string, required

## Response `200`

Operation result

## Other responses

- `400`: Structured error

---

[API](https://skmtc.dev/sagots/apis/sagot-operations.md) · [All operations](https://skmtc.dev/sagots/apis/sagot-operations/llms.txt) · [OpenAPI document](https://skmtc.dev/sagots/apis/sagot-operations/revisions/da45e0cbcbde?raw)