# Create Gitea Pull Request

Opens a pull request on Gitea. The source branch must already exist on the remote. This action does not commit or push; it only asks Gitea to open a PR from `head` into `base`.

**Before this step:** commit your changes and push the source branch.

## Minimal example

Same repository, target branch `main` (the default):

```yaml
- uses: actions/pullrequest@v1
  with:
    title: Fix markdown typos
    head: typos
```

## Full example

```yaml
- uses: actions/pullrequest@v1
  id: pr
  with:
    token: ${{ secrets.GITHUB_TOKEN }}
    gitea_url: https://gitea.psi.ch
    repository: linux/WebHosting_DMZ
    title: Fix markdown typos
    body: Automated typo fixes.
    head: typos
    base: master
```

Print the created PR:

```yaml
- run: echo "${{ steps.pr.outputs.html_url }}"
```

`head` is the branch with the changes. `base` is the branch you merge into. For a fork, set `head` to `owner:branch`.

If `gitea_url` is omitted, the action uses `${{ github.server_url }}` (the instance running the workflow). If `repository` is omitted, it uses `${{ github.repository }}`.

## Token (`secrets.GITHUB_TOKEN`)

Pass a token with permission to create pull requests.

In Gitea Actions, `${{ secrets.GITHUB_TOKEN }}` is the default token for the workflow. It is enough when:

- the job runs in the **same repository** as the PR, and
- the token is allowed to write (create pull requests / push related refs).

Use a **personal access token** (or another repo secret) instead when you open a PR in a **different** repository, or when the default token cannot create pull requests.

Do not print the token in logs.

## Inputs

| Input | Required | Default | Description |
| --- | --- | --- | --- |
| `token` | yes | - | Token with pull-request write access |
| `title` | yes | - | Pull request title |
| `head` | yes | - | Source branch (`owner:branch` for forks) |
| `body` | no | empty | Pull request description |
| `base` | no | `main` | Target branch |
| `repository` | no | current repo | Target as `owner/repo` |
| `gitea_url` | no | current instance | Gitea base URL |

## Outputs

| Output | Description |
| --- | --- |
| `number` | Pull request number |
| `url` | API URL |
| `html_url` | Browser URL |