Update a skill

Update a skill’s SKILL.md content and/or metadata.

If skillMdContent is provided, the name and description are re-parsed from frontmatter and the SKILL.md file in R2 is replaced.

If only name or description are provided (without skillMdContent), only the metadata fields are updated.

PUT /skills/manage

Update a skill

cURL

curl --request PUT \
  --url https://asteragents.com/api/skills/manage \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "skillMdContent": "<string>",
  "name": "<string>",
  "description": "<string>"
}
'

500

{
  "error": "Internal Server Error"
}

Authorizations

Authorization · string · header · required

JWT token from Clerk authentication.

Must be from a user with org:admin role.

Query Parameters

id · integer · required

The skill ID to update

Body

application/json

skillMdContent · string

Updated SKILL.md content (max 100KB). If provided, name/description are re-parsed from frontmatter.

name · string

Update name directly (only used if skillMdContent is not provided)

description · string | null

Update description directly (only used if skillMdContent is not provided)

Response

200

Skill updated successfully