Delete Skill

Permanently deletes a Skill from your workspace. This action cannot be undone.

Base URL

https://api.langdock.com/skills/v1/{skillId}

Dedicated deploymentsReplace api.langdock.com with <your-deployment-url>/api/public in all requests.

Required Scopes

This endpoint requires the SKILL_API scope.

Requires owner access to the Skill. Workspace admins can also delete Skills through this endpoint.

Parameters

Parameter	Type	Required	Description
`skillId`	string	Yes	UUID of the Skill to delete.

Example

const axios = require("axios");

async function deleteSkill(skillId) {
  const response = await axios.delete(
    `https://api.langdock.com/skills/v1/${skillId}`,
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY"
      }
    }
  );

  console.log("Deleted:", response.data.success);
}

deleteSkill("550e8400-e29b-41d4-a716-446655440000");

Response Format

Success Response (200 OK)

{
  success: true;
}

Error Handling

Status Code	Description
400	Invalid Skill ID format
401	Invalid or missing API key
403	Missing `SKILL_API` scope, Skills product access, or owner access
404	Skill not found
429	Rate limit exceeded
500	Internal server error

Deleting a Skill is permanent. Users, Agents, or Projects that relied on the Skill will no longer have those instructions available.

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.

Overview

Completion API

Embedding API

Agents API

Integrations API

Skills API

Knowledge Folder API

Prompt Library API

Usage Export API

Workflow API

Scheduled Tasks API

User Management API

Billing API

Audit Logs API

Governance API

Compliance API

Delete Skill

Base URL

Required Scopes

Parameters

Example

Response Format

Success Response (200 OK)

Error Handling

​Base URL

​Required Scopes

​Parameters

​Example

​Response Format

​Success Response (200 OK)

​Error Handling

Base URL

Required Scopes

Parameters

Example

Response Format

Success Response (200 OK)

Error Handling