> ## 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.

# Eliminar campo

> Quita un campo del esquema de un tablero.

Elimina un campo del esquema del tablero.

## Endpoint

```text theme={null}
DELETE /databases/{databaseId}/fields/{fieldId}
```

<Warning>
  Esta operación quita la definición del campo, pero no limpia automáticamente el valor histórico almacenado en cada registro. Migra o respalda esos valores antes de eliminarlo.
</Warning>

No puedes eliminar un campo si:

* pertenece a un par bidireccional; desvincúlalo primero;
* otro campo de relación lo usa para mostrar valores;
* un campo `lookup` depende de él.

## Ejemplo de solicitud

```bash theme={null}
curl -X DELETE "https://api.insuranceboosters.com/api/v1/databases/{databaseId}/fields/{fieldId}" \
  -H "x-ib-api-key: TU_API_KEY"
```

## Respuesta exitosa (`204`)

La respuesta no incluye body.

## Errores frecuentes

| HTTP  | Qué significa                                                         | Qué hacer                                        |
| ----- | --------------------------------------------------------------------- | ------------------------------------------------ |
| `400` | El campo tiene dependencias o pertenece a una relación bidireccional. | Elimina la dependencia o desvincula la relación. |
| `403` | Tu integración no puede modificar el tablero.                         | Confirma el acceso.                              |
| `404` | El tablero o el campo no existe.                                      | Confirma los IDs.                                |


## OpenAPI

````yaml openapi/tableros-v1.yaml DELETE /databases/{databaseId}/fields/{fieldId}
openapi: 3.1.0
info:
  title: Insurance Boosters API — Tableros
  version: 1.0.0
  description: API pública para administrar tableros, campos, registros y archivos.
  license:
    name: Propietaria
    url: https://insuranceboosters.com
servers:
  - url: https://api.insuranceboosters.com/api/v1
    description: Producción
security:
  - IbApiKey: []
tags:
  - name: Tableros
    description: Administración de tableros.
  - name: Campos
    description: Configuración del esquema de un tablero.
  - name: Registros
    description: Lectura y escritura de registros.
  - name: Archivos
    description: Archivos adjuntos a registros.
paths:
  /databases/{databaseId}/fields/{fieldId}:
    parameters:
      - $ref: '#/components/parameters/DatabaseId'
      - $ref: '#/components/parameters/FieldId'
    delete:
      tags:
        - Campos
      summary: Eliminar campo
      operationId: deleteDatabaseField
      responses:
        '204':
          description: Campo eliminado.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  parameters:
    DatabaseId:
      name: databaseId
      in: path
      required: true
      description: ID del tablero.
      schema:
        type: string
    FieldId:
      name: fieldId
      in: path
      required: true
      description: ID inmutable del campo.
      schema:
        type: string
  responses:
    BadRequest:
      description: Solicitud inválida.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: API key inválida o faltante.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: La integración no tiene acceso al recurso.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Recurso no encontrado.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalError:
      description: Error del servicio.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        message:
          type: string
        error:
          type: string
      additionalProperties: false
  securitySchemes:
    IbApiKey:
      type: apiKey
      in: header
      name: x-ib-api-key
      description: API key de Insurance Boosters.

````