microsoft-foundry.rest.security.o-auth2-auth
Skills
Update a skill
POST
/skills/{name}
Modifies the specified skill's configuration.
Path parameters
name
string
required
The name of the skill to update.
Header parameters
Foundry-Features
enum
required
A feature flag opt-in required when using preview operations or modifying persisted preview resources.
Skills=V1Preview
Query parameters
api-version
string
required
The API version to use for this operation.
Request Body
Content-Type: application/json
default_version
string
required
The version identifier that the skill should point to. When set, the skill's default version will resolve to this version instead of the latest.
Responses
The request has succeeded.
Body
Content-Type: application/json
id
string
required
The unique identifier of the skill.
name
string
required
A skill name following the agentskills.io spec: lowercase letters, numbers, and hyphens only. Must not start or end with a hyphen or contain consecutive hyphens.
description
string
required
A human-readable description of the skill.
created_at
integer
required
default_version
string
required
The default version for the skill. Can be changed via updateSkill.
latest_version
string
required
The latest version for the skill.
Request
POST /skills/{name} HTTP/1.1Response
Status: 200
Content-Type: application/jsonStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json