# edit\_forge\_pull\_request

Change a pull request's title, description or both on its forge.

writes · idempotent · destructive · CLI only · [Forge](https://komrad.dev/latest/api/forge.md)

## Calling it

```bash
curl -X POST http://127.0.0.1:8787/komrad.forge.v1.ForgeService/EditForgePullRequest \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "<url>",
  "edited_from": "<edited_from>"
}'
```

```bash
komrad rpc edit-forge-pull-request \
  --url '<string>' \
  --edited-from '<PullRequestText>'
```

## Request

### EditForgePullRequestRequest

| Field | Type | Description |
| --- | --- | --- |
| [`url`](https://komrad.dev/latest/api/forge/edit-forge-pull-request.md#komrad-forge-v1-EditForgePullRequestRequest-url) | string\* at most 2048 characters | The pull request to change, by web address. The address's host picks the forge connection. |
| [`edited_from`](https://komrad.dev/latest/api/forge/edit-forge-pull-request.md#komrad-forge-v1-EditForgePullRequestRequest-edited_from) | [PullRequestText](https://komrad.dev/latest/api/forge/edit-forge-pull-request.md#komrad-forge-v1-PullRequestText)\* | The title and description the caller read. The call refuses to change a field that has moved since, unless the field already holds the new value. |
| [`title`](https://komrad.dev/latest/api/forge/edit-forge-pull-request.md#komrad-forge-v1-EditForgePullRequestRequest-title) | string not empty at most 1024 characters | The new title. Unset leaves the title as it is. |
| [`body`](https://komrad.dev/latest/api/forge/edit-forge-pull-request.md#komrad-forge-v1-EditForgePullRequestRequest-body) | string at most 1048576 characters | The new description. Unset leaves the description as it is, and empty clears it. |

## Response

### Empty

No fields.

## Types

### PullRequestText

PullRequestText is a pull request's title and description.

| Field | Type | Description |
| --- | --- | --- |
| [`title`](https://komrad.dev/latest/api/forge/edit-forge-pull-request.md#komrad-forge-v1-PullRequestText-title) | string at most 1024 characters | The pull request's title. |
| [`body`](https://komrad.dev/latest/api/forge/edit-forge-pull-request.md#komrad-forge-v1-PullRequestText-body) | string at most 1048576 characters | The pull request's description, empty when it has none. |
