Skip to content

The environments whose protection rules hold a run's jobs, this attempt: each with the environment's name, state (waiting, approved or rejected), wait_timer and wait_until (when its timer lets its jobs start), its reviewers, the jobs it holds, who reviewed it and their comment, and current_user_can_approve.

GET/repos/{owner}/{name}/actions/runs/{id}/pending_deployments

Needs the Read role.

  • Authentication: Optional. Public data can be read without a token; send one to see what is private.
  • MCP tool: workflow with action pending_deployments, and the same inputs
  • Scope: An access token needs workflows:read.
Name Type Required Description
owner string Yes The workspace that owns the repository.
name string Yes The repository’s name.
id string Yes The run’s id, run_….
curl https://api.g1t.sh/repos/flagon-io/g1t/actions/runs/run_01kq9b3d5f7h9k1n3q5s7u9w1y/pending_deployments \
-H "Authorization: Bearer $G1T_TOKEN"

A successful request answers 200 with:

[
{
"environment": {
"name": "production"
},
"state": "waiting",
"needs_review": true,
"wait_until": "2026-10-08T09:31:02.551Z",
"current_user_can_approve": true,
"reviewers": [
{
"type": "User",
"reviewer": {
"login": "syntaqx"
}
},
{
"type": "Team",
"reviewer": {
"slug": "deployers"
}
}
],
"jobs": [
"Deploy the core services"
],
"reviewed_by": null,
"comment": null,
"reviewed_at": null
}
]

A failed request answers with one of these statuses and a body like {"error": {"code": "not_found", "message": "Repository not found."}}. See errors.

Status Code When
401 unauthenticated A token is required, or the one sent is not valid.
403 forbidden The token is valid but not allowed to do this, such as a member-only change or an agent token outside its repository.
404 not_found It does not exist, or you cannot see it.
422 invalid The input is not valid. message says which field and why.