Skip to main content
PUT
/
skills
/
manage
Update a skill
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>"
}
'
{
  "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

Skill updated successfully