Skip to main content
POST
Upload skill

Restrictions

Usage

  • Send multipart/form-data with a file part. Accepted archives: .skill, .zip, .tar.gz, .tgz, up to 100 MB; the archive must contain SKILL.md with valid frontmatter, and every declared tool must exist.
  • Without replace, a new skill is created in team_id; a skill with the same name in that scope returns InvalidParameter.
  • replace=true without skill_id overwrites the same-named skill in team_id (creating it if absent). replace=true with skill_id overwrites that skill; the archive’s skill name must match it, otherwise InvalidParameter.
  • Creating into team_id requires membership in that team (team_id = 0 requires an account owner or admin). Overwriting requires edit rights on the existing skill.
  • An overwrite keeps skill_id and scope, sets status back to enabled, and sets is_modified to true. The response always has can_edit: true.
  • 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

multipart/form-data

Multipart form for uploading a skill archive.

file
file
required

Skill archive (.skill, .zip, .tar.gz, or .tgz), up to 100 MB, containing SKILL.md at its root or inside a single top-level folder.

team_id
integer<int64>

Scope for the created or overwritten-by-name skill: 0 = account scope (default), >0 = that team. Ignored when replace=true and skill_id are both set.

replace
boolean

Set to true to overwrite an existing skill instead of failing on a name clash: the skill given by skill_id, or else the same-named skill in team_id. Defaults to false.

skill_id
string

ID of the skill to overwrite, from POST /safari/skill/list. Used only together with replace=true; ignored otherwise.

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.