> ## Documentation Index > Fetch the complete documentation index at: https://gotrebol.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Actualizar un tipo de ítem personalizado > Actualiza campos del tipo. Debes enviar al menos un campo. Si todos los campos ya coinciden con los valores actuales, no se ejecuta ningún UPDATE y `updated_at` no cambia (idempotencia). ## OpenAPI ````yaml /api-reference/openapi.yaml patch /v2/custom-item-types/{id} openapi: 3.0.0 info: title: Coleccion de API KYB MX description: > La Colección de API KYB MX proporciona puntos finales para crear y gestionar verificaciones de empresas en México. La verificación de empresas implica validar la información proporcionada por un cliente comercial, incluyendo documentos y fuentes de datos, para asegurar su legitimidad y precisión. Cada verificación de empresa puede incluir múltiples ítems, como Actas Constitutivas, Constancias de Situación Fiscal, Identificaciones Personales y Comprobantes de Domicilio. Trebol maneja automáticamente la clasificación de documentos, lo que te permite enviar todos los documentos requeridos como URLs descargables (por ejemplo, URLs prefirmadas de AWS o GCP). **Autenticación**: La API utiliza una clave API para la autenticación, pasada en el encabezado `x-api-key`. Para obtener una clave API, por favor [contáctanos](mailto:sales@gotrebol.com). version: 1.0.0 servers: - url: https://api.gotrebol.com - url: http://{{trebol_api_base_url}} security: [] tags: - name: Creacion de Verificacion description: Endpoints para crear nuevas verificaciones. - name: Leer información de la empresa description: >- Endpoints v2 para obtener información detallada de empresas y verificaciones. - name: Leer por Etiqueta description: >- Endpoints para obtener información detallada sobre empresas mediante etiquetas. - name: Leer por ID de Verificacion description: >- Endpoints para obtener información detallada sobre verificaciones mediante ID. - name: Gestión de IPs Permitidas description: >- Endpoints para gestionar la lista de IPs permitidas (whitelist) para la cuenta del cliente. - name: Gestión de API Keys description: Endpoints para crear, listar y eliminar API keys de la cuenta del usuario. - name: Gestion de item Ids description: Endpoints para gestionar items de verificaciones. - name: Invalidar un documento description: Endpoints para invalidar documentos de verificaciones. - name: Labels de Verificacion description: Endpoints para gestionar labels de verificaciones. - name: Actualizar personas clave de una verificacion description: Endpoints para actualizar personas clave de verificaciones. - name: Agregar items a una verificacion description: Endpoints para agregar items a verificaciones existentes. - name: Estado de validacion de documentos description: Endpoints para obtener el estado de validación de documentos. - name: Gestión de Flujos de Cuenta description: Endpoints para gestionar flujos de cuenta. - name: Gestión de Webhooks description: Endpoints para crear, listar, actualizar y eliminar webhooks de la cuenta. - name: Gestión de Política de Retención description: Endpoints para gestionar la política de retención de datos de la cuenta. - name: Exportación de Verificaciones description: >- Endpoints para exportar datos de verificaciones a documentos personalizados. - name: Leer información de la empresa v1 description: >- Endpoints v1 (legacy) para obtener información detallada de empresas y verificaciones. Te recomendamos migrar a los endpoints v2. - name: Tipos de Ítem Personalizados description: >- Endpoints para crear y gestionar tipos de ítem personalizados con procesos configurables de clasificación, validación y extracción. paths: /v2/custom-item-types/{id}: patch: tags: - Tipos de Ítem Personalizados summary: Actualizar un tipo de ítem personalizado description: > Actualiza campos del tipo. Debes enviar al menos un campo. Si todos los campos ya coinciden con los valores actuales, no se ejecuta ningún UPDATE y `updated_at` no cambia (idempotencia). operationId: actualizarTipoItemPersonalizado parameters: - $ref: '#/components/parameters/customItemTypeId' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateCustomItemTypeRequest' responses: '200': description: >- Tipo actualizado exitosamente. Devuelve solo campos del tipo, sin procesos. content: application/json: schema: $ref: '#/components/schemas/CustomItemTypeUpdateResponse' '400': description: | Solicitud inválida. Posibles causas: - Ningún campo proporcionado, valor inválido o `name` vacío. - `status` con valor no permitido (solo `"active"` o `"archived"`). - `friendly_name` fuera del rango de 2 a 255 caracteres. '401': description: No autorizado. API key inválida o faltante. '404': description: Tipo no encontrado (los tipos archivados sí se pueden actualizar). '409': description: '`name` colisiona con otro tipo activo o archivado de la cuenta.' security: - ApiKeyAuth: [] components: parameters: customItemTypeId: name: id in: path required: true description: Identificador único del tipo de ítem personalizado (ej. `cit_abc123`). schema: type: string example: cit_abc123 schemas: UpdateCustomItemTypeRequest: type: object description: Debes enviar al menos un campo (`name`, `friendly_name` o `status`). properties: name: type: string description: Renombra el tipo. No puede contener espacios. Única por cuenta. friendly_name: type: string description: Actualiza el nombre legible. Entre 2 y 255 caracteres. status: type: string enum: - active - archived description: >- `archived`: pausa el tipo, sigue en el listado y puede reactivarse. `active`: reactiva un tipo archivado. CustomItemTypeUpdateResponse: type: object properties: success: type: boolean example: true data: type: object description: Tipo actualizado (sin procesos). properties: id: type: string example: cit_abc123 name: type: string example: cit_contrato_arrendamiento_v2 friendly_name: type: string status: type: string enum: - active - archived created_at: type: string format: date-time updated_at: type: string format: date-time securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key ````