Skip to main content
POST
List knowledge packs

Restrictions

Usage

  • Visibility matches the console: admins see the account pack plus every team pack; non-admins see the account pack plus their own teams, and requested team_ids are silently intersected with their teams.
  • scope selects all (default), account-only, or team-only, overriding include_account.
  • query applies a case-insensitive substring filter over pack ID, scope, and team name; p/limit paginate the filtered result.

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

Filter and pagination for the pack list.

p
integer

Page number, 1-based; returns all results when both p and limit are unset.

limit
integer

Page size.

scope
enum<string>

Restrict to one scope; all (default) overrides include_account. One of: all (account scope plus visible team scopes), account (account-level packs only), team (team-level packs only, can be combined with team_ids).

Available options:
all,
account,
team
query
string

Case-insensitive substring filter over pack ID, scope, and team name.

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

Restrict to these team IDs; for non-admins the list is intersected with their own teams.

include_account
boolean | null

Include the account-scope pack; defaults to true.

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

Visible packs and the total after filtering.