Figma Inventory Team Styles

arazzo: 1.0.1
info:
  title: Figma Inventory Team Styles
  summary: List a team's published styles and pull full metadata for the first one.
  description: >-
    A library inventory flow for shared styles. The workflow lists the styles
    published by a team library and then retrieves the full metadata for the
    first style by its key, exposing the file, node, and style type the style
    maps back to. The team listing and the single-style lookup live in
    different Figma OpenAPI descriptions, so both are referenced as distinct
    source descriptions. Every step spells out its request inline so the flow
    can be read and executed without opening the underlying OpenAPI
    description. Authentication is carried by the Figma personal access token
    bearer credential declared on each operation's security requirement.
  version: 1.0.0
  x-realizes-capability-ids:
  - BC-4200.30
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-4200.30
      capability_name: Software Design Management
      spec: figma-components-api-openapi.yml
      confidence: 0.8
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: componentsApi
  url: ../openapi/figma-components-api-openapi.yml
  type: openapi
- name: keysApi
  url: ../openapi/figma-keys-api-openapi.yml
  type: openapi
workflows:
- workflowId: inventory-team-styles
  summary: List a team's published styles and resolve the first style's metadata.
  description: >-
    Lists the styles in a team library and retrieves full metadata for the
    first published style by key.
  inputs:
    type: object
    required:
    - teamId
    properties:
      teamId:
        type: string
        description: The ID of the team whose published styles are listed.
      pageSize:
        type: integer
        description: Number of styles to return per page.
  steps:
  - stepId: listTeamStyles
    description: >-
      List the styles published by the team library so a style can be selected
      for inspection.
    operationId: getTeamStyles
    parameters:
    - name: team_id
      in: path
      value: $inputs.teamId
    - name: page_size
      in: query
      value: $inputs.pageSize
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      styles: $response.body#/meta/styles
      firstStyleKey: $response.body#/meta/styles/0/key
  - stepId: getStyle
    description: >-
      Retrieve the full metadata for the first published style by its key.
    operationId: getStyle
    parameters:
    - name: key
      in: path
      value: $steps.listTeamStyles.outputs.firstStyleKey
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      styleName: $response.body#/meta/name
      styleType: $response.body#/meta/style_type
      styleFileKey: $response.body#/meta/file_key
  outputs:
    styleName: $steps.getStyle.outputs.styleName
    styleType: $steps.getStyle.outputs.styleType
    styleFileKey: $steps.getStyle.outputs.styleFileKey