Upload a skill from a Markdown file
Upload a skill as multipart/form-data with one file part: a UTF-8 .md file in SKILL.md form (YAML frontmatter with name and description, then a Markdown body). A project may have at most 200 skills; exceeding the limit returns 400 with error.message e.g. “Max skill limit of 200 reached.”.
Authorizations
Access token issued by the CDF project's configured identity provider. Access token must be an OpenID Connect token, and the project must be configured to accept OpenID Connect tokens. Use a header key of 'Authorization' with a value of 'Bearer $accesstoken'. The token can be obtained through any flow supported by the identity provider.
Query Parameters
If false (default), returns 409 Conflict when the uploaded skill is referenced by an agent. If true, the skill is uploaded regardless.
CDF external ID for the skill's SKILL.md file. Leading and trailing whitespace is trimmed before validation. Must not start with the reserved prefix 'cdf-'. Must be between 1 and 128 characters inclusive, with no null character (U+0000).
1 - 128^[^\x00]{1,128}$Body
UTF-8 .md file in SKILL.md form: YAML frontmatter with name and description, then a Markdown body (text/markdown).
Response
Successful Response
Skills returned with full detail, including Markdown instruction content (e.g. create or fetch-by-id responses). For POST /skills, items match the request items order and count.