# read\_forge\_pull\_request\_text

Read a pull request's title and description from its forge.

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

Refuses when the forge will not let the credential change them.

## Calling it

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

```bash
komrad rpc read-forge-pull-request-text \
  --url '<string>'
```

## Request

### ReadForgePullRequestTextRequest

| Field | Type | Description |
| --- | --- | --- |
| [`url`](https://komrad.dev/latest/api/forge/read-forge-pull-request-text.md#komrad-forge-v1-ReadForgePullRequestTextRequest-url) | string\* at most 2048 characters | The pull request to read, by web address. The address's host picks the forge connection. |

## Response

### PullRequestText

PullRequestText is a pull request's title and description.

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