> For the complete CircleCI developer hub index, see [llms.txt](https://circleci.com/developer/llms.txt)

# mergifyio/ci-issues

CircleCI integration with Mergify CI Issues. This orbs is shipped with a command to add to your pipeline that uploads your JUnit xml reports to Mergify CI Issues.


## Commands

### upload

Upload the XML report

| Parameter | Type | Default | Description |
|---|---|---|---|
| `mergify_api_server` | string | https://api.mergify.com/v1 | URL of the Mergify API |
| `report_paths` | string |  | Paths of the XML files to upload |
| `repository_url` | string |  | URL of the repository (should provide pipeline.trigger_parameters.github_app.repo_url)
 |
| `token` | env_var_name | MERGIFY_CI_ISSUES_TOKEN | CI Issues Application Key |

## Examples

### example

Uploading pytest JUnit reports to CI Issues.


```yaml
version: '2.1'
orbs:
  mergifyio: mergifyio/ci-issues@1.2.3
  python: circleci/python@2.1.1
jobs:
  run_tests:
    executor:
      name: python/default
      tag: 3.12.5
    steps:
      - checkout
      - python/install-packages:
          pkg-manager: poetry
      - run:
          command: |
            mkdir test_results
            poetry run pytest -vv --junitxml=test_results/report.xml
          name: Run tests
      - mergifyio/upload:
          report_paths: test_results/report.xml
          repository_url: <<pipeline.trigger_parameters.github_app.repo_url>>
          token: MERGIFY_CI_ISSUES_TOKEN
      - store_test_results:
          path: test_results
workflows:
  continuous_integration:
    jobs:
      - run_tests:
          context:
            - ci_secrets
```