Pantry API

naftiko: 1.0.0-alpha2
info:
  label: Pantry API
  description: Pantry is a free service that provides perishable data storage for small projects. Use the RESTful API to post
    JSON objects and Pantry will store them. Data is automatically deleted after a period of inactivity.
  tags:
  - Pantry
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: pantry
    baseUri: https://getpantry.cloud/apiv1
    description: Pantry API HTTP API.
    resources:
    - name: pantry-create
      path: /pantry/create
      operations:
      - name: createpantry
        method: POST
        description: Create a new pantry
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pantry-pantryid
      path: /pantry/{pantryID}
      operations:
      - name: getpantry
        method: GET
        description: Get pantry details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatepantry
        method: PUT
        description: Update pantry details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletepantry
        method: DELETE
        description: Delete a pantry
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pantry-pantryid-basket-basketname
      path: /pantry/{pantryID}/basket/{basketName}
      operations:
      - name: createbasket
        method: POST
        description: Create a basket
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatebasket
        method: PUT
        description: Update basket contents
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getbasket
        method: GET
        description: Get basket contents
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletebasket
        method: DELETE
        description: Delete a basket
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pantry-pantryid-basket-basketname-public
      path: /pantry/{pantryID}/basket/{basketName}/public
      operations:
      - name: createpublicbasket
        method: GET
        description: Create a public basket link
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: pantry-rest
    description: REST adapter for Pantry API.
    resources:
    - path: /pantry/create
      name: createpantry
      operations:
      - method: POST
        name: createpantry
        description: Create a new pantry
        call: pantry.createpantry
        outputParameters:
        - type: object
          mapping: $.
    - path: /pantry/{pantryID}
      name: getpantry
      operations:
      - method: GET
        name: getpantry
        description: Get pantry details
        call: pantry.getpantry
        outputParameters:
        - type: object
          mapping: $.
    - path: /pantry/{pantryID}
      name: updatepantry
      operations:
      - method: PUT
        name: updatepantry
        description: Update pantry details
        call: pantry.updatepantry
        outputParameters:
        - type: object
          mapping: $.
    - path: /pantry/{pantryID}
      name: deletepantry
      operations:
      - method: DELETE
        name: deletepantry
        description: Delete a pantry
        call: pantry.deletepantry
        outputParameters:
        - type: object
          mapping: $.
    - path: /pantry/{pantryID}/basket/{basketName}
      name: createbasket
      operations:
      - method: POST
        name: createbasket
        description: Create a basket
        call: pantry.createbasket
        outputParameters:
        - type: object
          mapping: $.
    - path: /pantry/{pantryID}/basket/{basketName}
      name: updatebasket
      operations:
      - method: PUT
        name: updatebasket
        description: Update basket contents
        call: pantry.updatebasket
        outputParameters:
        - type: object
          mapping: $.
    - path: /pantry/{pantryID}/basket/{basketName}
      name: getbasket
      operations:
      - method: GET
        name: getbasket
        description: Get basket contents
        call: pantry.getbasket
        outputParameters:
        - type: object
          mapping: $.
    - path: /pantry/{pantryID}/basket/{basketName}
      name: deletebasket
      operations:
      - method: DELETE
        name: deletebasket
        description: Delete a basket
        call: pantry.deletebasket
        outputParameters:
        - type: object
          mapping: $.
    - path: /pantry/{pantryID}/basket/{basketName}/public
      name: createpublicbasket
      operations:
      - method: GET
        name: createpublicbasket
        description: Create a public basket link
        call: pantry.createpublicbasket
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: pantry-mcp
    transport: http
    description: MCP adapter for Pantry API for AI agent use.
    tools:
    - name: createpantry
      description: Create a new pantry
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pantry.createpantry
      outputParameters:
      - type: object
        mapping: $.
    - name: getpantry
      description: Get pantry details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pantry.getpantry
      outputParameters:
      - type: object
        mapping: $.
    - name: updatepantry
      description: Update pantry details
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: pantry.updatepantry
      outputParameters:
      - type: object
        mapping: $.
    - name: deletepantry
      description: Delete a pantry
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: pantry.deletepantry
      outputParameters:
      - type: object
        mapping: $.
    - name: createbasket
      description: Create a basket
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pantry.createbasket
      outputParameters:
      - type: object
        mapping: $.
    - name: updatebasket
      description: Update basket contents
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: pantry.updatebasket
      outputParameters:
      - type: object
        mapping: $.
    - name: getbasket
      description: Get basket contents
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pantry.getbasket
      outputParameters:
      - type: object
        mapping: $.
    - name: deletebasket
      description: Delete a basket
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: pantry.deletebasket
      outputParameters:
      - type: object
        mapping: $.
    - name: createpublicbasket
      description: Create a public basket link
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pantry.createpublicbasket
      outputParameters:
      - type: object
        mapping: $.