> ## Documentation Index > Fetch the complete documentation index at: https://docs.inagent.inconcertcx.com/llms.txt > Use this file to discover all available pages before exploring further. # Eliminar un lote > Elimina de forma asíncrona un lote y sus contactos. La eliminación devuelve una operación asíncrona cuyo resultado puede consultarse mediante su `operationId`. ## OpenAPI ````yaml api-reference/dialer/openapi.yaml DELETE /batches/{batchId} openapi: 3.1.0 info: title: AutoContact API version: final summary: Gestión de lotes de marcación automática y carga de contactos. description: > API de AutoContact: gestión de lotes de marcación automática y de los contactos que los integran. Todos los recursos se publican bajo `/autocontact/api/v1/`. ## Autenticación Las peticiones se autentican con el header `apikey`. La misma credencial permite operar los lotes de la cuenta a los que tenga acceso. El servicio deriva la cuenta de esa credencial y verifica que el recurso solicitado le pertenezca. Un lote que no pertenece a la cuenta responde `404`, igual que un lote inexistente. ## Operaciones asíncronas Algunas operaciones responden `202` en lugar de `200`: la petición se acepta y el trabajo continúa en segundo plano. Es el caso de la carga de contactos, el arranque y la eliminación de un lote. Esas respuestas incluyen un `operationId` que se consulta en `GET /batches/operations/{operationId}` para conocer el resultado. `POST /batches` no genera una operación: devuelve directamente el `batchId`, el estado `created` y el origen del lote, sin `operationId`. Tiempo de retención de las operaciones: | Tipo de operación | Disponible durante | |---|---| | Carga de contactos | 6 horas | | Ciclo de vida del lote (arranque, archivado, eliminación) | 1 hora, y 10 minutos desde que finaliza | ## Reintentos seguros con `Idempotency-Key` Las operaciones de escritura aceptan el header opcional `Idempotency-Key`. Resuelve el caso en que se produce un error de red después de que la petición llegó al servicio: sin este header no es posible determinar si el trabajo se procesó, y reintentar podría duplicar llamadas telefónicas. Con el header, un reintento que use la misma clave y el mismo cuerpo devuelve la respuesta original sin procesar nada de nuevo. Las claves se conservan 24 horas. Recomendación de uso: generar un identificador único (por ejemplo un UUID) antes del primer intento y reutilizarlo solo en los reintentos de esa misma operación. Requisitos de la clave: entre 1 y 255 caracteres, solo ASCII imprimible. Una clave que no cumpla estos requisitos se rechaza con `400 INVALID_IDEMPOTENCY_KEY` en lugar de ignorarse, para evitar procesar la petición sin la protección que el cliente espera tener. ### Headers de respuesta | Header | Cuándo aparece | Significado | |---|---|---| | `Idempotency-Replayed: true` | En un reintento | La respuesta corresponde a la petición original; no se procesó de nuevo | | `Retry-After` | Junto a `409 IDEMPOTENCY_KEY_IN_FLIGHT` | Segundos a esperar antes de reintentar | | `Idempotency-Status: bypassed` | Excepcionalmente | La petición se procesó **sin** protección de idempotencia | El header `Idempotency-Status: bypassed` indica que el servicio de idempotencia no estaba disponible y la petición se procesó igualmente, para no interrumpir la operación. La respuesta es válida, pero esa petición concreta no quedó protegida: si no se recibe respuesta, se recomienda verificar el estado antes de reintentar. Las respuestas con error `5xx` no se almacenan, de modo que un reintento con la misma clave vuelve a procesar la petición. servers: - url: https://api.backend.inconcertcc.com/autocontact/api/v1 description: API de Inagent security: - ApiKeyAuth: [] tags: - name: Lotes description: | Creación, consulta y control de lotes de marcación. - name: Contactos description: | Carga de contactos en un lote, reagendamiento y anulación. - name: Direcciones bloqueadas description: | Direcciones excluidas de la marcación en toda la cuenta. - name: Operaciones description: | Seguimiento de las operaciones asíncronas que devuelven `202`. paths: /batches/{batchId}: parameters: - $ref: '#/components/parameters/BatchId' delete: tags: - Lotes summary: Elimina un lote y sus contactos description: > Elimina el lote junto con sus contactos y su historial. Responde `202`: la eliminación se realiza en segundo plano. ## Operación irreversible Los contactos, sus intentos y el registro de actividad del lote se eliminan de forma permanente, sin posibilidad de recuperación. Para conservar la información, utilice el archivado del lote, que mantiene el lote consultable y genera una copia descargable de sus contactos. ## Seguimiento La eliminación de un lote con muchos contactos requiere varios minutos, por lo que se procesa en segundo plano. El `operationId` devuelto permite seguir el avance en `GET /batches/operations/{operationId}`, que lo devuelve con `kind: batch.lifecycle`. La operación está disponible durante 1 hora y solo 10 minutos desde que finaliza. Una vez completada la eliminación, el lote deja de aparecer en el listado. ## Requisitos El lote debe estar detenido. Un lote en curso responde `409`: es necesario detenerlo antes de eliminarlo. Si ya hay una eliminación o un archivado en curso, la petición responde también `409`, de modo que un reintento no genera un segundo proceso de eliminación. operationId: deleteBatch responses: '202': description: > Eliminación aceptada. El lote y sus contactos se eliminan en segundo plano. content: application/json: schema: type: object required: - operationId - status properties: operationId: type: string format: uuid description: > Identificador de la operación de eliminación, consultable en `GET /batches/operations/{operationId}`. status: type: string enum: - deleting example: operationId: 8b4d2f61-9c3a-4e57-b8f2-1a6d5c4e3b90 status: deleting '404': description: El lote no existe o no pertenece a la cuenta. content: application/json: schema: $ref: '#/components/schemas/SimpleError' example: message: Batch not found '409': description: > El lote está en un estado que no admite la eliminación: está en curso, o ya hay otra operación de ciclo de vida en proceso. content: application/json: schema: $ref: '#/components/schemas/SimpleError' examples: enCurso: summary: El lote está en curso value: message: >- No se puede eliminar un lote que está en curso. Pausá el lote antes de eliminarlo. yaEliminando: summary: Ya hay una eliminación en curso value: message: El lote ya se está eliminando. archivando: summary: El lote se está archivando value: message: El lote se está archivando. Esperá a que termine. '500': $ref: '#/components/responses/InternalError' components: parameters: BatchId: name: batchId in: path required: true schema: type: string format: uuid description: Id del lote. schemas: SimpleError: type: object required: - message description: > Error con mensaje descriptivo. Algunos traen `code` estable (los más nuevos); otros solo `message`. Los mensajes pueden aparecer en español o en inglés según el caso, y algunos errores todavía no incluyen `code`. Cuando esté presente, utilice `code` para tratar el error de forma programática. properties: code: type: string description: > Presente en los errores ya normalizados (`MISSING_PARAMETER`, `OPERATION_NOT_FOUND`, `VALIDATION_FAILED`, `INVALID_IDEMPOTENCY_KEY`, y los de idempotencia). message: type: string responses: InternalError: description: Error interno. content: application/json: schema: $ref: '#/components/schemas/SimpleError' securitySchemes: ApiKeyAuth: type: apiKey in: header name: apikey description: API key obtenida desde la interfaz de Inagent, dentro del marcador. ````