We use cookies to enhance your experience and measure how the site performs. Choose "Essential Only" to disable analytics. Read our Privacy Policy.

    Odeus Docs

    Delete Action

    Delete an action from an integration

    Delete Action

    Delete an action from an integration

    Using our API via a dedicated deployment? Just replace api.odeus.ai with your deployment's base URL: <deployment-url>/api/public

    Permanently deletes an action from an integration. This action cannot be undone.

    Required Scopes

    This endpoint requires the INTEGRATION_API scope.

    Path Parameters

    ParameterTypeRequiredDescription
    integrationIdstringYesUUID of the integration
    actionIdstringYesUUID of the action to delete

    Example

    const axios = require("axios");
    
    async function deleteAction(integrationId, actionId) {
      const response = await axios.delete(
        `https://api.odeus.ai/integrations/v1/${integrationId}/actions/${actionId}`,
        {
          headers: {
            Authorization: "Bearer YOUR_API_KEY"
          }
        }
      );
    
      console.log("Action deleted:", response.data);
    }
    
    deleteAction("550e8400-e29b-41d4-a716-446655440000", "660e8400-e29b-41d4-a716-446655440001");
    

    Response Format

    Success Response (200 OK)

    {
      message: "Action deleted";
      id: string;  // UUID of the deleted action
    }
    

    Error Handling

    Status CodeDescription
    400Invalid integration or action ID format
    401Invalid or missing API key
    403No access to this integration
    404Integration or action not found
    429Rate limit exceeded

    Deleting an action is permanent and cannot be undone. Any agents or workflows using this action will no longer be able to execute it.

    Odeus intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.