Flyte Admin API — MatchableAttributes

naftiko: 1.0.0-alpha2
info:
  label: Flyte Admin API — MatchableAttributes
  description: 'Flyte Admin API — MatchableAttributes. 7 operations. Lead operation: List matchable attributes. Self-contained
    Naftiko capability covering one Flyte business surface.'
  tags:
  - Flyte
  - MatchableAttributes
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    FLYTE_API_KEY: FLYTE_API_KEY
capability:
  consumes:
  - type: http
    namespace: admin-matchableattributes
    baseUri: http://localhost:30080
    description: Flyte Admin API — MatchableAttributes business capability. Self-contained, no shared references.
    resources:
    - name: api-v1-matchable_attributes
      path: /api/v1/matchable_attributes
      operations:
      - name: listmatchableattributes
        method: GET
        description: List matchable attributes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-v1-project_attributes-attributes.project
      path: /api/v1/project_attributes/{attributes.project}
      operations:
      - name: updateprojectattributes
        method: PUT
        description: Update project attributes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: attributes.project
          in: path
          type: string
          required: true
    - name: api-v1-project_attributes-project
      path: /api/v1/project_attributes/{project}
      operations:
      - name: getprojectattributes
        method: GET
        description: Retrieve project attributes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: project
          in: path
          type: string
          required: true
    - name: api-v1-project_domain_attributes-attributes.project-attributes.domain
      path: /api/v1/project_domain_attributes/{attributes.project}/{attributes.domain}
      operations:
      - name: updateprojectdomainattributes
        method: PUT
        description: Update project-domain attributes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: attributes.project
          in: path
          type: string
          required: true
        - name: attributes.domain
          in: path
          type: string
          required: true
    - name: api-v1-project_domain_attributes-project-domain
      path: /api/v1/project_domain_attributes/{project}/{domain}
      operations:
      - name: getprojectdomainattributes
        method: GET
        description: Retrieve project-domain attributes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: project
          in: path
          type: string
          required: true
        - name: domain
          in: path
          type: string
          required: true
    - name: api-v1-workflow_attributes-attributes.project-attributes.domain-attributes.workf
      path: /api/v1/workflow_attributes/{attributes.project}/{attributes.domain}/{attributes.workflow}
      operations:
      - name: updateworkflowattributes
        method: PUT
        description: Update workflow attributes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: attributes.project
          in: path
          type: string
          required: true
        - name: attributes.domain
          in: path
          type: string
          required: true
        - name: attributes.workflow
          in: path
          type: string
          required: true
    - name: api-v1-workflow_attributes-project-domain-workflow
      path: /api/v1/workflow_attributes/{project}/{domain}/{workflow}
      operations:
      - name: getworkflowattributes
        method: GET
        description: Retrieve workflow attributes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: project
          in: path
          type: string
          required: true
        - name: domain
          in: path
          type: string
          required: true
        - name: workflow
          in: path
          type: string
          required: true
  exposes:
  - type: rest
    namespace: admin-matchableattributes-rest
    port: 8080
    description: REST adapter for Flyte Admin API — MatchableAttributes. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/api/v1/matchable-attributes
      name: api-v1-matchable-attributes
      description: REST surface for api-v1-matchable_attributes.
      operations:
      - method: GET
        name: listmatchableattributes
        description: List matchable attributes
        call: admin-matchableattributes.listmatchableattributes
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/project-attributes/{attributes-project}
      name: api-v1-project-attributes-attributes-project
      description: REST surface for api-v1-project_attributes-attributes.project.
      operations:
      - method: PUT
        name: updateprojectattributes
        description: Update project attributes
        call: admin-matchableattributes.updateprojectattributes
        with:
          attributes.project: rest.attributes.project
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/project-attributes/{project}
      name: api-v1-project-attributes-project
      description: REST surface for api-v1-project_attributes-project.
      operations:
      - method: GET
        name: getprojectattributes
        description: Retrieve project attributes
        call: admin-matchableattributes.getprojectattributes
        with:
          project: rest.project
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/project-domain-attributes/{attributes-project}/{attributes-domain}
      name: api-v1-project-domain-attributes-attributes-project-attributes-domain
      description: REST surface for api-v1-project_domain_attributes-attributes.project-attributes.domain.
      operations:
      - method: PUT
        name: updateprojectdomainattributes
        description: Update project-domain attributes
        call: admin-matchableattributes.updateprojectdomainattributes
        with:
          attributes.project: rest.attributes.project
          attributes.domain: rest.attributes.domain
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/project-domain-attributes/{project}/{domain}
      name: api-v1-project-domain-attributes-project-domain
      description: REST surface for api-v1-project_domain_attributes-project-domain.
      operations:
      - method: GET
        name: getprojectdomainattributes
        description: Retrieve project-domain attributes
        call: admin-matchableattributes.getprojectdomainattributes
        with:
          project: rest.project
          domain: rest.domain
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/workflow-attributes/{attributes-project}/{attributes-domain}/{attributes-workflow}
      name: api-v1-workflow-attributes-attributes-project-attributes-domain-attributes-workf
      description: REST surface for api-v1-workflow_attributes-attributes.project-attributes.domain-attributes.workf.
      operations:
      - method: PUT
        name: updateworkflowattributes
        description: Update workflow attributes
        call: admin-matchableattributes.updateworkflowattributes
        with:
          attributes.project: rest.attributes.project
          attributes.domain: rest.attributes.domain
          attributes.workflow: rest.attributes.workflow
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/workflow-attributes/{project}/{domain}/{workflow}
      name: api-v1-workflow-attributes-project-domain-workflow
      description: REST surface for api-v1-workflow_attributes-project-domain-workflow.
      operations:
      - method: GET
        name: getworkflowattributes
        description: Retrieve workflow attributes
        call: admin-matchableattributes.getworkflowattributes
        with:
          project: rest.project
          domain: rest.domain
          workflow: rest.workflow
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: admin-matchableattributes-mcp
    port: 9090
    transport: http
    description: MCP adapter for Flyte Admin API — MatchableAttributes. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: list-matchable-attributes
      description: List matchable attributes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-matchableattributes.listmatchableattributes
      outputParameters:
      - type: object
        mapping: $.
    - name: update-project-attributes
      description: Update project attributes
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: admin-matchableattributes.updateprojectattributes
      with:
        attributes.project: tools.attributes.project
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-project-attributes
      description: Retrieve project attributes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-matchableattributes.getprojectattributes
      with:
        project: tools.project
      outputParameters:
      - type: object
        mapping: $.
    - name: update-project-domain-attributes
      description: Update project-domain attributes
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: admin-matchableattributes.updateprojectdomainattributes
      with:
        attributes.project: tools.attributes.project
        attributes.domain: tools.attributes.domain
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-project-domain-attributes
      description: Retrieve project-domain attributes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-matchableattributes.getprojectdomainattributes
      with:
        project: tools.project
        domain: tools.domain
      outputParameters:
      - type: object
        mapping: $.
    - name: update-workflow-attributes
      description: Update workflow attributes
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: admin-matchableattributes.updateworkflowattributes
      with:
        attributes.project: tools.attributes.project
        attributes.domain: tools.attributes.domain
        attributes.workflow: tools.attributes.workflow
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-workflow-attributes
      description: Retrieve workflow attributes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-matchableattributes.getworkflowattributes
      with:
        project: tools.project
        domain: tools.domain
        workflow: tools.workflow
      outputParameters:
      - type: object
        mapping: $.