Skills
Create a new version of a skill Create a skill version from uploaded files
Creates a new version of a skill. If the skill does not exist, it will be created. Creates a new version of a skill from uploaded files via multipart form data.
Parâmetros de caminho
name
string
obrigatório
The name of the skill. If the skill does not exist, it will be created.
Parâmetros do cabeçalho
Foundry-Features
enum
obrigatório
A feature flag opt-in required when using preview operations or modifying persisted preview resources.
Parâmetros de consultas
api-version
string
obrigatório
The API version to use for this operation.
Corpo do Pedido
The multipart request content.
inline_content
SkillInlineContent
Inline content for defining a simple skill without uploading files. Follows the agentskills.io SKILL.md specification.
description
string
obrigatório
A human-readable description of what the skill does and when to use it.
instructions
string
obrigatório
The skill instructions in markdown format. This is the body content of the SKILL.md file.
license
string
License name or reference to a bundled license file.
compatibility
string
Environment requirements or compatibility notes for the skill.
metadata
object
Arbitrary key-value metadata for additional properties.
allowed_tools
string[]
List of pre-approved tools the skill may use. Experimental.
default
boolean
Whether to set this version as the default.
files
any[]
obrigatório
Skill files to upload. Upload a single zip file or multiple individual files with relative paths.
default
boolean
Whether to set this version as the default. Defaults to false.
Respostas
The request has succeeded.
Corpo
id
string
obrigatório
The unique identifier of the skill version.
skill_id
string
obrigatório
The identifier of the parent skill.
name
string
obrigatório
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.
version
string
obrigatório
The version identifier. Skill versions are immutable.
description
string
obrigatório
A human-readable description of the skill version.
Pedir
POST /skills/{name}/versions HTTP/1.1Response
Status: 200
Content-Type: application/jsonStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json