# set\_forge\_pull\_request\_approval

Approve a pull request as komrad's credential, or withdraw that approval.

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

On GitHub, withdrawing dismisses the credential's approving review.

## Calling it

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

```bash
komrad rpc set-forge-pull-request-approval \
  --url '<string>'
```

## Request

### SetForgePullRequestApprovalRequest

| Field | Type | Description |
| --- | --- | --- |
| [`url`](https://komrad.dev/latest/api/forge/set-forge-pull-request-approval.md#komrad-forge-v1-SetForgePullRequestApprovalRequest-url) | string\* at most 2048 characters | The pull request to approve, by web address. The address's host picks the forge connection. |
| [`head_sha`](https://komrad.dev/latest/api/forge/set-forge-pull-request-approval.md#komrad-forge-v1-SetForgePullRequestApprovalRequest-head_sha) | string at most 64 characters | The head commit the caller saw. The approval is for that commit. Empty approves whatever the head is. |
| [`approved`](https://komrad.dev/latest/api/forge/set-forge-pull-request-approval.md#komrad-forge-v1-SetForgePullRequestApprovalRequest-approved) | bool | Whether komrad's credential approves the pull request. False withdraws its approval. |

## Response

### Empty

No fields.
