Delete Skill Version

DeletedSkillVersion skills().versions().delete(, )

DELETE/v1/skills/{skill_id}/versions/{version}

Parameters

VersionDeleteParams params

String skillId

Unique identifier for the skill.

The format and length of IDs may change over time.

Optional<String> version

Identifies the skill version by its version ID.

Requests carrying the skills-2025-10-02 beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").

Returns

class DeletedSkillVersion:

String id

Unique identifier for this Skill Version. The id addresses the version in paths and pins it in references.

JsonValue type

Deleted object type.

For Skill Versions, this is always "skill_version_deleted".

Delete Skill Version

package com.anthropic.example;

import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.skills.versions.DeletedSkillVersion;
import com.anthropic.models.skills.versions.VersionDeleteParams;

public final class Main {
    private Main() {}

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

        VersionDeleteParams params = VersionDeleteParams.builder()
            .skillId("skill_id")
            .version("version")
            .build();
        DeletedSkillVersion deletedSkillVersion = client.skills().versions().delete(params);
    }
}

{
  "id": "id",
  "type": "skill_version_deleted"
}

Returns Examples

{
  "id": "id",
  "type": "skill_version_deleted"
}