# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for CRM Associations Schema Labels API
  version: 1.0.0
extends: openapi/hubspot-labels-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/crm/associations/2026-09/{fromObjectType}/{toObjectType}/labels'].get
  update:
    x-apievangelist-phrasing:
      intent: List association labels between two object types
      effect: read
      questions:
      - What association labels exist between contacts and companies in my CRM?
      - Can I see every label that describes how two CRM object types relate?
      instructions:
      - text: List the association labels from {fromObjectType} to {toObjectType}.
        slots:
          fromObjectType: path.fromObjectType
          toObjectType: path.toObjectType
      - text: Show how {fromObjectType} records can be labeled when associated with {toObjectType}.
        slots:
          fromObjectType: path.fromObjectType
          toObjectType: path.toObjectType
      method: generated
      generated: '2026-09-24'
- target: $.paths['/crm/associations/2026-09/{fromObjectType}/{toObjectType}/labels'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename an existing association label
      effect: write
      questions:
      - How do I change the wording of an association label I already created?
      - Can I edit the inverse label on an existing association type?
      instructions:
      - text: Rename association type {associationTypeId} between {fromObjectType} and {toObjectType} to {label}.
        slots:
          associationTypeId: requestBody.associationTypeId
          fromObjectType: path.fromObjectType
          toObjectType: path.toObjectType
          label: requestBody.label
      - text: Change the inverse label of existing association type {associationTypeId} from {fromObjectType} to {toObjectType} to {inverseLabel}.
        slots:
          inverseLabel: requestBody.inverseLabel
          associationTypeId: requestBody.associationTypeId
          fromObjectType: path.fromObjectType
          toObjectType: path.toObjectType
      method: generated
      generated: '2026-09-24'
- target: $.paths['/crm/associations/2026-09/{fromObjectType}/{toObjectType}/labels'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new association label
      effect: write
      questions:
      - Can I define a custom relationship label, like Manager, between two CRM object types?
      - Is it possible to give a new association label a different name for the reverse direction?
      instructions:
      - text: Create a new association label {label} named {name} from {fromObjectType} to {toObjectType}.
        slots:
          label: requestBody.label
          name: requestBody.name
          fromObjectType: path.fromObjectType
          toObjectType: path.toObjectType
      - text: Add a {label} relationship from {fromObjectType} to {toObjectType} called {name}, with inverse {inverseLabel}.
        slots:
          label: requestBody.label
          fromObjectType: path.fromObjectType
          toObjectType: path.toObjectType
          name: requestBody.name
          inverseLabel: requestBody.inverseLabel
      method: generated
      generated: '2026-09-24'
- target: $.paths['/crm/associations/2026-09/{fromObjectType}/{toObjectType}/labels/{associationTypeId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an association label
      effect: destructive
      questions:
      - How do I remove an association label I no longer use?
      - Can I delete one specific label between two object types by its association type ID?
      instructions:
      - text: Delete association label {associationTypeId} between {fromObjectType} and {toObjectType}.
        slots:
          associationTypeId: path.associationTypeId
          fromObjectType: path.fromObjectType
          toObjectType: path.toObjectType
      - text: Remove the {associationTypeId} label from {fromObjectType} to {toObjectType} associations.
        slots:
          associationTypeId: path.associationTypeId
          fromObjectType: path.fromObjectType
          toObjectType: path.toObjectType
      method: generated
      generated: '2026-09-24'