Você pode testar esta rota diretamente em nossa documentação interativa.

Cria um novo dataset. Se enviar avatarIds, o dataset já é vinculado aos avatares indicados.

Endpoint

POST /api/externalAPIs/public/tolkyReasoning/datasets/create

Parâmetros

hostId
string
required

UUID do host.

datasetName
string
required

Nome do dataset.

datasetType
string
required

Tipo do dataset: common_rag (RAG comum) ou filtered_rag (RAG filtrado).

avatarIds
array

Lista opcional de UUIDs dos avatares a vincular ao dataset.

Exemplo

curl -X POST {{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/datasets/create \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "hostId": "uuid-do-host",
    "datasetName": "Meu Dataset",
    "datasetType": "common_rag",
    "avatarIds": ["uuid-do-avatar-1", "uuid-do-avatar-2"]
  }'

Resposta

{
  "code": 200,
  "message": "Success",
  "data": {
    "id": "uuid-do-dataset",
    "dataset_name": "Meu Dataset",
    "dataset_type": "common_rag",
    "created_at": "2025-05-12T01:39:34.904317+00:00",
    "updated_at": "2025-05-12T01:39:34.904317+00:00",
    "visible": true,
    "deleted": false,
    "expires": "2026-05-12T01:39:34.904317+00:00"
  }
}

Campos da Resposta

data
object

Erros

CódigoDescrição
400Campos obrigatórios ausentes ou inválidos
403Credenciais inválidas ou sem permissão de acesso
408Requisição excedeu o limite de 60 segundos
500Erro interno do servidor