voucherifyio · p-zielinski · Jul 20, 2023 · Jul 20, 2023 · Jul 20, 2023 · Jul 20, 2023
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1 @@
+.idea/*
diff --git a/Changelog.md b/Changelog.md
@@ -1,5 +1,29 @@
 # Changelog
 
+## 20230828
+
+**Added schemas**
+- CategoryObject
+- CreateCategory
+- ResponseCreateCategory
+- UpdateCategoryRequest
+- ResponseUpdateCategory
+- ListCategories
+
+**Endpoints changes**
+- `/v1/categories`
+  - GET
+    - Response schema was replaced with `ListCategories` (old 20_res_list_categories)
+  - POST
+    - Request parameters schema was replaced with `CreateCategory` (old 20_req_create_category)
+    - Response schema was replaced with `ResponseCreateCategory` (old 20_res_create_category)
+- `/v1/categories/{categoryId}`
+  - GET
+    - Response schema was replaced with `CategoryObject` (old 20_obj_category_object)
+  - PUT
+    - Request parameters schema was replaced with `UpdateCategoryRequest` (old 20_req_update_categories_categoryId)
+    - Response schema was replaced with `ResponseUpdateCategory` (old 20_obj_category_object)
+
 ## 20230823 - New Endpoints
 
 ### Introduced new endpoints and related object schemas
@@ -327,4 +351,4 @@ The following endpoints in the OpenAPI document found in the `paths` object are
 `/v1/category-object`
 `/v1/metadata-schema-object`
 `/v1/location-object`
-`/v1/qualification-object`
+`/v1/qualification-object`
diff --git a/automation/Update-Order-Standard-Work.md b/automation/Update-Order-Standard-Work.md
@@ -6,7 +6,7 @@ The following sequence of actions should be taken to successfully update the Dev
 
 > 📘 Important
 >
-> If you create a new version of documentation in readme, such as by copying an existing version and renaming the version name, readme.io will create new page IDs and new category IDs. This means that some pre-work is needed for a new version of the documentation. 
+> If you create a new version of documentation in readme, such as by copying an existing version and renaming the version name, readme.io will create new page IDs and new category IDs. This means that some pre-work is needed for a new version of the documentation.
 
 ### Pre-work 
 

diff --git a/docs/guides/building_blocks/Campaigns.md b/docs/guides/building_blocks/Campaigns.md
@@ -1,7 +1,7 @@
 ---
 title: Campaigns
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: campaigns
 type: basic
 hidden: false
@@ -34,4 +34,4 @@ Usually, voucher campaigns are created in the dashboard by marketers. But someti
 
 ## Promotion tier-based campaigns utils
 
-When it comes to auto-applied promotion discounts, you can use campaigns to [stack](ref:add-promotion-tier-to-campaign) multiple tiers together.
+When it comes to auto-applied promotion discounts, you can use campaigns to [stack](ref:add-promotion-tier-to-campaign) multiple tiers together.
diff --git a/docs/guides/building_blocks/Customer.md b/docs/guides/building_blocks/Customer.md
@@ -1,7 +1,7 @@
 ---
 title: Customers
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: customers
 type: basic
 hidden: false

diff --git a/docs/guides/building_blocks/Distribution.md b/docs/guides/building_blocks/Distribution.md
@@ -1,7 +1,7 @@
 ---
 title: Distribution
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: distribution
 type: basic
 hidden: false
@@ -212,4 +212,4 @@ GET /v1/publications?filters[customer_id][conditions][$in][0]=cust_lUET6gRpO5Wxl
 ```
 ```markdown or another using the junction operator
 GET /v1/publications?filters[customer_id][conditions][$is][0]=cust_lUET6gRpO5Wxlg5p2j2gRCgL&filters[customer_id][conditions][$is][1]=cust_aR7NfHusxT7PdTMAKMfWDXnc&filters[junction]=OR
-```
+```
diff --git a/docs/guides/building_blocks/Earning-Rules.md b/docs/guides/building_blocks/Earning-Rules.md
@@ -1,7 +1,7 @@
 ---
 title: Earning Rules
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: earning-rules
 type: basic
 hidden: false

diff --git a/docs/guides/building_blocks/Formula-Builder.md b/docs/guides/building_blocks/Formula-Builder.md
@@ -1,7 +1,7 @@
 ---
 title: Formula Builder
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: formula-builder
 type: basic
 hidden: false

diff --git a/docs/guides/building_blocks/Metadata-Custom-Fields.md b/docs/guides/building_blocks/Metadata-Custom-Fields.md
@@ -1,7 +1,7 @@
 ---
 title: Metadata (custom fields)
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: metadata-custom-fields
 type: basic
 hidden: false

diff --git a/docs/guides/building_blocks/Orders.md b/docs/guides/building_blocks/Orders.md
@@ -1,7 +1,7 @@
 ---
 title: Orders
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: orders
 type: basic
 hidden: false
@@ -56,4 +56,4 @@ Read more about [Stacking discounts](doc:manage-stackable-discounts).
 
 ## Order session
 
-Each time you use particular order in your requests, the API automatically triggers a new session linked to the order id. The session is active during the request and ends asynchronously after the request is completed. The session mechanism provides that the particular order id can be used in one API request at once.
+Each time you use particular order in your requests, the API automatically triggers a new session linked to the order id. The session is active during the request and ends asynchronously after the request is completed. The session mechanism provides that the particular order id can be used in one API request at once.
diff --git a/docs/guides/building_blocks/Products.md b/docs/guides/building_blocks/Products.md
@@ -1,7 +1,7 @@
 ---
 title: Products
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: products
 type: basic
 hidden: false
@@ -242,4 +242,4 @@ Product collections can be managed using your dashboard or dedicated [product co
 > 📘 Useful links
 > 
 > - Learn how to [create Product Collections](https://support.voucherify.io/article/515-products) in your dashboard
-> - Learn more about [Product Collections API](ref:list-products-in-collection)
+> - Learn more about [Product Collections API](ref:list-products-in-collection)
diff --git a/docs/guides/building_blocks/Promotion-Tier.md b/docs/guides/building_blocks/Promotion-Tier.md
@@ -1,7 +1,7 @@
 ---
 title: Promotion Tier
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: promotion-tier
 type: basic
 hidden: false

diff --git a/docs/guides/building_blocks/Redemption.md b/docs/guides/building_blocks/Redemption.md
@@ -1,7 +1,7 @@
 ---
 title: Redemption
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: redemption
 type: basic
 hidden: false
@@ -55,4 +55,4 @@ If you want to reverse this operation, use [rollback](ref:rollback-redemption).
 
 ## Webhooks
 
-Every redemption, successful or failed, generates an event you can listen to (`redemption succeeded`, `redemption failed`, `redemption rollback succeeded`, `redemption rollback failed`). Go to [webhooks](https://docs.voucherify.io/docs/webhooks) to learn more.
+Every redemption, successful or failed, generates an event you can listen to (`redemption succeeded`, `redemption failed`, `redemption rollback succeeded`, `redemption rollback failed`). Go to [webhooks](https://docs.voucherify.io/docs/webhooks) to learn more.
diff --git a/docs/guides/building_blocks/Rewards.md b/docs/guides/building_blocks/Rewards.md
@@ -1,7 +1,7 @@
 ---
 title: Rewards
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: rewards
 type: basic
 hidden: false
@@ -80,4 +80,4 @@ curl -X POST \
 
 Reward and Reward Assignment objects allow for rewarding customers who already collected points in your loyalty program. If you want to learn how to enable your customers to earn points in the first place, follow [here](doc:earning-rules).
 
-If you already have both earning rules and rewards ready, you can create a [loyalty program](doc:loyalty-program).
+If you already have both earning rules and rewards ready, you can create a [loyalty program](doc:loyalty-program).
diff --git a/docs/guides/building_blocks/Validation-Rules.md b/docs/guides/building_blocks/Validation-Rules.md
@@ -1,7 +1,7 @@
 ---
 title: Validation Rules
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: validation-rules
 type: basic
 hidden: false
@@ -447,4 +447,4 @@ or:
         "sales_channel": "page_1"
     }
 }
-```
+```
diff --git a/docs/guides/building_blocks/Vouchers.md b/docs/guides/building_blocks/Vouchers.md
@@ -1,7 +1,7 @@
 ---
 title: Vouchers
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: vouchers
 type: basic
 hidden: false
@@ -238,4 +238,4 @@ You can recharge cards you've sent out to your customers. With our API, you can
 
 Vouchers (along with redemptions, publications, and customers) can be downloaded asynchronously with the export mechanism, see the [API reference](ref:create-export).
 
-Voucher attributes you can export: `code`, `voucher_type`, `value`, `discount_type`, `campaign`, `category`, `start_date`, `expiration_date`, `gift_balance`, `redemption_quantity`, `active`, `qr_code`.
+Voucher attributes you can export: `code`, `voucher_type`, `value`, `discount_type`, `campaign`, `category`, `start_date`, `expiration_date`, `gift_balance`, `redemption_quantity`, `active`, `qr_code`.
diff --git a/docs/guides/building_blocks/Webhooks.md b/docs/guides/building_blocks/Webhooks.md
@@ -1,10 +1,10 @@
 ---
 title: Webhooks
 excerpt: 
-category: 639ba16d677235008f800454
+categorySlug: building-blocks
 slug: webhooks
 type: link
 hidden: false
 order: 12
 link_url: https://support.voucherify.io/article/68-webhooks-notifications
----
+---
diff --git a/docs/guides/campaign_recipes/Locking-Validation-Session.md b/docs/guides/campaign_recipes/Locking-Validation-Session.md
@@ -1,7 +1,7 @@
 ---
 title: Locking Validation Session
 excerpt: Temporary lock the voucher's usage until redemption is successful.
-category: 639ba16d677235008f80045c
+categorySlug: campaigns-1
 slug: locking-validation-session
 type: basic
 hidden: false

diff --git a/docs/guides/campaign_recipes/Loyalty Program.md b/docs/guides/campaign_recipes/Loyalty Program.md
@@ -1,7 +1,7 @@
 ---
 title: Loyalty Program
 excerpt: null
-category: 639ba16d677235008f80045c
+categorySlug: campaigns-1
 slug: loyalty-program
 type: basic
 hidden: false

diff --git a/docs/guides/campaign_recipes/Prepaid-Gift-Cards.md b/docs/guides/campaign_recipes/Prepaid-Gift-Cards.md
@@ -1,7 +1,7 @@
 ---
 title: Prepaid Gift Cards
 excerpt: null
-category: 639ba16d677235008f80045c
+categorySlug: campaigns-1
 slug: prepaid-gift-cards
 type: basic
 hidden: false
@@ -153,4 +153,4 @@ The voucher can be redeemed using the Dashboard as well. Go to the voucher detai
 
 ## Recharge
 
-You can recharge the cards you've sent to customers. With our API, you can edit the balance value by calling [Add Balance](ref:add-gift-voucher-balance) endpoint.
+You can recharge the cards you've sent to customers. With our API, you can edit the balance value by calling [Add Balance](ref:add-gift-voucher-balance) endpoint.
diff --git a/docs/guides/campaign_recipes/Qualifications.md b/docs/guides/campaign_recipes/Qualifications.md
@@ -1,7 +1,7 @@
 ---
 title: Qualification - Checking eligibility
 excerpt: null
-category: 639ba16d677235008f80045c
+categorySlug: campaigns-1
 slug: checking-eligibility
 type: basic
 hidden: false
@@ -1202,4 +1202,4 @@ Only a promotion that is applicable to one of the items in the cart. `"scenario"
 
 > Case 3 Summary
 > 
-> Voucherify will return all the discounts that apply to the products you sent in the order. When a customer is browsing your products and is shown the product listing page, you can send, in the payload, the list of all the products the customer is presented and Voucherify will return all the discounts that apply to these products. The returned results can be visualized, for example, by a striked through price.
+> Voucherify will return all the discounts that apply to the products you sent in the order. When a customer is browsing your products and is shown the product listing page, you can send, in the payload, the list of all the products the customer is presented and Voucherify will return all the discounts that apply to these products. The returned results can be visualized, for example, by a striked through price.
diff --git a/docs/guides/campaign_recipes/Referral-Program.md b/docs/guides/campaign_recipes/Referral-Program.md
@@ -1,7 +1,7 @@
 ---
 title: Referral Program
 excerpt: null
-category: 639ba16d677235008f80045c
+categorySlug: campaigns-1
 slug: referral-program
 type: link
 hidden: false

diff --git a/docs/guides/campaign_recipes/Stacking-Promotion-Tiers.md b/docs/guides/campaign_recipes/Stacking-Promotion-Tiers.md
@@ -1,7 +1,7 @@
 ---
 title: Stacking Promotion Tiers
 excerpt: 'In this tutorial, you will learn how to validate, redeem, and manage promotion stacks using API.'
-category: 639ba16d677235008f80045c
+categorySlug: campaigns-1
 slug: stacking-promotion-tiers
 type: basic
 hidden: false
@@ -503,4 +503,4 @@ Here is an an example of a promotion stack redemption.
 }
 ```
 
-In the returned `redemptions` array, you can see child redemptions that show redemptions of particular tiers. Discounts from stack tiers are applied consecutively as defined by the stack hierarchy. The hierarchy defines the sequence in which each of the stacked discounts will be applied to the single transaction.
+In the returned `redemptions` array, you can see child redemptions that show redemptions of particular tiers. Discounts from stack tiers are applied consecutively as defined by the stack hierarchy. The hierarchy defines the sequence in which each of the stacked discounts will be applied to the single transaction.
diff --git a/docs/guides/campaign_recipes/Transfer-Loyalty-Points.md b/docs/guides/campaign_recipes/Transfer-Loyalty-Points.md
@@ -1,7 +1,7 @@
 ---
 title: Transfer Loyalty Points
 excerpt: See how to transfer points between loyalty cards.
-category: 639ba16d677235008f80045c
+categorySlug: campaigns-1
 slug: transfer-loyalty-points
 type: basic
 hidden: false

diff --git a/docs/guides/development/API-Reference.md b/docs/guides/development/API-Reference.md
@@ -1,7 +1,7 @@
 ---
 title: API Reference
 excerpt: 
-category: 639ba16d677235008f800447
+categorySlug: development
 slug: api-reference
 type: link
 hidden: false

diff --git a/docs/guides/development/API-Version-Upgrades.md b/docs/guides/development/API-Version-Upgrades.md
@@ -1,7 +1,7 @@
 ---
 title: API Version Upgrades
 excerpt: Keep track of changes and upgrades to the Voucherify API.
-category: 639ba16d677235008f800447
+categorySlug: development
 slug: api-version-upgrades
 type: basic
 hidden: false
@@ -42,4 +42,4 @@ If you’re running an older version, you’ll want to upgrade to take advantage
 
 > 📘 Release Notes
 >
-> [Visit our Help Center](https://support.voucherify.io/article/23-whats-new-in-voucherify) to learn more about the latest Release Notes and new features.
+> [Visit our Help Center](https://support.voucherify.io/article/23-whats-new-in-voucherify) to learn more about the latest Release Notes and new features.
diff --git a/docs/guides/development/Client-Side-API.md b/docs/guides/development/Client-Side-API.md
@@ -1,7 +1,7 @@
 ---
 title: Client-side API
 excerpt: 
-category: 639ba16d677235008f800447
+categorySlug: development
 slug: client-side-api
 type: basic
 hidden: false
@@ -38,4 +38,4 @@ Visit :fa-github-alt: [Github repository](https://github.com/voucherifyio/vouche
 > You have to activate particular client-side options in the [Project Settings](https://app.voucherify.io/#/app/configuration/proj_f1r5Tpr0J3Ct).
 
 <!-- ![Client-Side Settings](../../assets/img/guides_development_client_side_api_client_side_settings_3.png "Client-Side Settings") -->
-![Client-Side Settings](https://files.readme.io/038ab3b-cielnt-side-settings.png "Client-Side Settings")
+![Client-Side Settings](https://files.readme.io/038ab3b-cielnt-side-settings.png "Client-Side Settings")
diff --git a/docs/guides/development/Error-Codes.md b/docs/guides/development/Error-Codes.md
@@ -1,7 +1,7 @@
 ---
 title: Error Codes
 excerpt: 
-category: 639ba16d677235008f800447
+categorySlug: development
 slug: error-codes
 type: link
 hidden: false

diff --git a/docs/guides/development/Examples.md b/docs/guides/development/Examples.md
@@ -1,7 +1,7 @@
 ---
 title: Examples
 excerpt: Here are some exemplary integrations and third-party guides for you to learn more about Voucherify.
-category: 639ba16d677235008f800447
+categorySlug: development
 slug: examples
 type: basic
 hidden: false
@@ -121,4 +121,4 @@ Looking for ready designs for the best promotions experience in your ecommerce s
 * [Download Referral UI Kit on Figma](https://www.figma.com/community/file/1039555483777372722)
 
 <!-- ![Figma](../../assets/img/guides_development_examples_figma_5.png "Figma") -->
-![Figma](https://files.readme.io/6c4efe5-UI-kit.png "Figma")
+![Figma](https://files.readme.io/6c4efe5-UI-kit.png "Figma")