0

Get projects in a team

by
Published Apr 8, 2025

You can use this endpoint to get a list of all the Projects 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.

Script figma Verified

The script

Submitted by hugo697 Bun
Verified 428 days ago
1
//native
2
type Figma = {
3
  token: string;
4
};
5
/**
6
 * Get projects in a team
7
 * You can use this endpoint to get a list of all the Projects 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.
8
 */
9
export async function main(auth: Figma, team_id: string) {
10
  const url = new URL(`https://api.figma.com/v1/teams/${team_id}/projects`);
11

12
  const response = await fetch(url, {
13
    method: "GET",
14
    headers: {
15
      Authorization: "Bearer " + auth.token,
16
    },
17
    body: undefined,
18
  });
19
  if (!response.ok) {
20
    const text = await response.text();
21
    throw new Error(`${response.status} ${text}`);
22
  }
23
  return await response.json();
24
}
25