{"id":19607119,"url":"https://github.com/robocorp/action-trigger-process","last_synced_at":"2025-04-27T19:33:09.901Z","repository":{"id":40707661,"uuid":"319270723","full_name":"robocorp/action-trigger-process","owner":"robocorp","description":"GitHub action to trigger a process run in Robocorp Cloud","archived":false,"fork":false,"pushed_at":"2023-07-19T03:59:27.000Z","size":389,"stargazers_count":25,"open_issues_count":1,"forks_count":2,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-25T10:54:40.515Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robocorp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-07T09:38:43.000Z","updated_at":"2023-12-30T05:51:58.000Z","dependencies_parsed_at":"2023-01-11T17:21:58.128Z","dependency_job_id":null,"html_url":"https://github.com/robocorp/action-trigger-process","commit_stats":{"total_commits":31,"total_committers":4,"mean_commits":7.75,"dds":0.09677419354838712,"last_synced_commit":"8dda575d5aa595f1c84139ee808496ffb538d7f7"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robocorp%2Faction-trigger-process","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robocorp%2Faction-trigger-process/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robocorp%2Faction-trigger-process/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robocorp%2Faction-trigger-process/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robocorp","download_url":"https://codeload.github.com/robocorp/action-trigger-process/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251196467,"owners_count":21550957,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-11T10:08:56.088Z","updated_at":"2025-04-27T19:33:09.517Z","avatar_url":"https://github.com/robocorp.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Action to trigger a Robocorp Control Room process\n\nThis GitHub Actions triggers a Robocorp Control Room process run and optionally waits for its execution to complete.\n\n## Usage\n\n### Example Workflow file\n\nAn example workflow to trigger and await a Control Room process run:\n\n```yaml\njobs:\n  run-process:\n    runs-on: ubuntu-latest\n    name: Trigger process\n    steps:\n      - name: Trigger Control Room process run\n        uses: robocorp/action-trigger-process@v1\n        with:\n          api-key: ${{ secrets.ROBOCORP_API_KEY }}\n          workspace-id: ${{ secrets.ROBOCORP_WORKSPACE_ID }}\n          process-id: ${{ secrets.ROBOCORP_PROCESS_ID }}\n          payload: '{\"foo\":\"bar\"}'\n          await-complete: true\n```\n\n##### Configuration\n\n| Option             | Value   | Required | Default                                 | Description                                                            |\n| ------------------ | ------- | -------- | --------------------------------------- | ---------------------------------------------------------------------- |\n| api-key            | string  | \\*       |                                         | Workspace API key with `read_runs` and `trigger_processes` permissions |\n| workspace-id       | string  | \\*       |                                         | The target Control Room workspace ID                                   |\n| process-id         | string  | \\*       |                                         | The target Control Room process ID                                     |\n| payload            | string  |          | \"{}\"                                    | Stringified JSON payload passed to process                             |\n| await-complete     | boolean |          | false                                   | Should the action await process run completion                         |\n| fail-on-robot-fail | boolean |          | true                                    | Fail the GitHub workflow run if Control Room process fails             |\n| timeout            | number  |          | 120                                     | Process run await timeout in seconds                                   |\n| api-endpoint       | string  |          | https://api.eu1.robocloud.eu/process-v1 | Robocorp workspace API endpoint                                        |\n\n#### Outputs\n\n| Name         | Value                                 | Description                                   |\n| ------------ | ------------------------------------- | --------------------------------------------- |\n| run-id       | string                                | Process run id                                |\n| duration     | number                                | Process run execution duration                |\n| robotrun-ids | string                                | Comma seperated list of process robot run IDs |\n| state        | \"COMPL\" \u0026#124; \"ERR\" \u0026#124; \"TIMEOUT\" | Process run state code                        |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobocorp%2Faction-trigger-process","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobocorp%2Faction-trigger-process","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobocorp%2Faction-trigger-process/lists"}