Microsoft Azure ContentSafety Service — Text

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure ContentSafety Service — Text
  description: 'Microsoft Azure ContentSafety Service — Text. 8 operations. Lead operation: Microsoft Azure Get All Text Blocklists.
    Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Text
  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: contentsafety-service-text
    baseUri: ''
    description: Microsoft Azure ContentSafety Service — Text business capability. Self-contained, no shared references.
    resources:
    - name: text-blocklists
      path: /text/blocklists
      operations:
      - name: microsoftazuretextblocklistslisttextblocklists
        method: GET
        description: Microsoft Azure Get All Text Blocklists
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: text-blocklists-blocklistName
      path: /text/blocklists/{blocklistName}
      operations:
      - name: microsoftazuretextblocklistsgettextblocklist
        method: GET
        description: Microsoft Azure Get Text Blocklist By Blocklistname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blocklistName
          in: path
          type: string
          description: Text blocklist name.
          required: true
      - name: microsoftazuretextblocklistscreateorupdatetextblocklist
        method: PATCH
        description: Microsoft Azure Create Or Update Text Blocklist
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blocklistName
          in: path
          type: string
          description: Text blocklist name.
          required: true
        - name: resource
          in: body
          type: string
          description: The resource instance.
          required: true
      - name: microsoftazuretextblocklistsdeletetextblocklist
        method: DELETE
        description: Microsoft Azure Delete Text Blocklist By Blocklistname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blocklistName
          in: path
          type: string
          description: Text blocklist name.
          required: true
    - name: text-blocklists-blocklistName-blocklistItems
      path: /text/blocklists/{blocklistName}/blocklistItems
      operations:
      - name: microsoftazuretextblocklistslisttextblocklistitems
        method: GET
        description: Microsoft Azure Get All Blocklistitems By Blocklistname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blocklistName
          in: path
          type: string
          description: Text blocklist name.
          required: true
    - name: text-blocklists-blocklistName-blocklistItems-blocklistItemId
      path: /text/blocklists/{blocklistName}/blocklistItems/{blocklistItemId}
      operations:
      - name: microsoftazuretextblocklistsgettextblocklistitem
        method: GET
        description: Microsoft Azure Get Blocklistitem By Blocklistname And Blocklistitemid
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blocklistName
          in: path
          type: string
          description: Text blocklist name.
          required: true
        - name: blocklistItemId
          in: path
          type: string
          description: The service will generate a BlocklistItemId, which will be a UUID.
          required: true
    - name: text-blocklists-blocklistName}:addOrUpdateBlocklistItems
      path: /text/blocklists/{blocklistName}:addOrUpdateBlocklistItems
      operations:
      - name: microsoftazuretextblocklistsaddorupdateblocklistitems
        method: POST
        description: Microsoft Azure Add Or Update Blocklistitems To Text Blocklist
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blocklistName
          in: path
          type: string
          description: Text blocklist name.
          required: true
        - name: body
          in: body
          type: string
          description: Options for adding or updating blocklist items.
          required: true
    - name: text-blocklists-blocklistName}:removeBlocklistItems
      path: /text/blocklists/{blocklistName}:removeBlocklistItems
      operations:
      - name: microsoftazuretextblocklistsremoveblocklistitems
        method: POST
        description: Microsoft Azure Remove Blocklistitems From Text Blocklist
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blocklistName
          in: path
          type: string
          description: Text blocklist name.
          required: true
        - name: body
          in: body
          type: string
          description: Options for removing blocklist items.
          required: true
  exposes:
  - type: rest
    namespace: contentsafety-service-text-rest
    port: 8080
    description: REST adapter for Microsoft Azure ContentSafety Service — Text. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/text/blocklists
      name: text-blocklists
      description: REST surface for text-blocklists.
      operations:
      - method: GET
        name: microsoftazuretextblocklistslisttextblocklists
        description: Microsoft Azure Get All Text Blocklists
        call: contentsafety-service-text.microsoftazuretextblocklistslisttextblocklists
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/text/blocklists/{blocklistname}
      name: text-blocklists-blocklistname
      description: REST surface for text-blocklists-blocklistName.
      operations:
      - method: GET
        name: microsoftazuretextblocklistsgettextblocklist
        description: Microsoft Azure Get Text Blocklist By Blocklistname
        call: contentsafety-service-text.microsoftazuretextblocklistsgettextblocklist
        with:
          blocklistName: rest.blocklistName
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: microsoftazuretextblocklistscreateorupdatetextblocklist
        description: Microsoft Azure Create Or Update Text Blocklist
        call: contentsafety-service-text.microsoftazuretextblocklistscreateorupdatetextblocklist
        with:
          blocklistName: rest.blocklistName
          resource: rest.resource
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazuretextblocklistsdeletetextblocklist
        description: Microsoft Azure Delete Text Blocklist By Blocklistname
        call: contentsafety-service-text.microsoftazuretextblocklistsdeletetextblocklist
        with:
          blocklistName: rest.blocklistName
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/text/blocklists/{blocklistname}/blocklistitems
      name: text-blocklists-blocklistname-blocklistitems
      description: REST surface for text-blocklists-blocklistName-blocklistItems.
      operations:
      - method: GET
        name: microsoftazuretextblocklistslisttextblocklistitems
        description: Microsoft Azure Get All Blocklistitems By Blocklistname
        call: contentsafety-service-text.microsoftazuretextblocklistslisttextblocklistitems
        with:
          blocklistName: rest.blocklistName
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/text/blocklists/{blocklistname}/blocklistitems/{blocklistitemid}
      name: text-blocklists-blocklistname-blocklistitems-blocklistitemid
      description: REST surface for text-blocklists-blocklistName-blocklistItems-blocklistItemId.
      operations:
      - method: GET
        name: microsoftazuretextblocklistsgettextblocklistitem
        description: Microsoft Azure Get Blocklistitem By Blocklistname And Blocklistitemid
        call: contentsafety-service-text.microsoftazuretextblocklistsgettextblocklistitem
        with:
          blocklistName: rest.blocklistName
          blocklistItemId: rest.blocklistItemId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/text/blocklists/blocklistname-addorupdateblocklistitems
      name: text-blocklists-blocklistname-addorupdateblocklistitems
      description: REST surface for text-blocklists-blocklistName}:addOrUpdateBlocklistItems.
      operations:
      - method: POST
        name: microsoftazuretextblocklistsaddorupdateblocklistitems
        description: Microsoft Azure Add Or Update Blocklistitems To Text Blocklist
        call: contentsafety-service-text.microsoftazuretextblocklistsaddorupdateblocklistitems
        with:
          blocklistName: rest.blocklistName
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/text/blocklists/blocklistname-removeblocklistitems
      name: text-blocklists-blocklistname-removeblocklistitems
      description: REST surface for text-blocklists-blocklistName}:removeBlocklistItems.
      operations:
      - method: POST
        name: microsoftazuretextblocklistsremoveblocklistitems
        description: Microsoft Azure Remove Blocklistitems From Text Blocklist
        call: contentsafety-service-text.microsoftazuretextblocklistsremoveblocklistitems
        with:
          blocklistName: rest.blocklistName
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: contentsafety-service-text-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure ContentSafety Service — Text. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: microsoft-azure-get-all-text
      description: Microsoft Azure Get All Text Blocklists
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: contentsafety-service-text.microsoftazuretextblocklistslisttextblocklists
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-text-blocklist
      description: Microsoft Azure Get Text Blocklist By Blocklistname
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: contentsafety-service-text.microsoftazuretextblocklistsgettextblocklist
      with:
        blocklistName: tools.blocklistName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-create-update-text
      description: Microsoft Azure Create Or Update Text Blocklist
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: contentsafety-service-text.microsoftazuretextblocklistscreateorupdatetextblocklist
      with:
        blocklistName: tools.blocklistName
        resource: tools.resource
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-delete-text-blocklist
      description: Microsoft Azure Delete Text Blocklist By Blocklistname
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: contentsafety-service-text.microsoftazuretextblocklistsdeletetextblocklist
      with:
        blocklistName: tools.blocklistName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-all-blocklistitems
      description: Microsoft Azure Get All Blocklistitems By Blocklistname
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: contentsafety-service-text.microsoftazuretextblocklistslisttextblocklistitems
      with:
        blocklistName: tools.blocklistName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-blocklistitem-blocklistname
      description: Microsoft Azure Get Blocklistitem By Blocklistname And Blocklistitemid
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: contentsafety-service-text.microsoftazuretextblocklistsgettextblocklistitem
      with:
        blocklistName: tools.blocklistName
        blocklistItemId: tools.blocklistItemId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-add-update-blocklistitems
      description: Microsoft Azure Add Or Update Blocklistitems To Text Blocklist
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: contentsafety-service-text.microsoftazuretextblocklistsaddorupdateblocklistitems
      with:
        blocklistName: tools.blocklistName
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-remove-blocklistitems-text
      description: Microsoft Azure Remove Blocklistitems From Text Blocklist
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: contentsafety-service-text.microsoftazuretextblocklistsremoveblocklistitems
      with:
        blocklistName: tools.blocklistName
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.