# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Agent Handler Subpackage Tool Description Overrides API
  version: 1.0.0
extends: openapi/merge-subpackage-tooldescriptionoverrides-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['/api/v1/connectors/tool-description-overrides/'].get
  update:
    x-apievangelist-phrasing:
      intent: List organization tool description overrides
      effect: read
      questions:
      - Which connector tool descriptions have we customized across the organization?
      - Can I see only the description overrides for one connector?
      instructions:
      - text: List org tool description overrides for connector {slug}.
        slots:
          slug: query.slug
      - text: Show all organization-level tool description overrides.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/connectors/tool-description-overrides/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Bulk set or remove org tool descriptions
      effect: write
      questions:
      - Can I rewrite the descriptions agents see for several connector tools in one call?
      - How do I clear an organization-level tool description override?
      instructions:
      - text: Bulk update organization tool description overrides.
      - text: Delete org-level description overrides by sending null descriptions.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/tool-packs/{tool_pack_id}/tool-description-overrides/'].get
  update:
    x-apievangelist-phrasing:
      intent: List a tool pack's tool description overrides
      effect: read
      questions:
      - Which tool descriptions are overridden inside one specific tool pack?
      - Can I filter a tool pack's overrides by connector?
      instructions:
      - text: List tool description overrides in tool pack {tool_pack_id}.
        slots:
          tool_pack_id: path.tool_pack_id
      - text: Show tool pack {tool_pack_id} overrides for connector {slug}.
        slots:
          tool_pack_id: path.tool_pack_id
          slug: query.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/tool-packs/{tool_pack_id}/tool-description-overrides/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Bulk set or remove a tool pack's tool descriptions
      effect: write
      questions:
      - Can I customize tool descriptions for just one tool pack instead of the whole org?
      - Is removing a tool-pack-level override done with a null description?
      instructions:
      - text: Bulk upsert tool description overrides in tool pack {tool_pack_id}.
        slots:
          tool_pack_id: path.tool_pack_id
      - text: Clear description overrides from tool pack {tool_pack_id}.
        slots:
          tool_pack_id: path.tool_pack_id
      method: generated
      generated: '2026-09-26'