# Update a pull request

> Change an open pull request: base, the branch it merges into (an existing branch; needs the Write role or higher); its labels (replacing the set, as set_issue_labels does); its milestone (a number, or null or 0 for none; needs the Triage role); and assignees and reviewers (each replacing the set).

<div class="g1t-endpoint"><span class="g1t-method" data-method="patch">PATCH</span><code>/repos/{owner}/{name}/pulls/{number}</code></div>

Only the fields given change. Its author, or whoever asked g1t for it, may change it; anyone else needs the Triage role or higher. A new base is a pull.base_changed event: it leaves the merge queue, and whether it is behind, merges cleanly and has the checks it needs is worked out against the new base. state open reopens a closed pull request, as [`reopen_pull_request`](/reference/api/pull-requests/reopen-pull-request/) does, before anything else changes; state closed closes it, as [`close_pull_request`](/reference/api/pull-requests/close-pull-request/) does, after.

A new base takes it out of the merge queue, and whether it is behind, merges cleanly and has the checks it needs is worked out against the new base.

- **Authentication:** Required. Send an [access token](/reference/api/#authentication) as `Authorization: Bearer`.
- **MCP tool:** [`pull_request`](/reference/mcp/#pull_request) with `action` `update`, and the same inputs
- **Scope:** An access token needs [`pull_requests:write`](/guides/authentication/#scopes).

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `owner` | string | Yes | The workspace that owns the repository. |
| `name` | string | Yes | The repository's name. |
| `number` | integer | Yes | The number shown after the #. Issues and pull requests share one sequence. |

## Body parameters

Send a JSON object. Names are `snake_case`, as in responses; the `camelCase` spelling is accepted too.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `state` | string | No | open reopens it if it is closed (never once merged); closed closes it without merging. Either is left as it is when it already is. One of `open`, `closed`. |
| `base` | string | No | The branch it merges into: an existing branch other than its own. Needs the Write role. |
| `labels` | array of strings | No | Replaces the whole set. |
| `milestone` | integer or null | No | The number of the milestone to put it in; null or 0 takes it out. Needs the Triage role. |
| `assignees` | array of strings | No | Usernames; replaces the whole set. |
| `reviewers` | array of strings | No | Usernames whose review is asked for, and g1t for a g1t agent's; replaces the whole set. |

## Example request

```sh
curl -X PATCH https://api.g1t.sh/repos/flagon-io/hello/pulls/14 \
  -H "Authorization: Bearer $G1T_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "base": "release/1.x",
    "labels": [
      "bug"
    ]
  }'
```

## Example response

A successful request answers `200` with:

```json
{
  "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
  "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
  "number": 14,
  "issue": 12,
  "title": "Greeting should name the caller",
  "body": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\".",
  "agent": "claude-code",
  "runtime": "external",
  "status": "open",
  "fork": {
    "namespace": "pulls",
    "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
  },
  "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
  "branch": null,
  "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
  "merge_base": null,
  "merged_by": null,
  "merged_at": null,
  "superseded_by": null,
  "check_status": "passed",
  "files": [
    {
      "path": "src/main.rs",
      "additions": 6,
      "deletions": 2
    }
  ],
  "assignees": [],
  "reviewers": [
    "ana"
  ],
  "labels": [
    "bug"
  ],
  "milestone": null,
  "base": "release/1.x",
  "author": {
    "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
    "username": "syntaqx",
    "display_username": "syntaqx",
    "kind": "user",
    "verified": false,
    "workspaces": []
  },
  "requested_by": null,
  "created_at": "2026-10-01T18:20:02.117Z",
  "updated_at": "2026-10-01T18:35:44.902Z",
  "confidence": null
}
```

## Errors

A failed request answers with one of these statuses and a body like `{"error": {"code": "not_found", "message": "Repository not found."}}`. See [errors](/reference/api/#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. |
| 409 | `conflict` | The request conflicts with the current state. |
| 422 | `invalid` | The input is not valid. `message` says which field and why. |