repository

Approve a workflow run that requires approval

post/repos/{owner}/{repo}/actions/runs/{run}/approve

Path parameters

ownerstring required

owner of the repo

repostring required

name of the repository

runinteger required

run ID

Response

WorkflowRun

artifacts_urlstring

cancel_urlstring

completed_atstring date-time

conclusionstring

created_atstring date-time

display_titlestring

eventstring

head_branchstring

head_shastring

html_urlstring

idinteger

jobs_urlstring

logs_urlstring

pathstring

previous_attempt_urlstring

PreviousAttemptURL is the API URL of the previous attempt of this run, e.g. ".../actions/runs/{run_id}/attempts/{attempt-1}". It is set only when the current attempt is > 1 (i.e. a rerun). For the first attempt, or for legacy runs that pre-date ActionRunAttempt, it is null.

repository_idinteger

rerun_urlstring

run_attemptinteger

RunAttempt is 1-based for runs created after ActionRunAttempt was introduced. A value of 0 is a legacy-only sentinel for runs created before attempts existed and indicates no corresponding /attempts/{n} resource is available.

run_numberinteger

started_atstring date-time

statusstring

updated_atstring date-time

urlstring

Example response

{
  "head_repository": {
    "repo_transfer": {
      "teams": [
        {
          "units": [
            "repo.code",
            "repo.issues",
            "repo.ext_issues",
            "repo.wiki",
            "repo.pulls",
            "repo.releases",
            "repo.projects",
            "repo.ext_wiki"
          ],
          "units_map": {
            "repo.code": "read",
            "repo.ext_issues": "none",
            "repo.ext_wiki": "none",
            "repo.issues": "write",
            "repo.projects": "none",
            "repo.pulls": "owner",
            "repo.releases": "none",
            "repo.wiki": "admin"
          }
        }
      ]
    }
  },
  "repository": {
    "repo_transfer": {
      "teams": [
        {
          "units": [
            "repo.code",
            "repo.issues",
            "repo.ext_issues",
            "repo.wiki",
            "repo.pulls",
            "repo.releases",
            "repo.projects",
            "repo.ext_wiki"
          ],
          "units_map": {
            "repo.code": "read",
            "repo.ext_issues": "none",
            "repo.ext_wiki": "none",
            "repo.issues": "write",
            "repo.projects": "none",
            "repo.pulls": "owner",
            "repo.releases": "none",
            "repo.wiki": "admin"
          }
        }
      ]
    }
  }
}