The files column represents files attached to a board.

Check out our help center to learn more about the files column.

This column is partially supported by our API. You can read the files column via the API but cannot update it.

Reading the files column

You can return the data in a files column in two different formats. The text field will return the data as a simple string that displays the URL of the file. The value field will return the data as a JSON string that shows metadata about the files. You cannot select which metadata you want to return.

Therefore, we recommend querying the assets field instead of the file column to simplify your query. Doing so allows you to specify the exact information you want to return. You will also have additional fields to choose from that can return more metadata than querying the files column.

query {
  boards (ids:2973227049) {
    items (ids: 2973227079) {
      assets {


Do you have questions?

Join our developer community! You can share your questions and learn from fellow users and product experts.

Don’t forget to search before opening a new topic!

Did this page help you?