Skip to main content
PATCH
/
api
/
v2
/
skills
/
{name}
Patch a skill
curl --request PATCH \
  --url https://agp.eu.hcompany.ai/api/v2/skills/{name} \
  --header 'Authorization: Bearer <token>'
Partial update: only the fields you send change, everything else is preserved. Send a field as null to clear it. The merged result is validated like a full update, and name is not patchable (renames are not supported). Returns the updated Skill object.

​
Path parameters

​
name
string
required
The skill’s name (e.g. extract-table-data or myorg/web-helper). Slash-containing names are supported.

​
Request body

Any subset of the Skill object’s fields except name: description, body, source, url_pattern.

​
Examples

Change the description and nothing else: 
curl -X PATCH https://agp.eu.hcompany.ai/api/v2/skills/extract-table-data \
  -H "Authorization: Bearer $HAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description": "Extract data from HTML tables, with CSV output support."}'

​
Errors

StatusCause
403The skill is reserved (h/) and read-only.
404Skill not found or you don’t have access.
422The merged spec fails validation; common cases: description or body set to null or empty.