> For the complete documentation index, see [llms.txt](https://docs.floui.io/guia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.floui.io/guia/conectores/categorias/servicos-do-floui/floui-database/salvar-registro.md).

# Salvar registro

{% tabs %}
{% tab title="Parâmetros" %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXemVVlApZbW4KpPRR29EWE7uEJ1m8UonG-jMwMW1D9N5v-iFPhVq7smlyHRptjhtlY05SvOm3GI17Du6H4-4AS9c7BlVlzhIp0JOd_l4bFCgaDttHvwG0MRjuPMgtTFfbtLtoeouQ?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Parâmetros de configuração</p></figcaption></figure>

| Campo                                  | Tipo                 | Descrição                                                                                                                                               |
| -------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Descrição                              | Campo de texto       | Descrição visual do conector na construção do fluxo.                                                                                                    |
| Tabela de dados para salvar o registro | Seletor              | Permite selecionar a tabela onde o registros será salvo ou criado.                                                                                      |
| Campo único                            | Campo de texto       | Define o campo único do registro, como um identificador. O nome do campo pode ser obtido na estrutura da tabela Floui Database.                         |
| Valor                                  | Campo de texto       | Define o valor do identificador único do registro. Caso o registro não exista para atualização, este valor será usado na criação do registro.           |
| Valores para atualização               | Tabela de parâmetros | Tabela de parâmetros para definição do campo a ser acessado e o valor que será salvo no registro. Use 0/1 ou true/false para aplicar valores booleanos. |
| Output Path                            | Campo de texto       | Refere-se ao caminho de saída onde o resultado do salvamento será disponibilizado no contexto de execução do conector.                                  |
| {% endtab %}                           |                      |                                                                                                                                                         |

{% tab title="Payload" %}

## Sucesso

Em casos de sucesso a carga de dados do conector será o registro (criado ou atualizado) em Floui Database

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXepHZifo6XQVT38KmgdGNtg0_kSORIfWTmipsBuPE4-k44lLL6KzYfA3oI4stZPGRoTwqBeu6m_0fDxkw5UHwuB17-KrR9qKAGM50gE-7d994u8Qo2RoxgYWYtH_DJ7B0N5K2vlfw?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Sucesso na criação/atualização de registro</p></figcaption></figure>

## Erro

Em cenários de erro na criação do registro, devido a forma em que os campos foram parametrizados ou os valores dos campos da tabela foram preenchidos, o retorno será um objeto `error` com uma mensagem interna informando o motivo da não criação ou atualização do registro.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfggSsDYLKarzbwDz4DYj8nY7o3BbgHnMDVeW8HmHqypaRkEvTvMuMF8E6aUbwaE6zWzBULczBCFmxvtyzx-ik7bMevb63EKMFeCvQdeWQY-bUY__gnmhBn-b-e_J4HsJ1xBvHLcQ?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Erro na criação/atualização</p></figcaption></figure>
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.floui.io/guia/conectores/categorias/servicos-do-floui/floui-database/salvar-registro.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.