Merge branch 'update-apiSpec-20-10' of https://github.com/port-labs/port-docs into update-apiSpec-20-10

Author: sivanel97

.github/workflows/verify-docs-build.yml

@@ -22,7 +22,7 @@ jobs:
         with:
           persist-credentials: true
       - name: Install dependencies
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version: lts/*
           cache: npm

docs/actions-and-automations/actions-and-automations.md

@@ -5,13 +5,12 @@ import PortTooltip from "/src/components/tooltip/tooltip.jsx"
 One of Port's core offerings is the ability to automate and simplify the processes and routines of your developers.  
 This is done using two powerful tools:
 
-## 1. Self-service actions
+## 1. Actions
 
-Create a wide range of personalized, controlled actions that developers can use to scaffold a service, provision a cloud resource, or any other logic that serves your organization.  
-Self-service actions drive developer productivity by providing a consistent and repeatable way to perform common tasks, all with guardrails like manual approvals or consumption policies to comply with organizational standards.
+Actions are executable pieces of logic that developers or AI agents can run. You can create a wide range of personalized, controlled actions to scaffold a service, provision a cloud resource, or any other logic that serves your organization. Actions drive developer productivity by providing a consistent and repeatable way to perform common tasks, all with guardrails like manual approvals or consumption policies to comply with organizational standards.
 
 :::tip Live demo
-For real-world examples of self-service actions, check out our [live demo](https://demo.getport.io/self-serve).
+For real-world examples of self-service actions, check out our [live demo](https://showcase.port.io/self-serve).
 :::
 
 For more information and instructions for creating self-service actions, click [here](/actions-and-automations/create-self-service-experiences).

docs/actions-and-automations/create-self-service-experiences/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "Create self-service actions",
+  "label": "Create actions",
   "position": 1
 }

docs/actions-and-automations/create-self-service-experiences/create-self-service-experiences.md

@@ -14,7 +14,9 @@ import ExecuteActionLocations from '/docs/actions-and-automations/create-self-se
 </center>
 <br/>
 
-Drive developer productivity by allowing developers to use self-service actions like scaffolding a service or provisioning a cloud resource. Developer self-service drives consistency and repeatability and ensures that their routines are intuitive and clear, all with guardrails like manual approvals or consumption policies to comply with organizational standards.
+Actions are executable pieces of logic that either developers or AI agents can run. They drive developer productivity by enabling them to use actions like scaffolding a service or provisioning a cloud resource.  
+
+Actions drive consistency and repeatability and ensure that routines are intuitive and clear, all with guardrails like manual approvals or consumption policies to comply with organizational standards.
 
 Port's action model is designed to be flexible and can be used to cover a wide range of use-cases:
 
@@ -24,7 +26,7 @@ Port's action model is designed to be flexible and can be used to cover a wide r
 4. **Stateful** - every invoked action affects the software catalog by adding/modifying/deleting one or more entities.
 5. **Secure by design** - does not require keys to sensitive infrastructure by using an event-based model. All actions are audited and can include guardrails like manual approval and TTL.
 
-## 💡 Common self-service actions
+## Common self-service actions
 
 - [**Scaffold** a new service](https://docs.port.io/guides/all/scaffold-a-new-service/).
 - [**Create** a cloud resource](https://docs.port.io/guides/all/create-cloud-resource-using-iac).
@@ -33,11 +35,11 @@ Port's action model is designed to be flexible and can be used to cover a wide r
 - **Rollback** a running service.
 - **Change** a deployment's replica count.
 
-In our [live demo](https://demo.getport.io/self-serve), you can see examples for self-service experiences. 🎬
+In our [live demo](https://showcase.port.io/self-serve), you can see examples for self-service experiences. 🎬
 
 ## How does it work?
 
-1. A user **executes an action** from Port's UI interface.
+1. A user or AI agent **executes an action** from Port's UI interface or through API calls.
 2. A pre-defined **payload** containing any desired metadata about the action and its inputs is **sent** to your infrastructure.
 3. A **job is triggered** and the user gets a **continuous indication** about its progress.
 4. Once the action is running, you can use Port's API to **update Port on its status** and provide information such as **logs and links to the resulting handlers**.

docs/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/entity.md

@@ -21,7 +21,7 @@ The entity input type can be used to reference any existing entity from the soft
 - Clusters
 - Configurations
 
-In the [live demo](https://demo.getport.io/self-serve) self-service hub page, we can see the **scaffold new service** action whose `Domain` input is an entity input. 🎬
+In the [live demo](https://showcase.port.io/self-serve) self-service hub page, we can see the **scaffold new service** action whose `Domain` input is an entity input. 🎬
 
 ## Sorting entities
 

docs/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/number.md

@@ -21,7 +21,7 @@ The number input type can be used to store any numeric data, for example:
 - Replica counts
 - Number of days to retain data
 
-In the [live demo](https://demo.getport.io/self-serve) self-service hub page, we can see the **scaffold new service** action whose `K8s Replica Count` input is a number input. 🎬
+In the [live demo](https://showcase.port.io/self-serve) self-service hub page, we can see the **scaffold new service** action whose `K8s Replica Count` input is a number input. 🎬
 
 ## API definition
 

docs/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/object.md

@@ -22,7 +22,7 @@ The object input type can be used to store any key/value based data, for example
 - HTTP responses
 - Dictionaries/Hash maps
 
-In the [live demo](https://demo.getport.io/self-serve) self-service hub page, we can see the **Open terraform PR to add S3 bucket** action whose `policy` input is an object input. 🎬
+In the [live demo](https://showcase.port.io/self-serve) self-service hub page, we can see the **Open terraform PR to add S3 bucket** action whose `policy` input is an object input. 🎬
 
 ## API definition
 

docs/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/team.md

@@ -21,7 +21,7 @@ The team input type can be used to reference any team that exists in Port, for e
 - The current on-call
 - The lead maintainers
 
-In the [live demo](https://demo.getport.io/self-serve) self-service hub page, we can see the **scaffold new service** action whose `Owning Team` input is a user input. 🎬
+In the [live demo](https://showcase.port.io/self-serve) self-service hub page, we can see the **scaffold new service** action whose `Owning Team` input is a user input. 🎬
 
 ## API definition
 

docs/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/text.md

@@ -22,7 +22,7 @@ The text input type can be used to store any text based data, for example:
 - Commit SHA
 - File names
 
-In the [live demo](https://demo.getport.io/self-serve) self-service hub page, we can see the **scaffold new service** action whose `Service Name` input is a text input. 🎬
+In the [live demo](https://showcase.port.io/self-serve) self-service hub page, we can see the **scaffold new service** action whose `Service Name` input is a text input. 🎬
 
 ## API definition
 

docs/actions-and-automations/create-self-service-experiences/setup-ui-for-action/user-inputs/toggle.md

@@ -23,7 +23,7 @@ This input type can be used to store any true/false gate, for example:
 - Does service handle PII
 - Is environment public
 
-In the [live demo](https://demo.getport.io/self-serve) self-service hub page, we can see the **Delete Repo** action whose `Confirm` input is a toggle input. 🎬
+In the [live demo](https://showcase.port.io/self-serve) self-service hub page, we can see the **Delete Repo** action whose `Confirm` input is a toggle input. 🎬
 
 ## API definition