Référence APISupprimer une action MCP personnalisée
DELETE/v1/mcp/custom-actions/{id}

Supprimer une action MCP personnalisée

Supprime définitivement une action MCP personnalisée du workspace identifiée par son id.

1 min de lectureTélécharger en PDF

Réponse exemple

{
"id": "mca_7Hk29sLp03",
"object": "custom_action",
"deleted": true
}
DELETE/v1/mcp/custom-actions/{id}Supprime de façon définitive une action MCP personnalisée.

Cette route supprime définitivement (suppression dure, non réversible) une action MCP personnalisée du workspace, identifiée par l'id en fin d'URL. La suppression est cantonnée au workspace de la clé API (filtre par workspace_id), si bien qu'un id appartenant à un autre workspace ne peut pas être supprimé.

Comportement notable : la requête réussit même si aucune ligne n'a été supprimée (par exemple id inexistant), tant que la couche de stockage ne renvoie pas d'erreur. La réponse est donc idempotente côté résultat : elle confirme deleted: true sans distinguer une suppression effective d'un identifiant déjà absent.

Authentification

Requiert une clé API valide disposant du scope api_keys:manage. En cas de scope manquant, la requête est refusée par la couche d'authentification (scope_missing).

Réponse

Renvoie un objet de confirmation comportant l'id ciblé, object valant la constante custom_action, et deleted valant true.

ChampTypeDescription
idstringIdentifiant de l'action ciblée par la suppression.
objectstringToujours custom_action.
deletedbooleanToujours true lorsque la requête aboutit.

Erreurs

CodeQuandRésolution
400 validation_errorid absent de l'URL.Fournir un id valide en fin de chemin de l'URL.
500 internal_errorErreur de la couche de stockage lors de la suppression.Réessayer ; si l'erreur persiste, contacter le support avec le request_id.

Voir aussi