Delete with filters

Endpoint que eliminará archivos de una compañia bajo varios criterios de coincidencia, como rango de fecha, tags, etc. Recibe el id de la compañia para eliminar, y por body recibe los siguientes campos:

Campo	Descripción
from_date	Campo que indica el inicio del filtro por fecha para eliminar achivos. Acepta el formato de fecha yyyy-mm-dd HH:MM:SS en formato de hora 24hrs. Campo requerido
until_date	Campo que indica el final del filtro por fecha para eliminar achivos. Acepta el formato de fecha yyyy-mm-dd HH:MM:SS en formato de hora 24hrs. Campo requerido
confirm_delete	Campo que indica la confirmación del eliminado de archivos, si el campo está en `false` el endpoint lista los archivos que cumplen con los filtros indicados, pero no los modifica. Si el campo va en `true` retorna la lista mencionada y efectua la eliminación de los archivos. Campo requerido
folder	Campo que permite indicar la carpeta en la que se encuentran los archivos que se desean eliminar. Se debe indicar el nombre completo de la carpeta. Campo opcional
tags	Campo que permite filtrar qué archivos borrar por un conjunto de tags. Se recibe un objeto JSON que coincida con `clave:valor` para el filtrado. Campo opcional

Endpoint#

Headers

Key	Value	Description
Content-Type	application/json
Authorization	Bearer {{access_token}}	access_token obtained in Atenea

Url

Method: DELETE
URL: https://api.trust.lat/chronos/v1/file_registers/:company_id/filters

caution

Recuerda que para utilizar este endpoint es necesario un access token obtenido en el servicio Atenea

Como obtener un access token

Body#

{
    "from_date": "2021-09-01 20:26:51",
    "until_date": "2021-11-02 20:34:45",
    "confirm_delete": true,
    "tags": {
        "foofoo":"barbar"
    },
    "folder" : "test_folder"
}

Code Examples#

Curl
JavaScript
Python

curl --location --request DELETE 'https://api.trust.lat/chronos/v1/file_registers/1/filters' \
--header 'Content-Type: application/json' \
--data-raw '{
    "from_date": "2021-09-01 20:26:51",
    "until_date": "2021-11-02 20:34:45",
    "confirm_delete": true,
    "tags": {
        "foofoo":"barbar"
    },
    "folder" : "test_folder"
}'

Responses#

HTTP Code: 200 OK#

{
    "code": 200,
    "resource": "Destroy with Filters",
    "data": [
        {
            "deleted_at": "2021-09-24T20:30:19.955Z",
            "uuid": "ffffffff-ffff-ffff-ffff-ffffffffffff",
            "name": "cow.jpg",
            "size": "370.539 KB",
            "created_at": "2021-09-23T21:02:07.655Z",
            "tags": {
                "foofoo": "barbar"
            },
            "path": "cow.jpg"
        }
    ],
    "message": "Files deleted",
    "total": 1
}

HTTP Code: 422 Unprocessable Entity (Missing from_date field)#

{
    "code": 422,
    "resource": "Destroy With Filters",
    "message": "Fail",
    "errors": "The fields 'from_date' and 'until_date' must be provided"
}

HTTP Code: 422 Unprocessable Entity (Missing confirm_delete field)#

{
    "code": 422,
    "resource": "Destroy with Filters",
    "message": "Fail",
    "errors": "The field 'confirm_delete' is required"
}