Eliminar Tool
Eliminar Tool
Permite eliminar el Tool de una organización específica.
Mediante esta interfaz, se puede eliminar el Tool de una organización específica. Los Tool que ya están montados en un Agent conservan la protección de eliminación de la consola.
Método de solicitud
POST
URL de la solicitud
https://api.${endpoint}/v1/org/tool/delete
Autenticación de la solicitud
Utiliza la autenticación Basic con DevKey / DevSecret a nivel de cuenta y requiere que la cuenta que realiza la llamada tenga permiso de eliminación de Tool de la organización.
Solicitud
Ejemplo de solicitud
curl -X POST 'https://api.${endpoint}/v1/org/tool/delete' \
-H 'Authorization: Basic ${BASIC_TOKEN}' \
-H 'Content-Type: application/json' \
-d '{
"org_id": "p-xxxx",
"id": "tool-xxxx"
}'
curl -X POST 'https://api.${endpoint}/v1/org/tool/delete' \
-H 'Authorization: Basic ${BASIC_TOKEN}' \
-H 'Content-Type: application/json' \
-d '{
"org_id": "p-xxxx",
"id": "tool-xxxx"
}'
Este bloque de código en una ventana flotante
Cabeceras de la solicitud
| Campo | Tipo | Descripción |
|---|---|---|
| Authorization | Basic ${BASIC_TOKEN} | Basic Token resultante de codificar DevKey:DevSecret en Base64. |
| Content-Type | application/json | Formato del cuerpo de la solicitud. |
Parámetros de la solicitud (Body Parameters)
| Campo | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| org_id | String | ID de la organización. | true |
| id | String | ID del Tool. | true |
Respuesta
Ejemplo de respuesta
{
"code": 0,
"message": "OK",
"affect_count": 1
}
{
"code": 0,
"message": "OK",
"affect_count": 1
}
Este bloque de código en una ventana flotante
Respuesta correcta
| Campo | Tipo | Descripción |
|---|---|---|
| affect_count | Integer | Número de registros afectados. |
Respuesta fallida
| Campo | Tipo | Descripción |
|---|---|---|
| code | Integer | Código de error. |
| message | String | Detalles del error. |
Códigos de estado
| Código de estado | Descripción |
|---|---|
| 200 | Correcto |
| 400 | Error de parámetros |
| 401 | No autorizado |
| 403 | Permisos insuficientes |
| 429 | Demasiadas solicitudes |
| 500 | Error del servidor |
