naftiko: 1.0.0-alpha2
info:
  label: BigID Data Posture — Cases
  description: 'BigID Data Posture API — Actionable Insights Cases. 3 operations to list, bulk-update, and resolve DSPM
    cases. Self-contained Naftiko capability covering one BigID business surface.'
  tags:
    - BigID
    - DSPM
    - Posture
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      BIGID_BASE_URL: BIGID_BASE_URL
      BIGID_SYSTEM_TOKEN: BIGID_SYSTEM_TOKEN
capability:
  consumes:
    - type: http
      namespace: data-posture-cases
      baseUri: '{{env.BIGID_BASE_URL}}'
      description: BigID Data Posture business capability.
      resources:
        - name: insights-cases
          path: /api/v1/actionable-insights/all-cases
          operations:
            - name: listactionableinsightscases
              method: GET
              description: BigID List Actionable Insights Cases
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: filter
                  in: query
                  type: string
                - name: limit
                  in: query
                  type: integer
                - name: skip
                  in: query
                  type: integer
        - name: insights-cases-bulk
          path: /api/v1/actionable-insights/cases:{actionType}
          operations:
            - name: bulkupdateactionableinsightscases
              method: PATCH
              description: BigID Bulk Update Actionable Insights Cases
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: actionType
                  in: path
                  type: string
                  required: true
                - name: body
                  in: body
                  type: object
                  required: true
        - name: insights-case-status
          path: /api/v1/actionable-insights/case-status/{caseId}
          operations:
            - name: updateactionableinsightscasestatus
              method: PATCH
              description: BigID Update Actionable Insights Case Status
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: caseId
                  in: path
                  type: string
                  required: true
                - name: body
                  in: body
                  type: object
                  required: true
      authentication:
        type: bearer
        value: '{{env.BIGID_SYSTEM_TOKEN}}'
        placement: header
  exposes:
    - type: rest
      namespace: data-posture-cases-rest
      port: 8080
      description: REST adapter for BigID Data Posture.
      resources:
        - path: /v1/actionable-insights/all-cases
          name: insights-cases
          description: REST surface for insights-cases.
          operations:
            - method: GET
              name: listactionableinsightscases
              description: BigID List Actionable Insights Cases
              call: data-posture-cases.listactionableinsightscases
              with:
                filter: rest.query.filter
                limit: rest.query.limit
                skip: rest.query.skip
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/actionable-insights/cases:{actionType}
          name: insights-cases-bulk
          description: REST surface for insights-cases-bulk.
          operations:
            - method: PATCH
              name: bulkupdateactionableinsightscases
              description: BigID Bulk Update Actionable Insights Cases
              call: data-posture-cases.bulkupdateactionableinsightscases
              with:
                actionType: rest.path.actionType
                body: rest.body
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/actionable-insights/case-status/{caseId}
          name: insights-case-status
          description: REST surface for insights-case-status.
          operations:
            - method: PATCH
              name: updateactionableinsightscasestatus
              description: BigID Update Actionable Insights Case Status
              call: data-posture-cases.updateactionableinsightscasestatus
              with:
                caseId: rest.path.caseId
                body: rest.body
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: data-posture-cases-mcp
      port: 9090
      transport: http
      description: MCP adapter for BigID Data Posture.
      tools:
        - name: bigid-list-posture-cases
          description: BigID List Actionable Insights Cases
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: data-posture-cases.listactionableinsightscases
          with:
            filter: tools.filter
            limit: tools.limit
            skip: tools.skip
          outputParameters:
            - type: object
              mapping: $.
        - name: bigid-bulk-update-posture-cases
          description: BigID Bulk Update Actionable Insights Cases
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: data-posture-cases.bulkupdateactionableinsightscases
          with:
            actionType: tools.actionType
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.
        - name: bigid-update-posture-case-status
          description: BigID Update Actionable Insights Case Status
          hints:
            readOnly: false
            destructive: false
            idempotent: true
          call: data-posture-cases.updateactionableinsightscasestatus
          with:
            caseId: tools.caseId
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.