{"formatVersion":"1","kind":"dock_integration","slug":"figma-rest-api","title":"Figma REST API","summary":"Import a Harbor-safe Figma starter set for file inspection, comment retrieval, and team project listing.","description":"A Dock-hosted Figma REST API starter integration for Harbor. Importing it creates a local http_api port shell plus a Harbor-safe Figma action set for getting a file, getting file comments, and listing team projects. Tokens remain local to Harbor Node.","version":"0.1.0","publisher":{"slug":"figma","name":"Figma","websiteUrl":"https://developers.figma.com/"},"category":"Design","tags":["figma","design","files","comments","projects"],"compatibility":{"harborNode":">=0.1.0","notes":"Requires local operator-configured auth after import. This starter set assumes a local Figma personal access token sent through X-Figma-Token."},"requiredPlan":"community","portTemplates":[{"kind":"http_api","label":"Figma REST API","description":"Figma REST API connection managed locally through Harbor.","baseUrl":"https://api.figma.com/","authMode":"header_token","authHeaderName":"X-Figma-Token"}],"actionTemplates":[{"slug":"get-file","label":"Get File","description":"Fetch a Figma file using an explicit file key and bounded query parameters.","method":"GET","path":"/v1/files/{file_key}","inputs":{"parameters":[{"name":"file_key","in":"path","required":true,"schema":{"type":"string","minLength":1},"description":"Figma file key."},{"name":"version","in":"query","schema":{"type":"string"},"description":"Optional specific version ID to retrieve."},{"name":"depth","in":"query","schema":{"type":"integer","minimum":1},"description":"Optional maximum depth into the document tree."},{"name":"branch_data","in":"query","schema":{"type":"boolean"},"description":"Whether to include branch metadata for the requested file."}]},"approvalMode":"automatic","requestBodyMode":"none","resultMode":"json_summary"},{"slug":"get-comments","label":"Get Comments","description":"Get comments for a Figma file using an explicit file key.","method":"GET","path":"/v1/files/{file_key}/comments","inputs":{"parameters":[{"name":"file_key","in":"path","required":true,"schema":{"type":"string","minLength":1},"description":"Figma file key."},{"name":"as_md","in":"query","schema":{"type":"boolean"},"description":"Whether to return comments as markdown when applicable."}]},"approvalMode":"automatic","requestBodyMode":"none","resultMode":"json_summary"},{"slug":"list-team-projects","label":"List Team Projects","description":"List Figma projects for a specific team using an explicit team ID.","method":"GET","path":"/v1/teams/{team_id}/projects","inputs":{"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","minLength":1},"description":"Figma team identifier."}]},"approvalMode":"automatic","requestBodyMode":"none","resultMode":"json_summary"}],"helpText":"Import to Harbor, configure local auth, then validate get-file before using get-comments or list-team-projects. Review required scopes carefully because file, comment, and project endpoints each have their own access requirements.","installNotes":"Dock shares only safe metadata. Hidden auth must be configured locally inside Harbor after import. Figma actions use X-Figma-Token and explicit file or team identifiers instead of broad freeform transport input."}