Skip to content

Portn 3708 add new GitHub ocean docs changes #2941

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Portn 3708 add new GitHub ocean docs changes #2941

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b799c07
added the github ocean table and tab
sivanel97 Oct 22, 2025
bd9c4f8
add org and other info about the invocation type
sivanel97 Oct 23, 2025
cda6f73
change qodo suggestion
sivanel97 Oct 23, 2025
8775417
added the github ocean type value
sivanel97 Oct 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 17 additions & 2 deletions docs/actions-and-automations/templates/_backend-types-json.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
import Tabs from "@theme/Tabs"
import TabItem from "@theme/TabItem"

The **`type`** field defines the action's backend type, and can have one of the following values: `WEBHOOK`, `GITHUB`, `GITLAB`, `KAFKA`, `UPSERT_ENTITY`.
The **`type`** field defines the action's backend type, and can have one of the following values: `WEBHOOK`, `GITHUB`, `INTEGRATION_ACTION`, `GITLAB`, `KAFKA`, `UPSERT_ENTITY`.

Depending on the backend type you choose, the available fields will be different:

Expand All @@ -22,7 +22,7 @@ Depending on the backend type you choose, the available fields will be different

</TabItem>

<TabItem value="github" label="Github">
<TabItem value="github-app" label="Github app">

`invocationMethod.type` should be set to `GITHUB`.

Expand All @@ -36,6 +36,21 @@ Depending on the backend type you choose, the available fields will be different

</TabItem>

<TabItem value="github-ocean" label="GitHub Ocean">

`invocationMethod.type` should be set to `INTEGRATION_ACTION`.
You can specify which integration to use using the `invocationMethod.installationId` field.

| Field | Type | Description | Example values |
| ------ | ---- | ------------ | --------------- |
| `org` | `string` | The GitHub *organization* name. |
| `repo` | `string` | The GitHub *repository* name. | `port-docs` |
| `workflow` | `string` | Defines the GitHub *workflow ID* to run (You can also pass the workflow file name as a string). | `workflow.yml` | |
| `reportWorkflowStatus` | `boolean` | A flag to control whether to automatically update the Port `run` object status (SUCCESS/FAILURE) at the end of the workflow (default: `true`). | `true` or `false` |
| `workflowInputs` | `object` | Defines the **payload** that will be sent to the backend upon execution of the action.<br/>An object containing `"key":"value"` pairs. | |

</TabItem>

<TabItem value="gitlab" label="Gitlab">

`invocationMethod.type` should be set to `GITLAB`.
Expand Down