Update skill
Update a skill’s descriptions or reassign its team scope.
Restrictions
Usage
- Only
description,description_en, andteam_idare editable; the skill body is changed by re-uploading. descriptiononly updates when non-empty — there is no way to clear it via this field;description_enis nilable, so send an empty string to explicitly clear it.- Reassigning
team_idto a different team runs a second authorization check beyond edit access, verifying the caller may target the destination team. - Every call is recorded in the account audit log.
Authorizations
App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.
Body
Editable skill metadata.
Target skill ID.
New description. Cannot contain < or >. Sending an empty string leaves the current value unchanged — there is no way to clear it via this field.
1024New English description. Cannot contain < or >. Omit to leave unchanged; send an empty string to explicitly clear it.
1024Reassign team scope: 0 = account-wide; >0 = team. Omit to leave unchanged.
Response
Success
Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.
Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.
"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
Error payload inside the response envelope. Present only on non-2xx responses.
An AI SRE skill — a packaged SKILL.md bundle the agent can load.