Eliminar Skill
Eliminar Skill
Permite eliminar el Skill de una organización específica.
Mediante esta interfaz, se puede eliminar el Skill de una organización específica. Al eliminarlo, se limpian en cascada el borrador de la habilidad, las instantáneas de versión y los registros de archivos del paquete de habilidad.
Método de solicitud
POST
URL de la solicitud
https://api.${endpoint}/v1/org/skill/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 Skill de la organización.
Solicitud
Ejemplo de solicitud
curl -X POST 'https://api.${endpoint}/v1/org/skill/delete' \
-H 'Authorization: Basic ${BASIC_TOKEN}' \
-H 'Content-Type: application/json' \
-d '{
"org_id": "p-xxxx",
"skill_id": "skill-xxxx"
}'
curl -X POST 'https://api.${endpoint}/v1/org/skill/delete' \
-H 'Authorization: Basic ${BASIC_TOKEN}' \
-H 'Content-Type: application/json' \
-d '{
"org_id": "p-xxxx",
"skill_id": "skill-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 |
| skill_id | String | ID del Skill. | 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 |
