Claude Platform Docs

Delete Skill

DeletedSkill skills().delete(params = SkillDeleteParams.none(), requestOptions = RequestOptions.none())
DELETE/v1/skills/{skill_id}

Delete Skill

Parameters
SkillDeleteParams params
Optional<String> skillId⁠Path parameter

Unique identifier for the skill.

The format and length of IDs may change over time.

Optional<String> workspaceId⁠Header parameter

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns
class DeletedSkill { type = "skill_deleted"; id; }
JsonValue type = "skill_deleted"

Deleted object type.

For Skills, this is always "skill_deleted".

String id

Unique identifier for the skill.

The format and length of IDs may change over time.

Errors

Any method can also return the general HTTP errors.

ClaudeCodeKeyCreatorNotMemberExceptionHTTP status 400error code claude_code_key_creator_not_member

The API key belongs to the Claude Code workspace, and the user who created it is no longer a member of the organization or of that workspace.

OrganizationOnHoldExceptionHTTP status 400error code organization_on_hold

Anthropic has disabled the organization for trust and safety reasons. An organization disabled for any other reason, such as billing, does not get this code. appeal_url, when present, is where the organization can appeal.

Delete Skill
package com.anthropic.example;

import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.skills.DeletedSkill;
import com.anthropic.models.skills.SkillDeleteParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        AnthropicClient client = AnthropicOkHttpClient.fromEnv();

        DeletedSkill deletedSkill = client.skills().delete("skill_id");
    }
}
Returns Examples
Response 200
{
  "id": "skill_01JAbcdefghijklmnopqrstuvw",
  "type": "skill_deleted"
}