# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Relevance AI Endpoints Mas Store API
  version: 1.0.0
extends: openapi/relevance-ai-mas-store-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/mas-store/items/{document_id}/get'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one multi-agent system store item
      effect: read
      questions:
      - Can I read a single item from the multi-agent system store?
      - Which fields can I pick when fetching a MAS store document?
      instructions:
      - text: Get MAS store item {document_id}.
        slots:
          document_id: path.document_id
      - text: Return only {select_fields} of MAS store item {document_id}.
        slots:
          select_fields: query.select_fields
          document_id: path.document_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mas-store/items/{document_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a multi-agent system store item
      effect: destructive
      questions:
      - How do I delete an item from the MAS store?
      - Is removing a MAS store document irreversible?
      instructions:
      - text: Delete MAS store item {document_id}.
        slots:
          document_id: path.document_id
      - text: Remove document {document_id} from the multi-agent system store.
        slots:
          document_id: path.document_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mas-store/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List multi-agent system store items
      effect: read
      questions:
      - What items are saved in my multi-agent system store?
      - Can I filter the MAS store listing and page with an after_id cursor?
      instructions:
      - text: List the items in the MAS store.
      - text: Show MAS store items matching {filters}.
        slots:
          filters: requestBody.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mas-store/items/{document_id}/upsert'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update a MAS store item
      effect: write
      questions:
      - Can I save data into the MAS store and have it created if it doesn't exist?
      - How do I increment a counter field on a MAS store document?
      instructions:
      - text: Upsert MAS store item {document_id} with {data}.
        slots:
          document_id: path.document_id
          data: requestBody.data
      - text: Increment {fields_to_increment} on MAS store item {document_id}.
        slots:
          fields_to_increment: requestBody.fields_to_increment
          document_id: path.document_id
      method: generated
      generated: '2026-09-26'