Skip to main content
POST
List skills

Restrictions

Usage

  • The content field is omitted in list rows; fetch a single skill to read its body.
  • scope selects all (default), account-only, or team-only, overriding include_account; non-admins requesting specific team_ids are silently filtered down to the teams they belong to.
  • update_available compares against the marketplace catalog once per call; if the catalog fails to load, the badge is simply suppressed rather than the request failing.

Authorizations

app_key
string
query
required

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

application/json

Pagination, search, and team filter for listing skills.

p
integer
default:1

Page number, 1-based.

limit
integer
default:20

Page size.

scope
enum<string>

Restrict results to all (default), account-only (team_id=0), or team-only (excludes account-scoped rows). Overrides include_account when set.

Available options:
all,
account,
team
query
string

Free-text search across skill name, description, English description, skill ID, marketplace source template name, and author.

Maximum string length: 128
team_ids
integer<int64>[]

Filter to these team IDs; empty = the caller's visible set.

include_account
boolean | null

Include account-scoped (team_id=0) rows. Defaults to true. Ignored when scope is account or team.

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

Paginated skill list.