---
title: "[Deprecated] Get projects in a team"
method: GET
path: "/v1/teams/{team_id}/projects"
tags: ["Projects"]
deprecated: true
---

# [Deprecated] Get projects in a team

`GET /v1/teams/{team_id}/projects`

> **Deprecated.**

Deprecated in favor of [Get top-level folders in a team](https://developers.figma.com/docs/rest-api/folders-endpoints/). You can use this endpoint to get a list of the top-level Projects (now called "folders") within the specified team. This will only return projects visible to the authenticated user or owner of the developer token. Note: it is not currently possible to programmatically obtain the team id of a user just from a token. To obtain a team id, navigate to a team page of a team you are a part of. The team id will be present in the URL after the word team and before your team name.

## Path parameters

- `team_id` string, required

## Response `200`

Response from the GET /v1/teams/{team_id}/projects endpoint.

- object
  - `name` string, required — The team's name.
  - `projects` Project[], required — An array of projects.
    - `id` string, required — The ID of the project.
    - `name` string, required — The name of the project.

## Other responses

- `400` — Bad request. Parameters are invalid or malformed. Please check the input formats. This error can also happen if the requested resources are too large to complete the request, which results in a timeout. Please reduce the number and size of objects requested.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.
- `429` — In some cases API requests may be throttled or rate limited. Please wait a while before attempting the request again (typically a minute).
- `500` — An internal server error occurred.

## Changes

- **2026-08-11** `d7ab5681d84c` — 1 info
  - endpoint deprecated
- **2026-05-06** `2c69c439e847` — 1 info
  - the endpoint scheme security `PlanAccessToken` was added to the API
- **2025-04-24** `8014b4aceb2f` — 1 info
  - the security scope `projects:read` was added to the endpoint's security scheme `OAuth2`
- **2023-12-14** `de5c0106668d` — 2 info
  - the endpoint scheme security `PlanAccessToken` was removed from the API
  - the security scope `projects:read` was removed from the endpoint's security scheme `OAuth2`

[Change history](https://skmtc.dev/figma/apis/figma-api/changes/v1/teams/:team_id/projects/get.md)

---

[API](https://skmtc.dev/figma/apis/figma-api.md) · [All operations](https://skmtc.dev/figma/apis/figma-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/figma/figma-api/revisions/d7ab5681d84c/schema)