{"repo":"Codex-/return-dispatch","free":true,"listed":false,"github":"https://github.com/Codex-/return-dispatch","clone":"git clone https://github.com/Codex-/return-dispatch.git","description":"⚙️ Dispatch an action to a foreign repository and output the newly created run ID.","language":"TypeScript","stars":69,"topics":["actions","dispatch","github-actions","workflow"],"license":"MIT","category":"workflow-automation","readme_excerpt":"GitHub Action: return-dispatch Dispatch an action to a foreign repository and output the newly created run ID. The returned run ID can be used to await the completion of the remote run using await-remote-run . Usage The dispatched workflow needs no special setup. It only has to accept the workflow dispatch event and declare any inputs you pass via workflow inputs . Token GITHUB TOKEN can only access the repository containing the workflow, so dispatching to another repository requires a Personal Access Token (PAT). Dispatching within the same repository works with GITHUB TOKEN , provided it is granted actions: write . Permissions Required One of the following, depending on the token type: - Fine-grained PAT, GitHub App, or GITHUB TOKEN : Actions repository permission, write - Classic PAT or OAuth token: repo scope APIs Used - Create a workflow dispatch event - POST /repos/{owner}/{repo}/actions/workflows/{workflow id}/dispatches - Sent with X-GitHub-Api-Version: 2026-03-10 , so the response carries the new run's ID and URL - Requires github.com or GitHub Enterprise Server 3.21+, older servers cannot return the run details For more information please see api.ts. Where does this help? If you have an action in a repository that dispatches an action on a foreign repository, you need to know which foreign run you've just dispatched before you can wait for it or poll it for a completion status (success, failure, etc). This Action gets you that run ID and URL as step outputs, so you ","default_branch":null,"files":null,"tree":[],"storefront":"/r/Codex-","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/Codex-/return-dispatch/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}