Skip to main content
POST
List artifacts

Restrictions

Usage

  • scope selects all (default: the caller’s own personal artifacts plus artifacts of every team the caller belongs to), personal (only the caller’s own personal artifacts), or team (only artifacts owned by the caller’s teams). An unknown value is treated as all.
  • Visibility uses the app_key owner’s identity and real team membership; account owners and admins see no extra artifacts here. To open any artifact in the account by ID, use /safari/artifact/gallery/get.
  • The caller’s pinned artifacts always come first; the rest are sorted by updated_at descending unless orderby/asc say otherwise.

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

Filter and paginate the artifact gallery.

scope
enum<string>
default:all

Visibility scope. all (default) lists the caller's own personal artifacts plus artifacts of every team the caller belongs to; personal lists only the caller's own; team lists only team-owned artifacts of the caller's teams.

Available options:
all,
personal,
team
team_ids
integer<int64>[]

Restrict to artifacts owned by these team IDs, intersected with the scope filter. Non-positive IDs are ignored; teams the caller does not belong to return nothing, and personal artifacts are excluded whenever this is set.

query
string

Case-insensitive substring match on the artifact title.

page
integer
default:1

Page number, 1-based. Values below 1 are treated as 1.

limit
integer
default:20

Number of artifacts per page. Values below 1 fall back to 20; values above 100 are capped at 100 (not rejected).

orderby
enum<string>

Sort field: created_at (publish time) or updated_at (last change). Empty sorts by updated_at descending. In every case the caller's pinned artifacts come first, and artifact_id breaks ties.

Available options:
created_at,
updated_at
asc
boolean

Sort ascending when true, descending when false. Applies only when orderby is set.

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

A page of gallery artifacts.