> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Action

> Delete an action from an integration

<Info>
  **Using our API via a dedicated deployment?** Just replace `api.langdock.com` with your deployment's base URL: **`<deployment-url>/api/public`**
</Info>

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

## Required Scopes

This endpoint requires the `INTEGRATION_API` scope.

## Path Parameters

| Parameter       | Type   | Required | Description                  |
| --------------- | ------ | -------- | ---------------------------- |
| `integrationId` | string | Yes      | UUID of the integration      |
| `actionId`      | string | Yes      | UUID of the action to delete |

## Example

```javascript theme={null}
const axios = require("axios");

async function deleteAction(integrationId, actionId) {
  const response = await axios.delete(
    `https://api.langdock.com/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)

```typescript theme={null}
{
  message: "Action deleted";
  id: string;  // UUID of the deleted action
}
```

## Error Handling

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

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

<Info>
  Langdock 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](/en/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).
</Info>