Endpoints

See information about your projects and files within a project.

info

Limited Access

The Projects endpoints are only available for selected use cases and are not available to all apps. If you'd like to use these endpoints, you can request access.

GET team projects

You can use this endpoint to get a list of all the projects within the specified team. It returns only projects visible to the authenticated user or owner of the developer token.

It is not possible to programmatically obtain team IDs. To obtain a team ID, navigate to the team page in the Figma file browser. The team ID is present in the URL after the word team and before your team name.

info

This is a Tier 2 endpoint and requires the projects:read scope.

HTTP Endpoint

GET /v1/teams/:team_id/projects

Path parameters	Description
team_id	String ID of the team to list projects from

Error codes	Description
400	Error with the request. The "message" param on the response will describe the error.
403	The developer / OAuth token is invalid or expired

GET project files

List the files in a given project.

info

This is a Tier 2 endpoint and requires the projects:read scope.

HTTP Endpoint

GET /v1/projects/:project_id/files

Path parameters	Description
project_id	String ID of the project to list files from
branch_data	Booleandefault: false Returns branch metadata in the response for each main file with a branch inside the project.

Error codes	Description
400	Error with the request. The message param on the response will describe the error.
403	The developer / OAuth token is invalid or expired