naftiko: 1.0.0-alpha2
info:
  label: Sumo Logic API — parsersLibraryManagement
  description: 'Sumo Logic API — parsersLibraryManagement. 18 operations. Lead operation: Bulk Read Folders And Parsers..
    Self-contained Naftiko capability covering one Sumo Logic business surface.'
  tags:
  - Sumo Logic
  - parsersLibraryManagement
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SUMO_LOGIC_API_KEY: SUMO_LOGIC_API_KEY
capability:
  consumes:
  - type: http
    namespace: sumo-logic-parserslibrarymanagement
    baseUri: https://api.au.sumologic.com/api
    description: Sumo Logic API — parsersLibraryManagement business capability. Self-contained, no shared references.
    resources:
    - name: v1-parsers
      path: /v1/parsers
      operations:
      - name: parsersreadbyids
        method: GET
        description: Bulk Read Folders And Parsers.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ids
          in: query
          type: array
          description: A comma-separated list of identifiers.
          required: true
      - name: parserscreate
        method: POST
        description: Create A Folder Or Parser.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: parentId
          in: query
          type: string
          description: Identifier of the parent folder in which to create the folder or parser.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: parsersdeletebyids
        method: DELETE
        description: Bulk Delete Folders And Parsers.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ids
          in: query
          type: array
          description: A comma-separated list of identifiers.
          required: true
    - name: v1-parsers-path
      path: /v1/parsers/path
      operations:
      - name: parsersgetbypath
        method: GET
        description: Read A Folder Or Parser By Its Path.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: path
          in: query
          type: string
          description: The path of the folder or parser.
          required: true
    - name: v1-parsers-root
      path: /v1/parsers/root
      operations:
      - name: getparserslibraryroot
        method: GET
        description: Get The Root Folder In The Library.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-parsers-search
      path: /v1/parsers/search
      operations:
      - name: parserssearch
        method: GET
        description: Search For Folders Or Parsers.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: string
          description: 'The search query to find folder or parsers. Below is the list of different filters with examples:'
          required: true
        - name: limit
          in: query
          type: integer
          description: Maximum number of items you want in the response.
        - name: offset
          in: query
          type: integer
          description: The position or row from where to start the search operation.
    - name: v1-parsers-id
      path: /v1/parsers/{id}
      operations:
      - name: parsersreadbyid
        method: GET
        description: Read A Folder Or Parser.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: Identifier of the folder or parser to read.
          required: true
      - name: parsersupdatebyid
        method: PUT
        description: Update A Folder Or Parser.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: Identifier of the folder or parser to update.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: parsersdeletebyid
        method: DELETE
        description: Delete A Folder Or Parser.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: Identifier of the folder or parser to delete.
          required: true
    - name: v1-parsers-id-copy
      path: /v1/parsers/{id}/copy
      operations:
      - name: parserscopy
        method: POST
        description: Copy A Folder Or Parser.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: Identifier of the folder or parser to copy.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-parsers-id-export
      path: /v1/parsers/{id}/export
      operations:
      - name: parsersexportitem
        method: GET
        description: Export A Folder Or Parser.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: Identifier of the folder or parser to export.
          required: true
        - name: preserveLock
          in: query
          type: boolean
          description: Set this to true if you want to export an object and preserve the locked status.
    - name: v1-parsers-id-lock
      path: /v1/parsers/{id}/lock
      operations:
      - name: parserslockbyid
        method: POST
        description: Lock A Folder Or A Parser.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The id of the folder or parser that needs to be locked.
          required: true
    - name: v1-parsers-id-move
      path: /v1/parsers/{id}/move
      operations:
      - name: parsersmove
        method: POST
        description: Move A Folder Or Parser.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: Identifier of the folder or parser to move.
          required: true
        - name: parentId
          in: query
          type: string
          description: Identifier of the parent folder to move the folder or parser to.
          required: true
    - name: v1-parsers-id-path
      path: /v1/parsers/{id}/path
      operations:
      - name: getparsersfullpath
        method: GET
        description: Get Full Path Of Folder Or Parser.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: Identifier of the folder or parser.
          required: true
    - name: v1-parsers-id-unlock
      path: /v1/parsers/{id}/unlock
      operations:
      - name: parsersunlockbyid
        method: POST
        description: Unlock A Folder Or A Parser.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The id of the folder or parser that needs to be unlocked.
          required: true
    - name: v1-parsers-parentId-import
      path: /v1/parsers/{parentId}/import
      operations:
      - name: parsersimportitem
        method: POST
        description: Import A Folder Or Parser
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: parentId
          in: path
          type: string
          description: Identifier of the parent folder in which to import the folder or parser.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-system-parsers-id-lock
      path: /v1/system/parsers/{id}/lock
      operations:
      - name: systemparserslockbyid
        method: POST
        description: Lock A Folder Or A Parser.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The id of the folder or parser that needs to be locked.
          required: true
    - name: v1-system-parsers-id-unlock
      path: /v1/system/parsers/{id}/unlock
      operations:
      - name: systemparsersunlockbyid
        method: POST
        description: Unlock A Folder Or A Parser.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The id of the folder or parser that needs to be unlocked.
          required: true
    authentication:
      type: basic
      username: '{{env.SUMO_LOGIC_USER}}'
      password: '{{env.SUMO_LOGIC_PASS}}'
  exposes:
  - type: rest
    namespace: sumo-logic-parserslibrarymanagement-rest
    port: 8080
    description: REST adapter for Sumo Logic API — parsersLibraryManagement. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/v1/parsers
      name: v1-parsers
      description: REST surface for v1-parsers.
      operations:
      - method: GET
        name: parsersreadbyids
        description: Bulk Read Folders And Parsers.
        call: sumo-logic-parserslibrarymanagement.parsersreadbyids
        with:
          ids: rest.ids
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: parserscreate
        description: Create A Folder Or Parser.
        call: sumo-logic-parserslibrarymanagement.parserscreate
        with:
          parentId: rest.parentId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: parsersdeletebyids
        description: Bulk Delete Folders And Parsers.
        call: sumo-logic-parserslibrarymanagement.parsersdeletebyids
        with:
          ids: rest.ids
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/parsers/path
      name: v1-parsers-path
      description: REST surface for v1-parsers-path.
      operations:
      - method: GET
        name: parsersgetbypath
        description: Read A Folder Or Parser By Its Path.
        call: sumo-logic-parserslibrarymanagement.parsersgetbypath
        with:
          path: rest.path
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/parsers/root
      name: v1-parsers-root
      description: REST surface for v1-parsers-root.
      operations:
      - method: GET
        name: getparserslibraryroot
        description: Get The Root Folder In The Library.
        call: sumo-logic-parserslibrarymanagement.getparserslibraryroot
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/parsers/search
      name: v1-parsers-search
      description: REST surface for v1-parsers-search.
      operations:
      - method: GET
        name: parserssearch
        description: Search For Folders Or Parsers.
        call: sumo-logic-parserslibrarymanagement.parserssearch
        with:
          query: rest.query
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/parsers/{id}
      name: v1-parsers-id
      description: REST surface for v1-parsers-id.
      operations:
      - method: GET
        name: parsersreadbyid
        description: Read A Folder Or Parser.
        call: sumo-logic-parserslibrarymanagement.parsersreadbyid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: parsersupdatebyid
        description: Update A Folder Or Parser.
        call: sumo-logic-parserslibrarymanagement.parsersupdatebyid
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: parsersdeletebyid
        description: Delete A Folder Or Parser.
        call: sumo-logic-parserslibrarymanagement.parsersdeletebyid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/parsers/{id}/copy
      name: v1-parsers-id-copy
      description: REST surface for v1-parsers-id-copy.
      operations:
      - method: POST
        name: parserscopy
        description: Copy A Folder Or Parser.
        call: sumo-logic-parserslibrarymanagement.parserscopy
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/parsers/{id}/export
      name: v1-parsers-id-export
      description: REST surface for v1-parsers-id-export.
      operations:
      - method: GET
        name: parsersexportitem
        description: Export A Folder Or Parser.
        call: sumo-logic-parserslibrarymanagement.parsersexportitem
        with:
          id: rest.id
          preserveLock: rest.preserveLock
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/parsers/{id}/lock
      name: v1-parsers-id-lock
      description: REST surface for v1-parsers-id-lock.
      operations:
      - method: POST
        name: parserslockbyid
        description: Lock A Folder Or A Parser.
        call: sumo-logic-parserslibrarymanagement.parserslockbyid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/parsers/{id}/move
      name: v1-parsers-id-move
      description: REST surface for v1-parsers-id-move.
      operations:
      - method: POST
        name: parsersmove
        description: Move A Folder Or Parser.
        call: sumo-logic-parserslibrarymanagement.parsersmove
        with:
          id: rest.id
          parentId: rest.parentId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/parsers/{id}/path
      name: v1-parsers-id-path
      description: REST surface for v1-parsers-id-path.
      operations:
      - method: GET
        name: getparsersfullpath
        description: Get Full Path Of Folder Or Parser.
        call: sumo-logic-parserslibrarymanagement.getparsersfullpath
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/parsers/{id}/unlock
      name: v1-parsers-id-unlock
      description: REST surface for v1-parsers-id-unlock.
      operations:
      - method: POST
        name: parsersunlockbyid
        description: Unlock A Folder Or A Parser.
        call: sumo-logic-parserslibrarymanagement.parsersunlockbyid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/parsers/{parentid}/import
      name: v1-parsers-parentid-import
      description: REST surface for v1-parsers-parentId-import.
      operations:
      - method: POST
        name: parsersimportitem
        description: Import A Folder Or Parser
        call: sumo-logic-parserslibrarymanagement.parsersimportitem
        with:
          parentId: rest.parentId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/system/parsers/{id}/lock
      name: v1-system-parsers-id-lock
      description: REST surface for v1-system-parsers-id-lock.
      operations:
      - method: POST
        name: systemparserslockbyid
        description: Lock A Folder Or A Parser.
        call: sumo-logic-parserslibrarymanagement.systemparserslockbyid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/system/parsers/{id}/unlock
      name: v1-system-parsers-id-unlock
      description: REST surface for v1-system-parsers-id-unlock.
      operations:
      - method: POST
        name: systemparsersunlockbyid
        description: Unlock A Folder Or A Parser.
        call: sumo-logic-parserslibrarymanagement.systemparsersunlockbyid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: sumo-logic-parserslibrarymanagement-mcp
    port: 9090
    transport: http
    description: MCP adapter for Sumo Logic API — parsersLibraryManagement. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: bulk-read-folders-and-parsers
      description: Bulk Read Folders And Parsers.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-parserslibrarymanagement.parsersreadbyids
      with:
        ids: tools.ids
      outputParameters:
      - type: object
        mapping: $.
    - name: create-folder-parser
      description: Create A Folder Or Parser.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sumo-logic-parserslibrarymanagement.parserscreate
      with:
        parentId: tools.parentId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: bulk-delete-folders-and-parsers
      description: Bulk Delete Folders And Parsers.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: sumo-logic-parserslibrarymanagement.parsersdeletebyids
      with:
        ids: tools.ids
      outputParameters:
      - type: object
        mapping: $.
    - name: read-folder-parser-its-path
      description: Read A Folder Or Parser By Its Path.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-parserslibrarymanagement.parsersgetbypath
      with:
        path: tools.path
      outputParameters:
      - type: object
        mapping: $.
    - name: get-root-folder-library
      description: Get The Root Folder In The Library.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-parserslibrarymanagement.getparserslibraryroot
      outputParameters:
      - type: object
        mapping: $.
    - name: search-folders-parsers
      description: Search For Folders Or Parsers.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-parserslibrarymanagement.parserssearch
      with:
        query: tools.query
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: read-folder-parser
      description: Read A Folder Or Parser.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-parserslibrarymanagement.parsersreadbyid
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: update-folder-parser
      description: Update A Folder Or Parser.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: sumo-logic-parserslibrarymanagement.parsersupdatebyid
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-folder-parser
      description: Delete A Folder Or Parser.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: sumo-logic-parserslibrarymanagement.parsersdeletebyid
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: copy-folder-parser
      description: Copy A Folder Or Parser.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sumo-logic-parserslibrarymanagement.parserscopy
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: export-folder-parser
      description: Export A Folder Or Parser.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-parserslibrarymanagement.parsersexportitem
      with:
        id: tools.id
        preserveLock: tools.preserveLock
      outputParameters:
      - type: object
        mapping: $.
    - name: lock-folder-parser
      description: Lock A Folder Or A Parser.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sumo-logic-parserslibrarymanagement.parserslockbyid
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: move-folder-parser
      description: Move A Folder Or Parser.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sumo-logic-parserslibrarymanagement.parsersmove
      with:
        id: tools.id
        parentId: tools.parentId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-full-path-folder-parser
      description: Get Full Path Of Folder Or Parser.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-parserslibrarymanagement.getparsersfullpath
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: unlock-folder-parser
      description: Unlock A Folder Or A Parser.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sumo-logic-parserslibrarymanagement.parsersunlockbyid
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: import-folder-parser
      description: Import A Folder Or Parser
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sumo-logic-parserslibrarymanagement.parsersimportitem
      with:
        parentId: tools.parentId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: lock-folder-parser-2
      description: Lock A Folder Or A Parser.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sumo-logic-parserslibrarymanagement.systemparserslockbyid
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: unlock-folder-parser-2
      description: Unlock A Folder Or A Parser.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sumo-logic-parserslibrarymanagement.systemparsersunlockbyid
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.