---
title: "Get all your Cannoli files"
method: GET
path: "/figma/files/"
tags: ["Figma"]
---

# Get all your Cannoli files

`GET /figma/files/`

## Request

- Base URL: `http://api.cannoli.app/api/v1`
- URL: `http://api.cannoli.app/api/v1/figma/files/`
- Auth: none declared

### Ordering
The file list is order by `created_at` descending. You can override the ordering through the 
`ordering` query parameter with the following fields:
* `created_at`
* `updated_at` 
* `name`  

Fields are ordered as ascending by default and you can change it to descending by adding `-` before
the field, eg `-created_at`

Here are a few examples to update the file list ordering.

Order by creation date, ascending

    /api/v1/figma/files/?ordering=created_at

Order by creation date, descending

    /api/v1/figma/files/?ordering=-created_at

You can also order by multiple fields separating by comma

    /api/v1/figma/files/?ordering=-created_at,name

## Query parameters

- `ordering` string

## Response `200`

OK

- FileList[]
  - `id` integer
  - `name` string, nullable
  - `created_by` string
  - `figma_file_id` string
  - `node` string, required
  - `url` string, uri, required
  - `team` Team, required
    - `id` integer
    - `name` string, required
    - `organization` string
    - `owner` string
    - `permission` string
    - `logo` string, uri, nullable
    - `can_add_more_members` string
    - `projects` Project[]
      - `id` integer
      - `name` string, required
      - `team_id` string
      - `team_name` string
      - `created_at` string, date-time
      - `last_updated_at` string, date-time
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `public` boolean
  - `preview` string, uri, nullable
  - `project` Project, required
    - `id` integer
    - `name` string, required
    - `team_id` string
    - `team_name` string
    - `created_at` string, date-time
    - `last_updated_at` string, date-time
  - `plugin_metadata` object, nullable

---

[API](https://skmtc.dev/cannoli/apis/cannoli-backend-api.md) - [All operations](https://skmtc.dev/cannoli/apis/cannoli-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cannoli/apis/cannoli-backend-api/revisions/d27aef14fd7a?raw)