Visão geral, esquema do banco e comportamento de re-embedding em Tolky Features.

Todos os campos são opcionais. Alterar title, description ou longDescription atualiza também o índice de busca semântica da feature.

Endpoint

PUT /api/v4/tolkyFeatures/update

Parâmetros

featureId
string
required

UUID da feature a ser atualizada.

title
string

Novo nome curto.

description
string

Novo resumo em uma linha.

longDescription
string

Nova descrição completa.

isActive
boolean

Ativa ou desativa a feature.

module
string

Novo agrupamento lógico.

Exemplo

# Atualização de texto
curl -X PUT {{BASE_URL}}/api/v4/tolkyFeatures/update \
  -H "Authorization: Bearer {{TOKEN}}" \
  -H "Content-Type: application/json" \
  -d '{
    "featureId": "028c803a-b712-479e-b492-35e9f83f0c0d",
    "description": "Criar ou atualizar um lead com dados atualizados do contato."
  }'

# Desativar a feature
curl -X PUT {{BASE_URL}}/api/v4/tolkyFeatures/update \
  -H "Authorization: Bearer {{TOKEN}}" \
  -H "Content-Type: application/json" \
  -d '{
    "featureId": "028c803a-b712-479e-b492-35e9f83f0c0d",
    "isActive": false
  }'

Resposta

{
  "id": "028c803a-b712-479e-b492-35e9f83f0c0d",
  "title": "upsert",
  "description": "Criar ou atualizar um lead com dados atualizados do contato.",
  "long_description": null,
  "module": "leads",
  "is_active": true,
  "created_at": "2026-01-10T09:00:00.000Z",
  "updated_at": "2026-03-30T15:10:00.000Z"
}

Campos da Resposta

id
string

UUID da feature.

title
string

Nome curto atualizado.

description
string

Resumo em uma linha atualizado. Pode ser null.

long_description
string

Descrição completa atualizada. Pode ser null.

module
string

Agrupamento lógico. Pode ser null.

is_active
boolean

Status atual da feature.

created_at
string

Data e hora de criação em ISO 8601.

updated_at
string

Data e hora da última atualização em ISO 8601.

Erros

CódigoDescrição
400featureId ausente ou já existe uma feature com o mesmo title no mesmo module
401Token inválido ou ausente
403Token não pertence a um admin global
404Feature não encontrada
500Erro interno do servidor