# Api Ref

> Referência das APIs TOTVS Fluig — DatasetFactory, DatasetBuilder, CardAPI, WCMAPI, fluigc, WFMovementDTO, getValue/setValue. Use quando tiver dúvida sobre qual API usar no Fluig, sintaxe de dataset, como manipular formulário, ou diferença entre APIs de workflow e formulário.

- **Type:** Skill
- **Install:** `agentstack add skill-tbc-servicos-dataagile-agent-kit-api-ref`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tbc-servicos](https://agentstack.voostack.com/s/tbc-servicos)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tbc-servicos](https://github.com/tbc-servicos)
- **Source:** https://github.com/tbc-servicos/dataagile-agent-kit/tree/main/fluig/skills/api-ref
- **Website:** https://dataagile-agent-kit.dataagile.com.br

## Install

```sh
agentstack add skill-tbc-servicos-dataagile-agent-kit-api-ref
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## Boas práticas

- Use a referência para identificar APIs, parâmetros e padrões — não cole trechos longos de código de terceiros
- Para customizações, crie datasets, widgets e workflows próprios em vez de duplicar comportamento já fornecido pelo Fluig
- Quando precisar de detalhe de implementação interno do Fluig, oriente o usuário a consultar o **TDN oficial** (tdn.totvs.com)

# Fluig API Reference

Referência completa das APIs TOTVS Fluig via MCP `tbc-knowledge`.

## Consulta MCP

### searchFluigApi — Referência de APIs

Busca documentação de APIs por categoria:

```
searchFluigApi({ category: "dataset" })      // DatasetFactory, DatasetBuilder, constraints
searchFluigApi({ category: "form" })         // CardAPI, WCMAPI, getValue/setValue, masks
searchFluigApi({ category: "workflow" })     // WFMovementDTO, variáveis WK*, setTaskUser
searchFluigApi({ category: "widget" })       // DatasetFactory client-side, REST Protheus
searchFluigApi({ category: "fluigc" })       // fluigc components (modal, message, etc)
searchFluigApi({ category: "rest" })         // REST endpoints Fluig
```

Busca livre por palavra-chave:
```
searchFluigApi({ query: "DatasetFactory createDataset" })
searchFluigApi({ query: "WKUser WKNumState" })
searchFluigApi({ query: "jQuery mask CPF" })
```

### searchFluigPatterns — Padrões e Templates de Código

Busca padrões, convenções e templates por categoria e skill:

```
searchFluigPatterns({ category: "template", skill: "fluig-dataset" })
searchFluigPatterns({ category: "template", skill: "fluig-form" })
searchFluigPatterns({ category: "template", skill: "fluig-workflow" })
searchFluigPatterns({ category: "template", skill: "fluig-widget" })
searchFluigPatterns({ category: "naming" })        // convenções de nomenclatura
searchFluigPatterns({ category: "review" })        // regras de code review
searchFluigPatterns({ category: "qa" })            // checklist de QA
searchFluigPatterns({ category: "conventions" })   // boas práticas gerais
```

Busca livre:
```
searchFluigPatterns({ query: "try catch logging dataset" })
searchFluigPatterns({ query: "SweetAlert2 validação formulário" })
```

## Quando usar cada tool

| Dúvida | Tool |
|--------|------|
| Qual método usar para consultar dataset? | `searchFluigApi({ category: "dataset" })` |
| Como obter valor de campo no formulário? | `searchFluigApi({ category: "form" })` |
| Quais variáveis WK* existem no workflow? | `searchFluigApi({ category: "workflow" })` |
| Como estruturar um dataset corretamente? | `searchFluigPatterns({ category: "template", skill: "fluig-dataset" })` |
| Qual a convenção de nomenclatura? | `searchFluigPatterns({ category: "naming" })` |
| O código passa no review? | `searchFluigPatterns({ category: "review" })` |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [tbc-servicos](https://github.com/tbc-servicos)
- **Source:** [tbc-servicos/dataagile-agent-kit](https://github.com/tbc-servicos/dataagile-agent-kit)
- **License:** MIT
- **Homepage:** https://dataagile-agent-kit.dataagile.com.br

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tbc-servicos-dataagile-agent-kit-api-ref
- Seller: https://agentstack.voostack.com/s/tbc-servicos
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.