diff --git a/.claude/skills/generate-openapi-from-pr/SKILL.md b/.claude/skills/generate-openapi-from-pr/SKILL.md index e72d9190..f8af2eb4 100644 --- a/.claude/skills/generate-openapi-from-pr/SKILL.md +++ b/.claude/skills/generate-openapi-from-pr/SKILL.md @@ -88,7 +88,7 @@ Look for: #### 3d. Version Registration (`app/lib/api/versioning/service.rb`) Look for which version block the new change is added to: -- `UnstableVersion.new(changes: [...])` → goes in Unstable (version `0/`) +- `PreviewVersion.new(changes: [...])` → goes in Preview (version `0/`) - `Version.new(id: "2.15", changes: [...])` → goes in that specific version #### 3e. Routes (`config/routes/api_v3.rb`) @@ -113,11 +113,11 @@ I found the following API changes in PR #XXXXX: - [list of changes found] Which API versions should I update? -- Unstable only (default for new features) +- Preview only (default for new features) - Specific versions (for bug fixes/backports) ``` -Default to Unstable (`descriptions/0/api.intercom.io.yaml`) unless the PR clearly targets specific versions. +Default to Preview (`descriptions/0/api.intercom.io.yaml`) unless the PR clearly targets specific versions. ### Step 5: Read Target Spec File(s) @@ -194,9 +194,9 @@ Report to the user: Always remind the user of remaining manual steps: 1. **Review generated changes** for accuracy against the actual API behavior -2. **Fern overrides** — if new endpoints were added to Unstable, check if `fern/unstable-openapi-overrides.yml` needs SDK method name entries +2. **Fern overrides** — if new endpoints were added to Preview, check if `fern/preview-openapi-overrides.yml` needs SDK method name entries 3. **Developer-docs PR** — copy the updated spec to the `developer-docs` repo: - - Copy `descriptions/0/api.intercom.io.yaml` → `docs/references/@Unstable/rest-api/api.intercom.io.yaml` + - Copy `descriptions/0/api.intercom.io.yaml` → `docs/references/@Preview/rest-api/api.intercom.io.yaml` - For stable versions: `descriptions/2.15/api.intercom.io.yaml` → `docs/references/@2.15/rest-api/api.intercom.io.yaml` 4. **Changelog** — if the change should appear in the public changelog, update `docs/references/@/changelog.md` in the developer-docs repo (newest entries at top) 5. **Cross-version changes** — if this is an unversioned change (affects all versions), also update `docs/build-an-integration/learn-more/rest-apis/unversioned-changes.md` in developer-docs diff --git a/.claude/skills/generate-openapi-from-pr/ruby-to-openapi-mapping.md b/.claude/skills/generate-openapi-from-pr/ruby-to-openapi-mapping.md index 6f6252d2..e1201d0b 100644 --- a/.claude/skills/generate-openapi-from-pr/ruby-to-openapi-mapping.md +++ b/.claude/skills/generate-openapi-from-pr/ruby-to-openapi-mapping.md @@ -350,13 +350,13 @@ class TicketsController < OauthAuthenticatedController end ``` -This means: the entire endpoint only exists in versions that include `AddTicketsApi`. Add the endpoint to the Unstable spec (or whichever version includes the change). +This means: the entire endpoint only exists in versions that include `AddTicketsApi`. Add the endpoint to the Preview spec (or whichever version includes the change). ### Version Registration Location ```ruby # In app/lib/api/versioning/service.rb -UnstableVersion.new(changes: [ +PreviewVersion.new(changes: [ Changes::AddNewFeature, # → add to descriptions/0/ ]) diff --git a/.claude/skills/generate-openapi-from-pr/version-propagation.md b/.claude/skills/generate-openapi-from-pr/version-propagation.md index 7c206116..5cbab550 100644 --- a/.claude/skills/generate-openapi-from-pr/version-propagation.md +++ b/.claude/skills/generate-openapi-from-pr/version-propagation.md @@ -6,7 +6,7 @@ How to decide which API version spec files to update and how to propagate change | Version | Directory | Notes | |---|---|---| -| Unstable | `descriptions/0/` | All new features land here first | +| Preview | `descriptions/0/` | All new features land here first | | 2.15 | `descriptions/2.15/` | Current latest stable | | 2.14 | `descriptions/2.14/` | Stable SDK source (used by Fern) | | 2.13 | `descriptions/2.13/` | | @@ -23,9 +23,9 @@ Each version file is independent — always check the actual `intercom_version` ### 1. New Feature (most common) -**Update: Unstable only** (`descriptions/0/api.intercom.io.yaml`) +**Update: Preview only** (`descriptions/0/api.intercom.io.yaml`) -If the PR adds the version change to `UnstableVersion` in the versioning service, only update the Unstable spec. This is the case for ~95% of API changes. +If the PR adds the version change to `PreviewVersion` in the versioning service, only update the Preview spec. This is the case for ~95% of API changes. ### 2. Bug Fix to Existing Documentation @@ -35,11 +35,11 @@ If the PR fixes a bug in how an existing field/endpoint is documented (wrong typ ### 3. Feature Promoted to Stable Version -**Update: Target version + all later versions + Unstable** +**Update: Target version + all later versions + Preview** If the PR adds a version change to a specific numbered version (e.g., `Version.new(id: "2.15")`), update that version and all later versions. Features in a numbered version are also in all subsequent versions. -Example: Change added to 2.14 → update 2.14, 2.15, and Unstable. +Example: Change added to 2.14 → update 2.14, 2.15, and Preview. ### 4. Backport to Older Versions @@ -53,17 +53,17 @@ Rare. If the PR explicitly mentions backporting, update all specified versions. Each version's spec has a different enum for `intercom_version`: -**Unstable** includes all versions plus `Unstable`: +**Preview** includes all versions plus `Preview`: ```yaml intercom_version: - example: Unstable - default: Unstable + example: Preview + default: Preview enum: - '1.0' - '1.1' # ... all versions ... - '2.14' - - Unstable + - Preview ``` **Stable versions** include all versions up to and including themselves: @@ -85,9 +85,9 @@ Note: Stable specs set `default` to the previous stable version and do NOT inclu Each spec has a different `info.version`: ```yaml -# Unstable +# Preview info: - version: Unstable + version: Preview # v2.15 info: @@ -96,33 +96,33 @@ info: ### Available Endpoints -Unstable has endpoints that don't exist in stable versions. When adding an endpoint to Unstable, do NOT add it to stable versions unless the corresponding version change is registered in that version's change list. +Preview has endpoints that don't exist in stable versions. When adding an endpoint to Preview, do NOT add it to stable versions unless the corresponding version change is registered in that version's change list. ### Schema Differences -Some schemas have additional fields in Unstable that don't exist in stable versions. When propagating a fix, be careful not to add Unstable-only fields to stable versions. +Some schemas have additional fields in Preview that don't exist in stable versions. When propagating a fix, be careful not to add Preview-only fields to stable versions. ## Propagation Checklist When updating multiple versions: -1. **Start with Unstable** — make the change in `descriptions/0/api.intercom.io.yaml` +1. **Start with Preview** — make the change in `descriptions/0/api.intercom.io.yaml` 2. **Copy to each target version** — replicate the same change in each version file 3. **Verify consistency** — ensure the change makes sense in context of each version (don't add references to schemas that don't exist in older versions) 4. **Check intercom_version** — do NOT modify the `intercom_version` enum unless explicitly adding a new API version -5. **Run validation** — `fern check` validates the spec used by Fern (currently v2.14 + Unstable), but manually review other versions +5. **Run validation** — `fern check` validates the spec used by Fern (currently v2.14 + Preview), but manually review other versions ## Fern Validation Scope `fern check` only validates: - `descriptions/2.14/api.intercom.io.yaml` (stable SDK source) -- `descriptions/0/api.intercom.io.yaml` (unstable SDK source) +- `descriptions/0/api.intercom.io.yaml` (preview SDK source) Changes to other version files (2.7-2.13, 2.15) are NOT validated by Fern. Be extra careful with YAML syntax in those files. ## Fern Overrides -When adding new endpoints to Unstable, you may need to add entries to `fern/unstable-openapi-overrides.yml` for SDK method naming: +When adding new endpoints to Preview, you may need to add entries to `fern/preview-openapi-overrides.yml` for SDK method naming: ```yaml paths: diff --git a/.github/PULL_REQUEST_TEMPLATE/pull_request_template.md b/.github/PULL_REQUEST_TEMPLATE/pull_request_template.md index 861c0fca..13abd0b3 100644 --- a/.github/PULL_REQUEST_TEMPLATE/pull_request_template.md +++ b/.github/PULL_REQUEST_TEMPLATE/pull_request_template.md @@ -11,4 +11,4 @@ List all API versions that are affected by these changes. For example: - v2.0 - v2.13 -- Unstable +- Preview diff --git a/CLAUDE.md b/CLAUDE.md index d7f7ddfe..8280e497 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -9,11 +9,11 @@ Owner: `team-data-foundations` (see `REPO_OWNER`) ``` descriptions/ 2.7/ ... 2.15/ # Stable versioned API specs (one YAML each) - 0/ # Unstable version (version "0" internally) + 0/ # Preview version (version "0" internally) fern/ generators.yml # SDK generation config (TS, Java, Python, PHP) openapi-overrides.yml # Fern overrides for stable spec (v2.14) - unstable-openapi-overrides.yml # Fern overrides for Unstable + preview-openapi-overrides.yml # Fern overrides for Preview fern.config.json # Fern org config scripts/ run-sync.js # Entry point for spec upload (CI only) @@ -94,14 +94,14 @@ When a change applies to multiple API versions, you must edit each version's YAM ### Version Numbering - Stable versions: `2.7`, `2.8`, ..., `2.15` (current latest) -- Unstable: stored as `descriptions/0/` (mapped from "Unstable" in upload scripts) +- Preview: stored as `descriptions/0/` (mapped from "Preview" in upload scripts) - Every endpoint requires an `Intercom-Version` header parameter ## SDK Generation (Fern) SDKs are generated from the spec using [Fern](https://buildwithfern.com/). The `fern/generators.yml` configures: - **Stable SDK source**: `descriptions/2.14/api.intercom.io.yaml` (note: v2.14, not v2.15) -- **Unstable SDK source**: `descriptions/0/api.intercom.io.yaml` (namespace: `unstable`) +- **Preview SDK source**: `descriptions/0/api.intercom.io.yaml` (namespace: `preview`) ### DANGER: Never run `fern generate` without `--preview` locally diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 8786a0aa..fdc70f26 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -2,7 +2,7 @@ openapi: 3.0.1 info: title: Intercom API - version: Unstable + version: Preview description: The intercom API reference. contact: name: Intercom Developer Hub @@ -9907,7 +9907,7 @@ paths: in: header required: true schema: - $ref: '#/components/schemas/intercom_version_unstable' + $ref: '#/components/schemas/intercom_version_preview' requestBody: required: true content: @@ -9950,7 +9950,7 @@ paths: in: header required: true schema: - $ref: '#/components/schemas/intercom_version_unstable' + $ref: '#/components/schemas/intercom_version_preview' requestBody: required: true content: @@ -10002,7 +10002,7 @@ paths: in: header required: true schema: - $ref: '#/components/schemas/intercom_version_unstable' + $ref: '#/components/schemas/intercom_version_preview' requestBody: required: true content: @@ -10054,7 +10054,7 @@ paths: in: header required: true schema: - $ref: '#/components/schemas/intercom_version_unstable' + $ref: '#/components/schemas/intercom_version_preview' requestBody: required: true content: @@ -12078,8 +12078,8 @@ paths: This endpoint is designed for EU Data Act compliance, allowing customers to export their workflow configurations. - {% admonition type="warning" name="Unstable API" %} - This API is currently in the Unstable version. Its behavior may change in future releases. + {% admonition type="warning" name="Preview API" %} + This API is currently in the Preview version. Its behavior may change in future releases. {% /admonition %} responses: '200': @@ -12277,14 +12277,14 @@ paths: curl -X GET 'https://api.intercom.io/macros?per_page=25&starting_after=WzE3MTk0OTM3NTcuMCwgIjEyMyJd' \ -H 'Authorization: Bearer ' \ -H 'Accept: application/json' \ - -H 'Intercom-Version: @Unstable' + -H 'Intercom-Version: @Preview' - lang: 'Node.js' source: | const response = await fetch('https://api.intercom.io/macros?per_page=25&starting_after=WzE3MTk0OTM3NTcuMCwgIjEyMyJd', { headers: { 'Authorization': 'Bearer ', 'Accept': 'application/json', - 'Intercom-Version': '@Unstable' + 'Intercom-Version': '@Preview' } }); const macros = await response.json(); @@ -12295,7 +12295,7 @@ paths: headers = { 'Authorization': 'Bearer ', 'Accept': 'application/json', - 'Intercom-Version': '@Unstable' + 'Intercom-Version': '@Preview' } params = { @@ -12325,7 +12325,7 @@ paths: request = Net::HTTP::Get.new(uri) request['Authorization'] = 'Bearer ' request['Accept'] = 'application/json' - request['Intercom-Version'] = '@Unstable' + request['Intercom-Version'] = '@Preview' response = http.request(request) macros = JSON.parse(response.body) @@ -12550,14 +12550,14 @@ paths: curl -X GET 'https://api.intercom.io/macros/123' \ -H 'Authorization: Bearer ' \ -H 'Accept: application/json' \ - -H 'Intercom-Version: @Unstable' + -H 'Intercom-Version: @Preview' - lang: 'Node.js' source: | const response = await fetch('https://api.intercom.io/macros/123', { headers: { 'Authorization': 'Bearer ', 'Accept': 'application/json', - 'Intercom-Version': '@Unstable' + 'Intercom-Version': '@Preview' } }); const macro = await response.json(); @@ -12568,7 +12568,7 @@ paths: headers = { 'Authorization': 'Bearer ', 'Accept': 'application/json', - 'Intercom-Version': '@Unstable' + 'Intercom-Version': '@Preview' } response = requests.get('https://api.intercom.io/macros/123', @@ -12587,7 +12587,7 @@ paths: request = Net::HTTP::Get.new(uri) request['Authorization'] = 'Bearer ' request['Accept'] = 'application/json' - request['Intercom-Version'] = '@Unstable' + request['Intercom-Version'] = '@Preview' response = http.request(request) macro = JSON.parse(response.body) @@ -25379,8 +25379,8 @@ components: description: Intercom API version.
By default, it's equal to the version set in the app package. type: string - example: Unstable - default: Unstable + example: Preview + default: Preview enum: - '1.0' - '1.1' @@ -25402,7 +25402,7 @@ components: - '2.12' - '2.13' - '2.14' - - Unstable + - Preview linked_object: title: Linked Object type: object @@ -25429,13 +25429,13 @@ components: - example: Customer nullable: true - intercom_version_unstable: - description: Unstable Intercom API version. Used for closed beta endpoints or other features under managed availability. + intercom_version_preview: + description: Preview Intercom API version. Used for closed beta endpoints or other features under managed availability. type: string - example: unstable - default: unstable + example: preview + default: preview enum: - - unstable + - preview linked_object_list: title: Linked Objects type: object diff --git a/descriptions/2.11/api.intercom.io.yaml b/descriptions/2.11/api.intercom.io.yaml index 24615ab0..6acc1f63 100644 --- a/descriptions/2.11/api.intercom.io.yaml +++ b/descriptions/2.11/api.intercom.io.yaml @@ -16271,7 +16271,7 @@ components: - '2.9' - '2.10' - '2.11' - - Unstable + - Preview linked_object: title: Linked Object type: object diff --git a/fern/generators.yml b/fern/generators.yml index 5a409ee4..a2090210 100644 --- a/fern/generators.yml +++ b/fern/generators.yml @@ -14,8 +14,8 @@ api: coerce-optional-schemas-to-nullable: true coerce-enums-to-literals: true - openapi: ../descriptions/0/api.intercom.io.yaml - overrides: ./unstable-openapi-overrides.yml - namespace: unstable + overrides: ./preview-openapi-overrides.yml + namespace: preview settings: title-as-schema-name: false inline-path-parameters: true diff --git a/fern/openapi-overrides.yml b/fern/openapi-overrides.yml index 6ef6fa8f..3eb941ce 100644 --- a/fern/openapi-overrides.yml +++ b/fern/openapi-overrides.yml @@ -2369,7 +2369,7 @@ x-fern-version: - "2.12" - "2.13" - "2.14" - - "Unstable" + - "Preview" servers: - url: https://api.intercom.io/ diff --git a/fern/unstable-openapi-overrides.yml b/fern/preview-openapi-overrides.yml similarity index 94% rename from fern/unstable-openapi-overrides.yml rename to fern/preview-openapi-overrides.yml index 4c6355a0..8c41ed33 100644 --- a/fern/unstable-openapi-overrides.yml +++ b/fern/preview-openapi-overrides.yml @@ -96,7 +96,7 @@ paths: in: header required: null schema: - $ref: '#/components/schemas/intercom_version_unstable' + $ref: '#/components/schemas/intercom_version_preview' '/custom_channel_events/notify_new_message': post: x-fern-sdk-group-name: @@ -108,7 +108,7 @@ paths: in: header required: null schema: - $ref: '#/components/schemas/intercom_version_unstable' + $ref: '#/components/schemas/intercom_version_preview' '/custom_channel_events/notify_new_conversation': post: x-fern-sdk-group-name: @@ -120,7 +120,7 @@ paths: in: header required: null schema: - $ref: '#/components/schemas/intercom_version_unstable' + $ref: '#/components/schemas/intercom_version_preview' '/custom_channel_events/notify_quick_reply_selected': post: x-fern-sdk-group-name: @@ -132,13 +132,13 @@ paths: in: header required: null schema: - $ref: '#/components/schemas/intercom_version_unstable' + $ref: '#/components/schemas/intercom_version_preview' components: schemas: intercom_version: x-fern-ignore: true - intercom_version_unstable: + intercom_version_preview: x-fern-ignore: true create_data_attribute_request: x-fern-type-name: CreateDataAttributeRequest diff --git a/postman/Unstable/README.md b/postman/Preview/README.md similarity index 86% rename from postman/Unstable/README.md rename to postman/Preview/README.md index a1bfa9ca..b843c533 100644 --- a/postman/Unstable/README.md +++ b/postman/Preview/README.md @@ -1,6 +1,6 @@ -# Intercom API Unstable Postman Collection +# Intercom API Preview Postman Collection -This directory contains the Postman collection for Intercom API version Unstable. +This directory contains the Postman collection for Intercom API version Preview. ## Files - `intercom-api.postman_collection.json`: The main Postman collection diff --git a/postman/Unstable/environment.json b/postman/Preview/environment.json similarity index 100% rename from postman/Unstable/environment.json rename to postman/Preview/environment.json diff --git a/postman/Unstable/intercom-api.postman_collection.json b/postman/Preview/intercom-api.postman_collection.json similarity index 98% rename from postman/Unstable/intercom-api.postman_collection.json rename to postman/Preview/intercom-api.postman_collection.json index 7cb04ee1..69dec356 100644 --- a/postman/Unstable/intercom-api.postman_collection.json +++ b/postman/Preview/intercom-api.postman_collection.json @@ -1,6 +1,6 @@ { "info": { - "name": "Intercom API - Unstable", + "name": "Intercom API - Preview", "description": "The intercom API reference.", "version": "0", "contact": { @@ -58,7 +58,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -113,7 +113,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -168,7 +168,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -224,7 +224,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -279,7 +279,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -343,7 +343,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -408,7 +408,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -473,7 +473,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -538,7 +538,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -594,7 +594,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -653,7 +653,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -719,7 +719,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -773,7 +773,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -835,7 +835,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -898,7 +898,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -966,7 +966,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -1028,7 +1028,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -1104,7 +1104,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -1158,7 +1158,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -1229,7 +1229,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -1300,7 +1300,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -1359,7 +1359,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -1418,7 +1418,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -1480,7 +1480,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -1570,7 +1570,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -1632,7 +1632,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -1696,7 +1696,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -1759,7 +1759,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -1820,7 +1820,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -1874,7 +1874,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -1954,7 +1954,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -2018,7 +2018,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -2089,7 +2089,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -2151,7 +2151,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -2222,7 +2222,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -2291,7 +2291,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -2355,7 +2355,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -2419,7 +2419,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -2483,7 +2483,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -2545,7 +2545,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -2599,7 +2599,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -2662,7 +2662,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -2717,7 +2717,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -2781,7 +2781,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -2844,7 +2844,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -2916,7 +2916,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -2979,7 +2979,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -3042,7 +3042,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -3105,7 +3105,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -3176,7 +3176,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -3246,7 +3246,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -3319,7 +3319,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -3373,7 +3373,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -3437,7 +3437,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -3509,7 +3509,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -3581,7 +3581,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -3653,7 +3653,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -3717,7 +3717,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -3789,7 +3789,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -3867,7 +3867,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -3938,7 +3938,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -4008,7 +4008,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -4077,7 +4077,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -4141,7 +4141,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -4205,7 +4205,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -4269,7 +4269,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -4343,7 +4343,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -4406,7 +4406,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -4461,7 +4461,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -4530,7 +4530,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -4593,7 +4593,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -4663,7 +4663,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -4717,7 +4717,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -4788,7 +4788,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -4871,7 +4871,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -4925,7 +4925,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -4989,7 +4989,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -5067,7 +5067,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -5131,7 +5131,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -5187,7 +5187,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -5259,7 +5259,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -5318,7 +5318,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -5380,7 +5380,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -5440,7 +5440,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -5503,7 +5503,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -5566,7 +5566,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -5621,7 +5621,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -5676,7 +5676,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -5748,7 +5748,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -5820,7 +5820,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -5879,7 +5879,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -5941,7 +5941,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -6002,7 +6002,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -6056,7 +6056,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -6127,7 +6127,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -6198,7 +6198,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -6266,7 +6266,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -6341,7 +6341,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -6403,7 +6403,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -6480,7 +6480,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -6534,7 +6534,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -6603,7 +6603,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -6666,7 +6666,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -6730,7 +6730,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -6785,7 +6785,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -6848,7 +6848,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -6903,7 +6903,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -6974,7 +6974,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -7046,7 +7046,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -7115,7 +7115,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -7177,7 +7177,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -7241,7 +7241,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -7315,7 +7315,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -7377,7 +7377,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -7436,7 +7436,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -7500,7 +7500,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -7580,7 +7580,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -7639,7 +7639,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -7707,7 +7707,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -7769,7 +7769,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -7833,7 +7833,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -7906,7 +7906,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -7969,7 +7969,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -8042,7 +8042,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -8122,7 +8122,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -8193,7 +8193,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -8264,7 +8264,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -8335,7 +8335,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -8403,7 +8403,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -8465,7 +8465,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -8524,7 +8524,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -8592,7 +8592,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -8671,7 +8671,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -8739,7 +8739,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -8801,7 +8801,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -8855,7 +8855,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -8926,7 +8926,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -9002,7 +9002,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -9064,7 +9064,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -9127,7 +9127,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -9191,7 +9191,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -9255,7 +9255,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -9326,7 +9326,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -9397,7 +9397,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -9462,7 +9462,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -9517,7 +9517,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -9580,7 +9580,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -9664,7 +9664,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -9719,7 +9719,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -9783,7 +9783,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -9838,7 +9838,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", @@ -9917,7 +9917,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -9979,7 +9979,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -10042,7 +10042,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -10105,7 +10105,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Accept", @@ -10160,7 +10160,7 @@ "header": [ { "key": "Intercom-Version", - "value": "Unstable" + "value": "Preview" }, { "key": "Content-Type", diff --git a/scripts/postman/create-collection-from-yaml.js b/scripts/postman/create-collection-from-yaml.js index 659a45bb..8d3702d6 100644 --- a/scripts/postman/create-collection-from-yaml.js +++ b/scripts/postman/create-collection-from-yaml.js @@ -7,8 +7,8 @@ module.exports = async function createCollectionFromYaml(filePath) { const pathParts = filePath.split('/'); const versionNumber = pathParts[pathParts.length - 2]; - // version 0 means the Unstable version - const folderName = versionNumber === '0' ? 'Unstable' : versionNumber; + // version 0 means the Preview version + const folderName = versionNumber === '0' ? 'Preview' : versionNumber; const versionFolder = `postman/${folderName}`; if (!fs.existsSync('postman')) { diff --git a/scripts/upload-api-specification.js b/scripts/upload-api-specification.js index a1218139..f555a38e 100644 --- a/scripts/upload-api-specification.js +++ b/scripts/upload-api-specification.js @@ -22,8 +22,8 @@ module.exports = async function uploadAPISpecification(filePath) { deleteFile = true; } [versionNumber] = filePath.split('descriptions/')[1].split('/'); - if (versionNumber == 'Unstable') { - // If the version is unstable, set it to 0 + if (versionNumber == 'Preview') { + // If the version is preview, set it to 0 versionNumber = '0'; } } catch (err) {