Operación Bulk: Eliminar Organizations

❗️

+++Atención+++

Este endpoint es extremadamente poderoso. Pero un gran poder conlleva una gran responsabilidad.

La eliminación de Organizations NO puede deshacerse. Por favor, haz una copia de seguridad de todos los datos de las Organizations antes de eliminar una o más Organizations.

Solicitud HTTP

Para eliminar una o más Organizations, haz una petición POST a la siguiente URL:

🚧

Es un POST

Ten en cuenta que es una petición POST y no una petición DELETE.

Parámetros de consulta

Parámetros de cuerpo

El cuerpo es un array que contiene uno o más <organization_key>. Cada objeto <organization_key> puede contener los siguientes parámetros de cuerpo:

📘

<organization_key>

Recuerda que el <organization_key> tiene 3 formatos válidos:

• <organization_id>: "6e3wef09da44fc8455a9cceb5aa"

• <organization_label>: "~second-organization" // Recuerda añadir el ~ antes del label de la Organization

• JSON de <organization_id>: { "id": "1237809ca5pIhpjgc345fc" }

❗️

+++ATENCIÓN+++

Por favor, ten MUCHO cuidado al utilizar este endpoint, ¿por qué? Porque es posible eliminar muchas Organizations a la vez.

Te proponemos 1 alternativa segura:

• Haz una petición de Obtener todas las Organizations utilizando el parámetro de consulta fields=id. Esto devuelve un Array de los Ids de las Organizations. Simplemente copia este Array y utilízalo en el cuerpo de este endpoint. Así te aseguras de que sólo se eliminan las Organizations previstas en ese Array y no cualquier otra.

Cabecera

$ curl -X POST 'https://api.netux.com/api/v2.0/organizations/_/bulk/delete/' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \
 -H 'Content-Type: application/json' \
 -H 'X-Bulk-Operation: True' \
 -d '[
  "6e309da44fc8455a9cceb5aa",
  "~second-organization",
  "~third-organization",
  {
    "id": "1237809ca5pIhpjgc345fc"
  }
]'

Respuesta

Devuelve un Task Id del proceso asíncrono.

{
  "task": {
    "id": "tyg54645501a9ca5714e7b098721"
  }
}

{
    "code": 400001,
    "message": "Validation Error.",
    "detail": {
        ....
    }
}

{
    "code": 401001,
    "message": "Authentication credentials were not provided.",
    "detail": "Authentication credentials were not provided."
}

{
    "detail": "Header `X-BULK-OPERATION` should be provided for bulk operation."
}