openapi: 3.1.0
info:
  title: Figma REST Comments Projects API
  description: 'The Figma REST API enables programmatic access to Figma files, images, projects,

    comments, users, components, and variables. Wireframes and designs can be read,

    images rendered, and comments managed.

    '
  version: '1.0'
  contact:
    name: Figma
    url: https://developers.figma.com/docs/rest-api/
servers:
- url: https://api.figma.com
  description: Figma REST API production server
- url: https://api.figma-gov.com
  description: Figma REST API for Government customers
security:
- personalAccessToken: []
- oauth2: []
tags:
- name: Projects
paths:
  /v1/teams/{team_id}/projects:
    parameters:
    - in: path
      name: team_id
      required: true
      schema:
        type: string
    get:
      tags:
      - Projects
      summary: List projects in a team
      operationId: listTeamProjects
      responses:
        '200':
          description: OK
  /v1/projects/{project_id}/meta:
    parameters:
    - in: path
      name: project_id
      required: true
      schema:
        type: string
    get:
      tags:
      - Projects
      summary: Get project metadata
      operationId: getProjectMeta
      responses:
        '200':
          description: OK
  /v1/projects/{project_id}/files:
    parameters:
    - in: path
      name: project_id
      required: true
      schema:
        type: string
    get:
      tags:
      - Projects
      summary: List files in a project
      operationId: listProjectFiles
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    personalAccessToken:
      type: apiKey
      in: header
      name: X-Figma-Token
      description: Personal Access Token authentication for Figma REST API
    oauth2:
      type: oauth2
      description: OAuth 2.0 authentication for registered applications
      flows:
        authorizationCode:
          authorizationUrl: https://www.figma.com/oauth
          tokenUrl: https://api.figma.com/v1/oauth/token
          scopes:
            files:read: Read files
            file_comments:write: Write file comments