# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for CRM Field Schema Customization Service API
  version: 1.0.0
extends: openapi/vendasta-crmfieldschemacustomizationservice-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/v1/crm/field-schema-customization/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Customize a CRM field's schema
      effect: write
      questions:
      - Can I customize how a standard CRM field behaves for contacts or companies?
      - What does a field schema customization need when creating one?
      instructions:
      - text: Create field customization {custom} for {type} objects in namespace {namespace}.
        slots:
          custom: requestBody.fieldSchemaCustomization
          type: requestBody.crmObjectType
          namespace: requestBody.namespace
      - text: Add a new schema customization {custom} on {type} fields in {namespace}.
        slots:
          custom: requestBody.fieldSchemaCustomization
          type: requestBody.crmObjectType
          namespace: requestBody.namespace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/field-schema-customization/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a CRM field customization
      effect: destructive
      questions:
      - How do I revert a CRM field back to its default schema?
      - Can a field schema customization be deleted?
      instructions:
      - text: Delete the customization on field {field} of {type} in namespace {namespace}.
        slots:
          field: requestBody.fieldId
          type: requestBody.crmObjectType
          namespace: requestBody.namespace
      - text: Remove my schema changes to {type} field {field} in {namespace}.
        slots:
          type: requestBody.crmObjectType
          field: requestBody.fieldId
          namespace: requestBody.namespace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/field-schema-customization/get-multi'].post
  update:
    x-apievangelist-phrasing:
      intent: Get customizations for specific CRM fields
      effect: read
      questions:
      - What customizations are applied to particular CRM fields?
      - Can I look up a field's schema customization by field ID?
      instructions:
      - text: Get the customization for {type} field {field} in namespace {namespace}.
        slots:
          type: requestBody.crmObjectType
          field: requestBody.fieldId
          namespace: requestBody.namespace
      - text: Show how field {field} on {type} is customized in {namespace}.
        slots:
          field: requestBody.fieldId
          type: requestBody.crmObjectType
          namespace: requestBody.namespace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/field-schema-customization/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List CRM field schema customizations
      effect: read
      questions:
      - Which CRM fields have been customized in this namespace?
      - Can I list field customizations for just one object type?
      instructions:
      - text: List all field schema customizations in namespace {namespace}.
        slots:
          namespace: requestBody.namespace
      - text: Show every customized {type} field in {namespace}.
        slots:
          type: requestBody.crmObjectType
          namespace: requestBody.namespace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/field-schema-customization/update'].post
  update:
    x-apievangelist-phrasing:
      intent: Change an existing CRM field customization
      effect: write
      questions:
      - Can I edit a field customization I already made?
      - Is it possible to update only part of a field schema customization?
      instructions:
      - text: Update the {type} field customization in {namespace} to {custom}.
        slots:
          type: requestBody.crmObjectType
          namespace: requestBody.namespace
          custom: requestBody.fieldSchemaCustomization
      - text: Change only {mask} of the {type} customization {custom} in {namespace}.
        slots:
          mask: requestBody.fieldMask
          type: requestBody.crmObjectType
          custom: requestBody.fieldSchemaCustomization
          namespace: requestBody.namespace
      method: generated
      generated: '2026-10-01'