Document audience targeting fields on Content Import Sources (Preview) (#464)

* Add audience targeting fields to Content Import Source Preview spec

Add audience_id and apply_audience_to_existing_content fields to the
Preview OpenAPI spec (descriptions/0/) for Content Import Sources, per
intercom/intercom#497303.

Changes:
- content_import_source response schema: add audience_id (nullable integer)
- create_content_import_source_request: add optional audience_id
- update_content_import_source_request: add optional audience_id and
  apply_audience_to_existing_content (boolean, default false)
- All inline response examples updated with audience_id: null

* Fix audience targeting fields: audience_id -> audience_ids (array)

Update Preview spec to match updated PR intercom/intercom#497303:
- Rename audience_id to audience_ids throughout
- Response schema: type is now array of integers (always returns [])
- Request schemas: accept single integer or array via oneOf (nullable)
- All inline examples updated to audience_ids: []

Author: ib-skoric

descriptions/0/api.intercom.io.yaml

@@ -642,6 +642,7 @@ paths:
                       sync_behavior: automatic
                       created_at: 1734537259
                       updated_at: 1734537259
+                      audience_ids: []
                     - id: 34
                       type: content_import_source
                       last_synced_at: 1734537259
@@ -650,6 +651,7 @@ paths:
                       sync_behavior: automatic
                       created_at: 1734537259
                       updated_at: 1734537259
+                      audience_ids: []
                     - id: 35
                       type: content_import_source
                       last_synced_at: 1734537259
@@ -658,6 +660,7 @@ paths:
                       sync_behavior: automatic
                       created_at: 1734537259
                       updated_at: 1734537259
+                      audience_ids: []
                     pages:
                       type: pages
                       page: 1
@@ -709,6 +712,7 @@ paths:
                     sync_behavior: api
                     created_at: 1734537261
                     updated_at: 1734537261
+                    audience_ids: []
               schema:
                 "$ref": "#/components/schemas/content_import_source"
         '401':
@@ -801,6 +805,7 @@ paths:
                     sync_behavior: api
                     created_at: 1734537265
                     updated_at: 1734537265
+                    audience_ids: []
               schema:
                 "$ref": "#/components/schemas/content_import_source"
         '401':
@@ -844,6 +849,7 @@ paths:
                     sync_behavior: api
                     created_at: 1734537267
                     updated_at: 1734537267
+                    audience_ids: []
               schema:
                 "$ref": "#/components/schemas/content_import_source"
         '401':
@@ -20952,6 +20958,13 @@ components:
           format: date-time
           description: The time when the content import source was last updated.
           example: 1672928610
+        audience_ids:
+          type: array
+          items:
+            type: integer
+          description: The unique identifiers for the audiences associated with this content import source.
+          example:
+          - 5678
       required:
       - id
       - type
@@ -22275,6 +22288,16 @@ components:
           type: string
           description: The URL of the content import source.
           example: https://help.example.com
+        audience_ids:
+          nullable: true
+          description: The unique identifiers for the audiences to associate with this content import source. Can be a single integer or an array of integers.
+          example:
+          - 5678
+          oneOf:
+          - type: integer
+          - type: array
+            items:
+              type: integer
       required:
       - sync_behavior
       - url
@@ -28380,6 +28403,21 @@ components:
           description: The URL of the content import source. This may only be different
             from the existing value if the sync behavior is API.
           example: https://help.example.com
+        audience_ids:
+          nullable: true
+          description: The unique identifiers for the audiences to associate with this content import source. Can be a single integer or an array of integers. Set to null or an empty array to remove all audiences.
+          example:
+          - 5678
+          oneOf:
+          - type: integer
+          - type: array
+            items:
+              type: integer
+        apply_audience_to_existing_content:
+          type: boolean
+          description: When true, the audience will be applied to all existing external pages belonging to this content import source.
+          default: false
+          example: false
       required:
       - sync_behavior
       - url