Skip to main content
POST
List skills

Restrictions

Usage

  • Returns account-scope skills plus skills of teams the caller belongs to, sorted by skill_name ascending. Team membership is real membership for every role; team_ids outside the caller’s teams are silently dropped.
  • scope overrides include_account: account returns only account-scope skills, team only the caller’s team skills.
  • content is omitted in list rows; call POST /safari/skill/get for the body.
  • update_available compares each marketplace-installed skill with the current catalog; if the catalog cannot be loaded, it is false for every row instead of failing the request.

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

Pagination, search, and team filter for listing skills.

p
integer
default:1

Page number, 1-based; values below 1 fall back to 1.

limit
integer
default:20

Page size; values below 1 fall back to 20.

scope
enum<string>

Which skills to return; overrides include_account when set:

  • all (default): account-scope skills (unless include_account is false) plus the caller's team skills
  • account: account-scope skills only (team_id = 0)
  • team: the caller's team skills only
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>[]

Limit team-scope results to these team IDs; IDs of teams the caller does not belong to are dropped. Empty = all of the caller's teams.

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.