# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for CRM Association Service API
  version: 1.0.0
extends: openapi/vendasta-crmassociationservice-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: 6
- target: $.paths['/v1/crm/association/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Link two CRM records
      effect: write
      questions:
      - How do I link a contact to a company in the CRM?
      - Can I create a relationship between two CRM objects?
      instructions:
      - text: Create association {association} in {namespace}.
        slots:
          association: requestBody.association
          namespace: requestBody.namespace
      - text: 'Link these CRM records together in {namespace}: {association}.'
        slots:
          namespace: requestBody.namespace
          association: requestBody.association
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/association/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a link between CRM records
      effect: destructive
      questions:
      - Can I unlink two CRM records without deleting either of them?
      - What do I need to delete a CRM association?
      instructions:
      - text: Delete association {association} in {namespace}.
        slots:
          association: requestBody.associationId
          namespace: requestBody.namespace
      - text: Unlink the records joined by association {association}.
        slots:
          association: requestBody.associationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/association/field-options'].post
  update:
    x-apievangelist-phrasing:
      intent: List options for an association field
      effect: read
      questions:
      - What values can a field on a CRM association take?
      - Can I search the options of one field for a given association type?
      instructions:
      - text: List options for field {field} on association type {type} in {namespace}.
        slots:
          field: requestBody.fieldId
          type: requestBody.associationType
          namespace: requestBody.namespace
      - text: Search association type {type} field {field} options for {term}.
        slots:
          type: requestBody.associationType
          field: requestBody.fieldId
          term: requestBody.searchTerm
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/association/get-multi'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch several associations by ID
      effect: read
      questions:
      - Can I look up a batch of CRM associations when I have their IDs?
      - What details come back for specific record links?
      instructions:
      - text: Get associations {ids} from {namespace}.
        slots:
          ids: requestBody.associationIds
          namespace: requestBody.namespace
      - text: Fetch the record links with IDs {ids}.
        slots:
          ids: requestBody.associationIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/association/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List associations between CRM records
      effect: read
      questions:
      - Which CRM records are linked to each other in my account?
      - Can I filter the list of associations and page through it?
      instructions:
      - text: List all associations in {namespace}.
        slots:
          namespace: requestBody.namespace
      - text: List associations in {namespace} filtered by {filters}.
        slots:
          namespace: requestBody.namespace
          filters: requestBody.filtersV2
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/crm/association/update'].post
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a CRM association
      effect: write
      questions:
      - Can I tag an existing link between two CRM records?
      - Is it possible to change an association after creating it?
      instructions:
      - text: Set tags {tags} on association {association} in {namespace}.
        slots:
          tags: requestBody.tags
          association: requestBody.associationId
          namespace: requestBody.namespace
      - text: Update association {association} in {namespace}.
        slots:
          association: requestBody.associationId
          namespace: requestBody.namespace
      method: generated
      generated: '2026-10-01'