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

# Delete Skill

> Remove a skill from an agent

Permanently remove a skill configuration from an agent. This deletes the skill's config and stops all future executions. Execution history is preserved.

## Path Parameters

<ParamField path="id" type="string" required>
  The agent skill ID to delete.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  `true` if the skill was deleted.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.magpipe.ai/functions/v1/manage-skills/SKILL_ID \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true
  }
  ```
</ResponseExample>