Microsoft Azure TrainingApi — TagsApi

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure TrainingApi — TagsApi
  description: 'Microsoft Azure TrainingApi — TagsApi. 5 operations. Lead operation: Microsoft Azure Get The Tags For A Given
    Project And Iteration. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - TagsApi
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: trainingapi-tagsapi
    baseUri: https://southcentralus.api.cognitive.microsoft.com/customvision/v2.1/Training
    description: Microsoft Azure TrainingApi — TagsApi business capability. Self-contained, no shared references.
    resources:
    - name: projects-projectId-tags
      path: /projects/{projectId}/tags
      operations:
      - name: microsoftazuregettags
        method: GET
        description: Microsoft Azure Get The Tags For A Given Project And Iteration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectId
          in: path
          type: string
          description: The project id
          required: true
        - name: iterationId
          in: query
          type: string
          description: The iteration id. Defaults to workspace
      - name: microsoftazurecreatetag
        method: POST
        description: Microsoft Azure Create A Tag For The Project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectId
          in: path
          type: string
          description: The project id
          required: true
        - name: name
          in: query
          type: string
          description: The tag name
          required: true
        - name: description
          in: query
          type: string
          description: Optional description for the tag
    - name: projects-projectId-tags-tagId
      path: /projects/{projectId}/tags/{tagId}
      operations:
      - name: microsoftazuregettag
        method: GET
        description: Microsoft Azure Get Information About A Specific Tag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectId
          in: path
          type: string
          description: The project this tag belongs to
          required: true
        - name: tagId
          in: path
          type: string
          description: The tag id
          required: true
        - name: iterationId
          in: query
          type: string
          description: The iteration to retrieve this tag from. Optional, defaults to current training set
      - name: microsoftazuredeletetag
        method: DELETE
        description: Microsoft Azure Delete A Tag From The Project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectId
          in: path
          type: string
          description: The project id
          required: true
        - name: tagId
          in: path
          type: string
          description: Id of the tag to be deleted
          required: true
      - name: microsoftazureupdatetag
        method: PATCH
        description: Microsoft Azure Update A Tag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectId
          in: path
          type: string
          description: The project id
          required: true
        - name: tagId
          in: path
          type: string
          description: The id of the target tag
          required: true
        - name: updatedTag
          in: body
          type: string
          description: The updated tag model
          required: true
  exposes:
  - type: rest
    namespace: trainingapi-tagsapi-rest
    port: 8080
    description: REST adapter for Microsoft Azure TrainingApi — TagsApi. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/projects/{projectid}/tags
      name: projects-projectid-tags
      description: REST surface for projects-projectId-tags.
      operations:
      - method: GET
        name: microsoftazuregettags
        description: Microsoft Azure Get The Tags For A Given Project And Iteration
        call: trainingapi-tagsapi.microsoftazuregettags
        with:
          projectId: rest.projectId
          iterationId: rest.iterationId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazurecreatetag
        description: Microsoft Azure Create A Tag For The Project
        call: trainingapi-tagsapi.microsoftazurecreatetag
        with:
          projectId: rest.projectId
          name: rest.name
          description: rest.description
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/projects/{projectid}/tags/{tagid}
      name: projects-projectid-tags-tagid
      description: REST surface for projects-projectId-tags-tagId.
      operations:
      - method: GET
        name: microsoftazuregettag
        description: Microsoft Azure Get Information About A Specific Tag
        call: trainingapi-tagsapi.microsoftazuregettag
        with:
          projectId: rest.projectId
          tagId: rest.tagId
          iterationId: rest.iterationId
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazuredeletetag
        description: Microsoft Azure Delete A Tag From The Project
        call: trainingapi-tagsapi.microsoftazuredeletetag
        with:
          projectId: rest.projectId
          tagId: rest.tagId
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: microsoftazureupdatetag
        description: Microsoft Azure Update A Tag
        call: trainingapi-tagsapi.microsoftazureupdatetag
        with:
          projectId: rest.projectId
          tagId: rest.tagId
          updatedTag: rest.updatedTag
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: trainingapi-tagsapi-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure TrainingApi — TagsApi. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: microsoft-azure-get-tags-given
      description: Microsoft Azure Get The Tags For A Given Project And Iteration
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: trainingapi-tagsapi.microsoftazuregettags
      with:
        projectId: tools.projectId
        iterationId: tools.iterationId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-create-tag-project
      description: Microsoft Azure Create A Tag For The Project
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: trainingapi-tagsapi.microsoftazurecreatetag
      with:
        projectId: tools.projectId
        name: tools.name
        description: tools.description
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-information-about
      description: Microsoft Azure Get Information About A Specific Tag
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: trainingapi-tagsapi.microsoftazuregettag
      with:
        projectId: tools.projectId
        tagId: tools.tagId
        iterationId: tools.iterationId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-delete-tag-project
      description: Microsoft Azure Delete A Tag From The Project
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: trainingapi-tagsapi.microsoftazuredeletetag
      with:
        projectId: tools.projectId
        tagId: tools.tagId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-update-tag
      description: Microsoft Azure Update A Tag
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: trainingapi-tagsapi.microsoftazureupdatetag
      with:
        projectId: tools.projectId
        tagId: tools.tagId
        updatedTag: tools.updatedTag
      outputParameters:
      - type: object
        mapping: $.