Skip to main content
POST
Update skill

Restrictions

Usage

  • Requires edit rights on the skill: account-scope skills (team_id = 0) are editable by account owners and admins; team skills only by members of that team (no owner or admin exemption). Otherwise the call returns AccessDenied.
  • Only description, description_en, and team_id can be changed; change the skill body by uploading a new archive.
  • description changes only when non-empty, so it cannot be cleared. description_en changes whenever sent; an empty string clears it.
  • Moving to a team (team_id > 0) requires membership in the target team; moving to account scope (team_id = 0) requires an account owner or admin. Marketplace-installed skills can only move to account scope. A name clash in the target scope returns InvalidParameter.
  • Every call is recorded in the account audit log.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

Editable skill metadata.

skill_id
string
required

Target skill ID, from the list returned by POST /safari/skill/list.

description
string

New description. Cannot contain < or >. Sending an empty string leaves the current value unchanged — there is no way to clear it via this field.

Maximum string length: 1024
description_en
string | null

New English description. Cannot contain < or >. Omit to leave unchanged; send an empty string to explicitly clear it.

Maximum string length: 1024
team_id
integer<int64> | null

Reassign 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.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

Error payload inside the response envelope. Present only on non-2xx responses.

data
object

An AI SRE skill — a packaged SKILL.md bundle the agent can load.