Skip to main content
POST
List artifacts

Restrictions

Usage

  • scope selects all (default — the caller’s own personal artifacts plus every team the caller belongs to), personal (only the caller’s own), or team (only team-owned artifacts of the caller’s teams).
  • team_ids narrows further to specific teams, intersected with the caller’s visibility — teams the caller does not belong to return nothing.
  • Default sort is updated_at descending; set orderby to created_at to change the field and asc: true to flip direction.
  • For an app_key call, visibility is evaluated against the key owner’s identity — the list shows that member’s personal artifacts and their teams’ artifacts.

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 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 caller's visibility — teams the caller does not belong to silently return nothing.

query
string

Case-insensitive substring match on the artifact title.

page
integer
default:1

Page number, 1-based.

Required range: x >= 1
limit
integer
default:20

Page size. Defaults to 20; capped at 100.

Required range: x <= 100
orderby
enum<string>

Sort field: created_at or updated_at. Empty means updated_at descending.

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.