Skip to main content
POST
Update skill

Restrictions

Usage

  • Only skills the caller may edit can be updated; others return AccessDenied.
  • Every call is recorded in the account’s audit log.

Authorizations

app_key
string
query
required

App key issued from the Flashduty console under Account → APP Keys. Required on every public API call.

Body

application/json

Editable fields of a skill.

skill_id
string
required

Identifier of the skill to update.

description
string

New description for the skill.

Maximum string length: 1024
team_id
integer<int64>

Reassign the skill to this team; omit to leave unchanged, 0 for account scope.

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 capability the agent can load at runtime.