API Reference

Skills

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Update Skill Default Version

Skill skills().update(SkillUpdateParamsparams, RequestOptionsrequestOptions = RequestOptions.none())

POST/skills/{skill_id}

Update Skill Default Version

ParametersExpand Collapse

SkillUpdateParams params

Optional<String> skillId

String defaultVersion

The skill version number to set as default.

ReturnsExpand Collapse

class Skill:

String id

Unique identifier for the skill.

long createdAt

Unix timestamp (seconds) for when the skill was created.

String defaultVersion

Default version for the skill.

String description

Description of the skill.

String latestVersion

Latest version for the skill.

String name

Name of the skill.

JsonValue; object_ "skill"constant"skill"constant

The object type, which is skill.

Update Skill Default Version

Java

HTTP

TypeScript

Python

Java

Go

Ruby

package com.openai.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.skills.Skill;
import com.openai.models.skills.SkillUpdateParams;

public final class Main {
    private Main() {}

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

        SkillUpdateParams params = SkillUpdateParams.builder()
            .skillId("skill_123")
            .defaultVersion("default_version")
            .build();
        Skill skill = client.skills().update(params);
    }
}

200 example

{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "description",
  "latest_version": "latest_version",
  "name": "name",
  "object": "skill"
}

Returns Examples

200 example

{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "description",
  "latest_version": "latest_version",
  "name": "name",
  "object": "skill"
}