Skip to main content
POST
List templates

Restrictions

Usage

  • The first page always starts with the built-in preset template (template_id 6321aad26c12104586a88916), whatever the filters; it is also counted in total.
  • Results are sorted by orderby (default created_at), newest first unless asc is true. Soft-deleted templates are excluded.
  • is_my_team: true limits results to templates of the caller’s teams; with team_ids also sent, only the teams in both lists are kept. If that intersection is empty, or the caller belongs to no team, the response is empty (total = 0, no preset).
  • query is a case-insensitive regular expression on template_name; an invalid expression is matched as literal text.

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

Paginated list filters. Defaults: p=1, limit=20. Max limit=100.

p
integer
default:1

Page number, starting at 1.

Required range: x >= 1
Example:

1

limit
integer
default:20

Page size. Capped at 100.

Required range: 1 <= x <= 100
Example:

20

orderby
enum<string>

Sort field: created_at (default, creation time) or updated_at (last update time).

Available options:
created_at,
updated_at
asc
boolean
default:false

Sort ascending when true; defaults to newest first.

is_my_team
boolean
default:false

When true, only templates of teams the caller belongs to are returned. If team_ids is also sent, only teams in both lists are kept. When they share no team, or the caller belongs to no team, the result is empty.

team_ids
integer<int64>[]

Return only templates of these team IDs (from POST /team/list); 0 selects account-wide templates. Empty or omitted applies no team filter. See is_my_team for how the two combine.

creator_id
integer<int64> | null

Filter by creator member ID; obtain member IDs from POST /member/list.

query
string

Case-insensitive regular expression matched against template_name; an invalid expression is matched as literal text.

Response

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

Paginated template list.