files

Query

Returns a searchable, paged list of files.

Arguments

after String: Returns the elements in the list that come after the specified cursor.
before String: Returns the elements in the list that come before the specified cursor.
first Int: Returns the first n elements from the list.
last Int: Returns the last n elements from the list.
query String: A filter expression made up of terms, boolean operators, modifiers, and comparators. Combine one or more filters in a single query.
Available filters7
defaultstring
Searches indexed file names, extensions, media types, and content hashes. Every term must match.
Examplesproduct photoimage/jpeg
idID
Matches a file by its unique identifier.
Exampleid:media_...
file_namestring
Matches the file name. Phrases and prefix wildcards are supported.
Examplesfile_name:"product photo.jpg"file_name:product*
file_extensionstring
Matches the file extension without a leading dot.
Examplefile_extension:jpg
content_typestring
Matches the file's media type.
Examplecontent_type:image/jpeg
hashstring
Matches the stored content hash.
Examplehash:abc123...
created_atdate
Compares the file creation date using an ISO 8601 date or timestamp.
Examplecreated_at:>="2026-01-01"
Query language guide
sortDirection SortDirection: Sort direction (ascending or descending).
Possible enum values
ASC
Orders values from lowest to highest or alphabetically from A to Z.
DESC
Orders values from highest to lowest or alphabetically from Z to A.
sortKey MediaSortKeys: Field key to sort by.
Possible enum values
CREATED_AT
Sorts by the date and time the media was created.
FILE_NAME
Sorts by the original file name.
FILE_SIZE
Sorts by the file size in bytes.

Payload

edges [MediaEdge!]: A list of edges.
nodes [Media!]: A flattened list of the nodes
pageInfo PageInfo!: Information to aid in pagination.
totalCount Int!: Identifies the total count of items in the connection.