> ## Documentation Index
> Fetch the complete documentation index at: https://developers.insuranceboosters.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tableros

> Crea tableros flexibles, define sus campos y administra registros mediante la API.

La API de **Tableros** te permite crear estructuras de datos flexibles y administrar sus registros. En las rutas de la API, los tableros se identifican como `databases`.

## Flujo recomendado

<Steps>
  <Step title="Obtén o crea un tablero">
    Usa [Listar tableros](/tableros/listar-tableros) para encontrar su `databaseId` o [Crear tablero](/tableros/crear-tablero) para iniciar uno nuevo.
  </Step>

  <Step title="Define sus campos">
    Agrega campos con un `name` y un `type`. La API genera un `fieldId` y una `key` estable para cada campo.
  </Step>

  <Step title="Crea registros">
    Envía los valores dentro de `values`, usando la `key` de cada campo como propiedad.
  </Step>

  <Step title="Consulta o busca">
    Lista con paginación por cursor o usa búsqueda para combinar texto, filtros y ordenamiento.
  </Step>
</Steps>

## Identificadores

| Identificador | Uso                                       |
| ------------- | ----------------------------------------- |
| `databaseId`  | Identifica el tablero.                    |
| `fieldId`     | Identifica la definición de un campo.     |
| `fieldKey`    | Clave inmutable usada dentro de `values`. |
| `recordId`    | Identifica un registro del tablero.       |

<Warning>
  Usa `fieldKey`, no `fieldId`, como propiedad dentro de `values`. Obtén ambas en la respuesta del tablero.
</Warning>

## Esquema y valores

<CardGroup cols={2}>
  <Card title="Configurar campos" icon="columns-3" href="/tableros/tipos-de-campo">
    Define las propiedades específicas de cada `type`.
  </Card>

  <Card title="Escribir valores" icon="braces" href="/tableros/valores-por-tipo">
    Consulta el formato esperado dentro de `values`.
  </Card>
</CardGroup>

## Autenticación

Incluye tu API key en todas las solicitudes:

```http theme={null}
x-ib-api-key: <tu-api-key>
```

Consulta [Autenticación](/autenticacion) si todavía no tienes una clave.

## Respuestas y errores

Las operaciones devuelven JSON, excepto las respuestas `204`, que no incluyen body. El formato de error habitual es:

```json theme={null}
{ "message": "Database not found" }
```

Los endpoints de archivos usan `error`:

```json theme={null}
{ "error": "Record not found" }
```

<Note>
  La API permite eliminar registros y campos. Actualmente no expone una operación para eliminar un tablero completo.
</Note>